2013-09-01 17:47:48 +00:00
|
|
|
<?php
|
|
|
|
/**
|
2015-03-26 10:44:34 +00:00
|
|
|
* @author Bernhard Posselt <dev@bernhard-posselt.com>
|
|
|
|
* @author Joas Schilling <nickvergessen@owncloud.com>
|
|
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
|
|
* @author Robin Appelman <icewind@owncloud.com>
|
2016-03-01 16:25:15 +00:00
|
|
|
* @author Roeland Jago Douma <rullzer@owncloud.com>
|
2015-03-26 10:44:34 +00:00
|
|
|
* @author Vincent Petry <pvince81@owncloud.com>
|
|
|
|
*
|
2016-01-12 14:02:16 +00:00
|
|
|
* @copyright Copyright (c) 2016, ownCloud, Inc.
|
2015-03-26 10:44:34 +00:00
|
|
|
* @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/>
|
|
|
|
*
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
2015-02-26 10:37:37 +00:00
|
|
|
|
2013-09-01 17:47:48 +00:00
|
|
|
namespace OC\Files\Node;
|
|
|
|
|
2015-02-23 13:36:51 +00:00
|
|
|
use OC\Files\Filesystem;
|
|
|
|
use OCP\Files\FileInfo;
|
|
|
|
use OCP\Files\InvalidPathException;
|
|
|
|
use OCP\Files\NotFoundException;
|
2013-09-10 17:44:23 +00:00
|
|
|
use OCP\Files\NotPermittedException;
|
2013-09-01 17:47:48 +00:00
|
|
|
|
2015-01-26 14:58:41 +00:00
|
|
|
class Node implements \OCP\Files\Node {
|
2013-09-01 17:47:48 +00:00
|
|
|
/**
|
|
|
|
* @var \OC\Files\View $view
|
|
|
|
*/
|
|
|
|
protected $view;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var \OC\Files\Node\Root $root
|
|
|
|
*/
|
|
|
|
protected $root;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @var string $path
|
|
|
|
*/
|
|
|
|
protected $path;
|
|
|
|
|
2014-12-04 12:27:08 +00:00
|
|
|
/**
|
|
|
|
* @var \OCP\Files\FileInfo
|
|
|
|
*/
|
|
|
|
protected $fileInfo;
|
|
|
|
|
2013-09-01 17:47:48 +00:00
|
|
|
/**
|
|
|
|
* @param \OC\Files\View $view
|
2014-02-08 10:47:55 +00:00
|
|
|
* @param \OC\Files\Node\Root $root
|
2013-09-01 17:47:48 +00:00
|
|
|
* @param string $path
|
2015-09-08 20:38:50 +00:00
|
|
|
* @param FileInfo $fileInfo
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
2015-09-08 20:38:50 +00:00
|
|
|
public function __construct($root, $view, $path, $fileInfo = null) {
|
2013-09-01 17:47:48 +00:00
|
|
|
$this->view = $view;
|
|
|
|
$this->root = $root;
|
|
|
|
$this->path = $path;
|
2015-09-08 20:38:50 +00:00
|
|
|
$this->fileInfo = $fileInfo;
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
2014-12-12 14:19:36 +00:00
|
|
|
/**
|
|
|
|
* Returns the matching file info
|
|
|
|
*
|
2015-02-23 13:36:51 +00:00
|
|
|
* @return FileInfo
|
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2014-12-12 14:19:36 +00:00
|
|
|
*/
|
|
|
|
public function getFileInfo() {
|
2015-02-23 13:36:51 +00:00
|
|
|
if (!Filesystem::isValidPath($this->path)) {
|
|
|
|
throw new InvalidPathException();
|
|
|
|
}
|
2014-12-04 12:27:08 +00:00
|
|
|
if (!$this->fileInfo) {
|
2015-02-23 13:36:51 +00:00
|
|
|
$fileInfo = $this->view->getFileInfo($this->path);
|
|
|
|
if ($fileInfo instanceof FileInfo) {
|
|
|
|
$this->fileInfo = $fileInfo;
|
|
|
|
} else {
|
|
|
|
throw new NotFoundException();
|
|
|
|
}
|
2014-12-04 12:27:08 +00:00
|
|
|
}
|
|
|
|
return $this->fileInfo;
|
|
|
|
}
|
|
|
|
|
2013-09-01 17:47:48 +00:00
|
|
|
/**
|
|
|
|
* @param string[] $hooks
|
|
|
|
*/
|
|
|
|
protected function sendHooks($hooks) {
|
|
|
|
foreach ($hooks as $hook) {
|
|
|
|
$this->root->emit('\OC\Files', $hook, array($this));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param int $permissions
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
protected function checkPermissions($permissions) {
|
2013-09-06 18:20:17 +00:00
|
|
|
return ($this->getPermissions() & $permissions) === $permissions;
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $targetPath
|
2013-09-10 17:44:23 +00:00
|
|
|
* @throws \OCP\Files\NotPermittedException
|
2013-09-01 17:47:48 +00:00
|
|
|
* @return \OC\Files\Node\Node
|
|
|
|
*/
|
|
|
|
public function move($targetPath) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
public function delete() {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param string $targetPath
|
|
|
|
* @return \OC\Files\Node\Node
|
|
|
|
*/
|
|
|
|
public function copy($targetPath) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param int $mtime
|
2013-09-10 17:44:23 +00:00
|
|
|
* @throws \OCP\Files\NotPermittedException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function touch($mtime = null) {
|
2014-11-25 15:28:41 +00:00
|
|
|
if ($this->checkPermissions(\OCP\Constants::PERMISSION_UPDATE)) {
|
2013-09-01 17:47:48 +00:00
|
|
|
$this->sendHooks(array('preTouch'));
|
|
|
|
$this->view->touch($this->path, $mtime);
|
|
|
|
$this->sendHooks(array('postTouch'));
|
2014-12-04 12:27:08 +00:00
|
|
|
if ($this->fileInfo) {
|
|
|
|
if (is_null($mtime)) {
|
|
|
|
$mtime = time();
|
|
|
|
}
|
|
|
|
$this->fileInfo['mtime'] = $mtime;
|
|
|
|
}
|
2013-09-01 17:47:48 +00:00
|
|
|
} else {
|
|
|
|
throw new NotPermittedException();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return \OC\Files\Storage\Storage
|
2013-09-10 17:44:23 +00:00
|
|
|
* @throws \OCP\Files\NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
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
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function getId() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->getId();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
public function stat() {
|
|
|
|
return $this->view->stat($this->path);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return int
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function getMTime() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->getMTime();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return int
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function getSize() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->getSize();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return string
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function getEtag() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->getEtag();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return int
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function getPermissions() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->getPermissions();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return bool
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function isReadable() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->isReadable();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return bool
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function isUpdateable() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->isUpdateable();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return bool
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function isDeletable() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->isDeletable();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return bool
|
2015-02-27 11:16:53 +00:00
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
2013-09-01 17:47:48 +00:00
|
|
|
*/
|
|
|
|
public function isShareable() {
|
2014-12-04 12:27:08 +00:00
|
|
|
return $this->getFileInfo()->isShareable();
|
|
|
|
}
|
|
|
|
|
2015-02-27 11:16:53 +00:00
|
|
|
/**
|
|
|
|
* @return bool
|
|
|
|
* @throws InvalidPathException
|
|
|
|
* @throws NotFoundException
|
|
|
|
*/
|
2014-12-04 12:27:08 +00:00
|
|
|
public function isCreatable() {
|
|
|
|
return $this->getFileInfo()->isCreatable();
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @return Node
|
|
|
|
*/
|
|
|
|
public function getParent() {
|
|
|
|
return $this->root->get(dirname($this->path));
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @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;
|
|
|
|
}
|
2014-12-04 12:27:08 +00:00
|
|
|
|
|
|
|
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();
|
|
|
|
}
|
2014-12-16 13:24:48 +00:00
|
|
|
|
|
|
|
public function getMountPoint() {
|
|
|
|
return $this->getFileInfo()->getMountPoint();
|
|
|
|
}
|
2015-11-02 13:56:38 +00:00
|
|
|
|
|
|
|
public function getOwner() {
|
|
|
|
return $this->getFileInfo()->getOwner();
|
|
|
|
}
|
2016-01-29 20:50:48 +00:00
|
|
|
|
|
|
|
public function getChecksum() {
|
|
|
|
return;
|
|
|
|
}
|
2013-09-01 17:47:48 +00:00
|
|
|
}
|