mirror of
https://github.com/nextcloud/server.git
synced 2024-08-30 17:57:26 +02:00
241 lines
4.7 KiB
PHP
241 lines
4.7 KiB
PHP
<?php
|
|
/**
|
|
* @author Joas Schilling <nickvergessen@owncloud.com>
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
* @author Robin Appelman <icewind@owncloud.com>
|
|
* @author Robin McCorkell <rmccorkell@karoshi.org.uk>
|
|
* @author Thomas Müller <thomas.mueller@tmit.eu>
|
|
*
|
|
* @copyright Copyright (c) 2015, ownCloud, Inc.
|
|
* @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 OCP\Files;
|
|
|
|
/**
|
|
* Interface FileInfo
|
|
*
|
|
* @package OCP\Files
|
|
* @since 7.0.0
|
|
*/
|
|
interface FileInfo {
|
|
/**
|
|
* @since 7.0.0
|
|
*/
|
|
const TYPE_FILE = 'file';
|
|
/**
|
|
* @since 7.0.0
|
|
*/
|
|
const TYPE_FOLDER = 'dir';
|
|
|
|
/**
|
|
* @const \OCP\Files\FileInfo::SPACE_NOT_COMPUTED Return value for a not computed space value
|
|
* @since 8.0.0
|
|
*/
|
|
const SPACE_NOT_COMPUTED = -1;
|
|
/**
|
|
* @const \OCP\Files\FileInfo::SPACE_UNKNOWN Return value for unknown space value
|
|
* @since 8.0.0
|
|
*/
|
|
const SPACE_UNKNOWN = -2;
|
|
/**
|
|
* @const \OCP\Files\FileInfo::SPACE_UNKNOWN Return value for unlimited space
|
|
* @since 8.0.0
|
|
*/
|
|
const SPACE_UNLIMITED = -3;
|
|
|
|
/**
|
|
* Get the Etag of the file or folder
|
|
*
|
|
* @return string
|
|
* @since 7.0.0
|
|
*/
|
|
public function getEtag();
|
|
|
|
/**
|
|
* Get the size in bytes for the file or folder
|
|
*
|
|
* @return int
|
|
* @since 7.0.0
|
|
*/
|
|
public function getSize();
|
|
|
|
/**
|
|
* Get the last modified date as timestamp for the file or folder
|
|
*
|
|
* @return int
|
|
* @since 7.0.0
|
|
*/
|
|
public function getMtime();
|
|
|
|
/**
|
|
* Get the name of the file or folder
|
|
*
|
|
* @return string
|
|
* @since 7.0.0
|
|
*/
|
|
public function getName();
|
|
|
|
/**
|
|
* Get the path relative to the storage
|
|
*
|
|
* @return string
|
|
* @since 7.0.0
|
|
*/
|
|
public function getInternalPath();
|
|
|
|
/**
|
|
* Get the absolute path
|
|
*
|
|
* @return string
|
|
* @since 7.0.0
|
|
*/
|
|
public function getPath();
|
|
|
|
/**
|
|
* Get the full mimetype of the file or folder i.e. 'image/png'
|
|
*
|
|
* @return string
|
|
* @since 7.0.0
|
|
*/
|
|
public function getMimetype();
|
|
|
|
/**
|
|
* Get the first part of the mimetype of the file or folder i.e. 'image'
|
|
*
|
|
* @return string
|
|
* @since 7.0.0
|
|
*/
|
|
public function getMimePart();
|
|
|
|
/**
|
|
* Get the storage the file or folder is storage on
|
|
*
|
|
* @return \OCP\Files\Storage
|
|
* @since 7.0.0
|
|
*/
|
|
public function getStorage();
|
|
|
|
/**
|
|
* Get the file id of the file or folder
|
|
*
|
|
* @return int
|
|
* @since 7.0.0
|
|
*/
|
|
public function getId();
|
|
|
|
/**
|
|
* Check whether the file is encrypted
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isEncrypted();
|
|
|
|
/**
|
|
* Get the permissions of the file or folder as bitmasked combination of the following constants
|
|
* \OCP\Constants::PERMISSION_CREATE
|
|
* \OCP\Constants::PERMISSION_READ
|
|
* \OCP\Constants::PERMISSION_UPDATE
|
|
* \OCP\Constants::PERMISSION_DELETE
|
|
* \OCP\Constants::PERMISSION_SHARE
|
|
* \OCP\Constants::PERMISSION_ALL
|
|
*
|
|
* @return int
|
|
* @since 7.0.0 - namespace of constants has changed in 8.0.0
|
|
*/
|
|
public function getPermissions();
|
|
|
|
/**
|
|
* Check whether this is a file or a folder
|
|
*
|
|
* @return \OCP\Files\FileInfo::TYPE_FILE|\OCP\Files\FileInfo::TYPE_FOLDER
|
|
* @since 7.0.0
|
|
*/
|
|
public function getType();
|
|
|
|
/**
|
|
* Check if the file or folder is readable
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isReadable();
|
|
|
|
/**
|
|
* Check if a file is writable
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isUpdateable();
|
|
|
|
/**
|
|
* Check whether new files or folders can be created inside this folder
|
|
*
|
|
* @return bool
|
|
* @since 8.0.0
|
|
*/
|
|
public function isCreatable();
|
|
|
|
/**
|
|
* Check if a file or folder can be deleted
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isDeletable();
|
|
|
|
/**
|
|
* Check if a file or folder can be shared
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isShareable();
|
|
|
|
/**
|
|
* Check if a file or folder is shared
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isShared();
|
|
|
|
/**
|
|
* Check if a file or folder is mounted
|
|
*
|
|
* @return bool
|
|
* @since 7.0.0
|
|
*/
|
|
public function isMounted();
|
|
|
|
/**
|
|
* Get the mountpoint the file belongs to
|
|
*
|
|
* @return \OCP\Files\Mount\IMountPoint
|
|
* @since 8.0.0
|
|
*/
|
|
public function getMountPoint();
|
|
|
|
/**
|
|
* Get the owner of the file
|
|
*
|
|
* @return \OCP\IUser
|
|
* @since 9.0.0
|
|
*/
|
|
public function getOwner();
|
|
}
|