mirror of
https://github.com/nextcloud/server.git
synced 2026-02-03 20:41:22 -05:00
caff1023ea
To continue this formatting madness, here's a tiny patch that adds unified formatting for control structures like if and loops as well as classes, their methods and anonymous functions. This basically forces the constructs to start on the same line. This is not exactly what PSR2 wants, but I think we can have a few exceptions with "our" style. The starting of braces on the same line is pracrically standard for our code. This also removes and empty lines from method/function bodies at the beginning and end. Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
468 lines
11 KiB
PHP
468 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
|
*
|
|
* @author Arthur Schiwon <blizzz@arthur-schiwon.de>
|
|
* @author Bernhard Posselt <dev@bernhard-posselt.com>
|
|
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
|
|
* @author Joas Schilling <coding@schilljs.com>
|
|
* @author Julius Härtl <jus@bitgrid.net>
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
* @author Robin Appelman <robin@icewind.nl>
|
|
* @author Roeland Jago Douma <roeland@famdouma.nl>
|
|
* @author Vincent Petry <pvince81@owncloud.com>
|
|
*
|
|
* @license AGPL-3.0
|
|
*
|
|
* This code is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
* as published by the Free Software Foundation.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License, version 3,
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
|
*
|
|
*/
|
|
|
|
namespace OC\Files\Node;
|
|
|
|
use OC\Files\Filesystem;
|
|
use OC\Files\Mount\MoveableMount;
|
|
use OCP\Files\FileInfo;
|
|
use OCP\Files\InvalidPathException;
|
|
use OCP\Files\NotFoundException;
|
|
use OCP\Files\NotPermittedException;
|
|
use OCP\Lock\LockedException;
|
|
use Symfony\Component\EventDispatcher\GenericEvent;
|
|
|
|
// FIXME: this class really should be abstract
|
|
class Node implements \OCP\Files\Node {
|
|
/**
|
|
* @var \OC\Files\View $view
|
|
*/
|
|
protected $view;
|
|
|
|
/**
|
|
* @var \OC\Files\Node\Root $root
|
|
*/
|
|
protected $root;
|
|
|
|
/**
|
|
* @var string $path
|
|
*/
|
|
protected $path;
|
|
|
|
/**
|
|
* @var \OCP\Files\FileInfo
|
|
*/
|
|
protected $fileInfo;
|
|
|
|
/**
|
|
* @param \OC\Files\View $view
|
|
* @param \OCP\Files\IRootFolder $root
|
|
* @param string $path
|
|
* @param FileInfo $fileInfo
|
|
*/
|
|
public function __construct($root, $view, $path, $fileInfo = null) {
|
|
$this->view = $view;
|
|
$this->root = $root;
|
|
$this->path = $path;
|
|
$this->fileInfo = $fileInfo;
|
|
}
|
|
|
|
/**
|
|
* Creates a Node of the same type that represents a non-existing path
|
|
*
|
|
* @param string $path path
|
|
* @return string non-existing node class
|
|
* @throws \Exception
|
|
*/
|
|
protected function createNonExistingNode($path) {
|
|
throw new \Exception('Must be implemented by subclasses');
|
|
}
|
|
|
|
/**
|
|
* Returns the matching file info
|
|
*
|
|
* @return FileInfo
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getFileInfo() {
|
|
if (!Filesystem::isValidPath($this->path)) {
|
|
throw new InvalidPathException();
|
|
}
|
|
if (!$this->fileInfo) {
|
|
$fileInfo = $this->view->getFileInfo($this->path);
|
|
if ($fileInfo instanceof FileInfo) {
|
|
$this->fileInfo = $fileInfo;
|
|
} else {
|
|
throw new NotFoundException();
|
|
}
|
|
}
|
|
return $this->fileInfo;
|
|
}
|
|
|
|
/**
|
|
* @param string[] $hooks
|
|
*/
|
|
protected function sendHooks($hooks, array $args = null) {
|
|
$args = !empty($args) ? $args : [$this];
|
|
$dispatcher = \OC::$server->getEventDispatcher();
|
|
foreach ($hooks as $hook) {
|
|
$this->root->emit('\OC\Files', $hook, $args);
|
|
$dispatcher->dispatch('\OCP\Files::' . $hook, new GenericEvent($args));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param int $permissions
|
|
* @return bool
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
protected function checkPermissions($permissions) {
|
|
return ($this->getPermissions() & $permissions) === $permissions;
|
|
}
|
|
|
|
public function delete() {
|
|
}
|
|
|
|
/**
|
|
* @param int $mtime
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
* @throws NotPermittedException
|
|
*/
|
|
public function touch($mtime = null) {
|
|
if ($this->checkPermissions(\OCP\Constants::PERMISSION_UPDATE)) {
|
|
$this->sendHooks(['preTouch']);
|
|
$this->view->touch($this->path, $mtime);
|
|
$this->sendHooks(['postTouch']);
|
|
if ($this->fileInfo) {
|
|
if (is_null($mtime)) {
|
|
$mtime = time();
|
|
}
|
|
$this->fileInfo['mtime'] = $mtime;
|
|
}
|
|
} else {
|
|
throw new NotPermittedException();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return \OC\Files\Storage\Storage
|
|
* @throws \OCP\Files\NotFoundException
|
|
*/
|
|
public function getStorage() {
|
|
list($storage,) = $this->view->resolvePath($this->path);
|
|
return $storage;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getPath() {
|
|
return $this->path;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getInternalPath() {
|
|
list(, $internalPath) = $this->view->resolvePath($this->path);
|
|
return $internalPath;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getId() {
|
|
return $this->getFileInfo()->getId();
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
public function stat() {
|
|
return $this->view->stat($this->path);
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getMTime() {
|
|
return $this->getFileInfo()->getMTime();
|
|
}
|
|
|
|
/**
|
|
* @param bool $includeMounts
|
|
* @return int
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getSize($includeMounts = true) {
|
|
return $this->getFileInfo()->getSize($includeMounts);
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getEtag() {
|
|
return $this->getFileInfo()->getEtag();
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getPermissions() {
|
|
return $this->getFileInfo()->getPermissions();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function isReadable() {
|
|
return $this->getFileInfo()->isReadable();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function isUpdateable() {
|
|
return $this->getFileInfo()->isUpdateable();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function isDeletable() {
|
|
return $this->getFileInfo()->isDeletable();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function isShareable() {
|
|
return $this->getFileInfo()->isShareable();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function isCreatable() {
|
|
return $this->getFileInfo()->isCreatable();
|
|
}
|
|
|
|
/**
|
|
* @return Node
|
|
*/
|
|
public function getParent() {
|
|
$newPath = dirname($this->path);
|
|
if ($newPath === '' || $newPath === '.' || $newPath === '/') {
|
|
return $this->root;
|
|
}
|
|
return $this->root->get($newPath);
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getName() {
|
|
return basename($this->path);
|
|
}
|
|
|
|
/**
|
|
* @param string $path
|
|
* @return string
|
|
*/
|
|
protected function normalizePath($path) {
|
|
if ($path === '' or $path === '/') {
|
|
return '/';
|
|
}
|
|
//no windows style slashes
|
|
$path = str_replace('\\', '/', $path);
|
|
//add leading slash
|
|
if ($path[0] !== '/') {
|
|
$path = '/' . $path;
|
|
}
|
|
//remove duplicate slashes
|
|
while (strpos($path, '//') !== false) {
|
|
$path = str_replace('//', '/', $path);
|
|
}
|
|
//remove trailing slash
|
|
$path = rtrim($path, '/');
|
|
|
|
return $path;
|
|
}
|
|
|
|
/**
|
|
* check if the requested path is valid
|
|
*
|
|
* @param string $path
|
|
* @return bool
|
|
*/
|
|
public function isValidPath($path) {
|
|
if (!$path || $path[0] !== '/') {
|
|
$path = '/' . $path;
|
|
}
|
|
if (strstr($path, '/../') || strrchr($path, '/') === '/..') {
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
public function isMounted() {
|
|
return $this->getFileInfo()->isMounted();
|
|
}
|
|
|
|
public function isShared() {
|
|
return $this->getFileInfo()->isShared();
|
|
}
|
|
|
|
public function getMimeType() {
|
|
return $this->getFileInfo()->getMimetype();
|
|
}
|
|
|
|
public function getMimePart() {
|
|
return $this->getFileInfo()->getMimePart();
|
|
}
|
|
|
|
public function getType() {
|
|
return $this->getFileInfo()->getType();
|
|
}
|
|
|
|
public function isEncrypted() {
|
|
return $this->getFileInfo()->isEncrypted();
|
|
}
|
|
|
|
public function getMountPoint() {
|
|
return $this->getFileInfo()->getMountPoint();
|
|
}
|
|
|
|
public function getOwner() {
|
|
return $this->getFileInfo()->getOwner();
|
|
}
|
|
|
|
public function getChecksum() {
|
|
}
|
|
|
|
public function getExtension(): string {
|
|
return $this->getFileInfo()->getExtension();
|
|
}
|
|
|
|
/**
|
|
* @param int $type \OCP\Lock\ILockingProvider::LOCK_SHARED or \OCP\Lock\ILockingProvider::LOCK_EXCLUSIVE
|
|
* @throws LockedException
|
|
*/
|
|
public function lock($type) {
|
|
$this->view->lockFile($this->path, $type);
|
|
}
|
|
|
|
/**
|
|
* @param int $type \OCP\Lock\ILockingProvider::LOCK_SHARED or \OCP\Lock\ILockingProvider::LOCK_EXCLUSIVE
|
|
* @throws LockedException
|
|
*/
|
|
public function changeLock($type) {
|
|
$this->view->changeLock($this->path, $type);
|
|
}
|
|
|
|
/**
|
|
* @param int $type \OCP\Lock\ILockingProvider::LOCK_SHARED or \OCP\Lock\ILockingProvider::LOCK_EXCLUSIVE
|
|
* @throws LockedException
|
|
*/
|
|
public function unlock($type) {
|
|
$this->view->unlockFile($this->path, $type);
|
|
}
|
|
|
|
/**
|
|
* @param string $targetPath
|
|
* @return \OC\Files\Node\Node
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
* @throws NotPermittedException if copy not allowed or failed
|
|
*/
|
|
public function copy($targetPath) {
|
|
$targetPath = $this->normalizePath($targetPath);
|
|
$parent = $this->root->get(dirname($targetPath));
|
|
if ($parent instanceof Folder and $this->isValidPath($targetPath) and $parent->isCreatable()) {
|
|
$nonExisting = $this->createNonExistingNode($targetPath);
|
|
$this->sendHooks(['preCopy'], [$this, $nonExisting]);
|
|
$this->sendHooks(['preWrite'], [$nonExisting]);
|
|
if (!$this->view->copy($this->path, $targetPath)) {
|
|
throw new NotPermittedException('Could not copy ' . $this->path . ' to ' . $targetPath);
|
|
}
|
|
$targetNode = $this->root->get($targetPath);
|
|
$this->sendHooks(['postCopy'], [$this, $targetNode]);
|
|
$this->sendHooks(['postWrite'], [$targetNode]);
|
|
return $targetNode;
|
|
} else {
|
|
throw new NotPermittedException('No permission to copy to path ' . $targetPath);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param string $targetPath
|
|
* @return \OC\Files\Node\Node
|
|
* @throws InvalidPathException
|
|
* @throws NotFoundException
|
|
* @throws NotPermittedException if move not allowed or failed
|
|
* @throws LockedException
|
|
*/
|
|
public function move($targetPath) {
|
|
$targetPath = $this->normalizePath($targetPath);
|
|
$parent = $this->root->get(dirname($targetPath));
|
|
if (
|
|
$parent instanceof Folder and
|
|
$this->isValidPath($targetPath) and
|
|
(
|
|
$parent->isCreatable() ||
|
|
($parent->getInternalPath() === '' && $parent->getMountPoint() instanceof MoveableMount)
|
|
)
|
|
) {
|
|
$nonExisting = $this->createNonExistingNode($targetPath);
|
|
$this->sendHooks(['preRename'], [$this, $nonExisting]);
|
|
$this->sendHooks(['preWrite'], [$nonExisting]);
|
|
if (!$this->view->rename($this->path, $targetPath)) {
|
|
throw new NotPermittedException('Could not move ' . $this->path . ' to ' . $targetPath);
|
|
}
|
|
$targetNode = $this->root->get($targetPath);
|
|
$this->sendHooks(['postRename'], [$this, $targetNode]);
|
|
$this->sendHooks(['postWrite'], [$targetNode]);
|
|
$this->path = $targetPath;
|
|
return $targetNode;
|
|
} else {
|
|
throw new NotPermittedException('No permission to move to path ' . $targetPath);
|
|
}
|
|
}
|
|
|
|
public function getCreationTime(): int {
|
|
return $this->getFileInfo()->getCreationTime();
|
|
}
|
|
|
|
public function getUploadTime(): int {
|
|
return $this->getFileInfo()->getUploadTime();
|
|
}
|
|
}
|