server/lib/public/Files/FileInfo.php

256 lines
4.9 KiB
PHP
Raw Normal View History

<?php
/**
2016-07-21 15:07:57 +00:00
* @copyright Copyright (c) 2016, ownCloud, Inc.
*
* @author Joas Schilling <coding@schilljs.com>
2015-03-26 10:44:34 +00:00
* @author Morris Jobke <hey@morrisjobke.de>
2016-07-21 16:13:36 +00:00
* @author Robin Appelman <robin@icewind.nl>
2016-01-12 14:02:16 +00:00
* @author Robin McCorkell <robin@mccorkell.me.uk>
2016-07-21 15:07:57 +00:00
* @author Roeland Jago Douma <roeland@famdouma.nl>
2015-03-26 10:44:34 +00:00
* @author Thomas Müller <thomas.mueller@tmit.eu>
*
* @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
*/
2014-03-07 13:52:44 +00:00
const TYPE_FOLDER = 'dir';
/**
* @const \OCP\Files\FileInfo::SPACE_NOT_COMPUTED Return value for a not computed space value
* @since 8.0.0
*/
2014-08-19 12:05:08 +00:00
const SPACE_NOT_COMPUTED = -1;
/**
* @const \OCP\Files\FileInfo::SPACE_UNKNOWN Return value for unknown space value
* @since 8.0.0
*/
2014-08-19 12:05:08 +00:00
const SPACE_UNKNOWN = -2;
/**
* @const \OCP\Files\FileInfo::SPACE_UNKNOWN Return value for unlimited space
* @since 8.0.0
*/
2014-08-19 12:05:08 +00:00
const SPACE_UNLIMITED = -3;
2016-07-22 12:37:37 +00:00
/**
* @since 9.1.0
*/
const MIMETYPE_FOLDER = 'httpd/unix-directory';
/**
2014-01-13 13:42:14 +00:00
* Get the Etag of the file or folder
*
* @return string
* @since 7.0.0
*/
public function getEtag();
/**
2014-01-13 13:42:14 +00:00
* Get the size in bytes for the file or folder
*
* @return int
* @since 7.0.0
*/
public function getSize();
/**
2014-01-13 13:42:14 +00:00
* Get the last modified date as timestamp for the file or folder
*
* @return int
* @since 7.0.0
*/
public function getMtime();
/**
2014-01-13 13:42:14 +00:00
* Get the name of the file or folder
*
* @return string
* @since 7.0.0
*/
public function getName();
/**
2014-01-13 13:42:14 +00:00
* Get the path relative to the storage
*
* @return string
* @since 7.0.0
*/
public function getInternalPath();
/**
2014-01-13 13:42:14 +00:00
* Get the absolute path
*
* @return string
* @since 7.0.0
*/
public function getPath();
/**
2014-01-13 13:42:14 +00:00
* Get the full mimetype of the file or folder i.e. 'image/png'
*
* @return string
* @since 7.0.0
*/
public function getMimetype();
/**
2014-01-13 13:42:14 +00:00
* Get the first part of the mimetype of the file or folder i.e. 'image'
*
* @return string
* @since 7.0.0
2014-01-13 13:42:14 +00:00
*/
public function getMimePart();
/**
* Get the storage the file or folder is storage on
*
* @return \OCP\Files\Storage
* @since 7.0.0
*/
public function getStorage();
/**
2014-01-13 13:42:14 +00:00
* Get the file id of the file or folder
*
* @return int
* @since 7.0.0
*/
public function getId();
/**
2014-01-13 13:42:14 +00:00
* Check whether the file is encrypted
*
* @return bool
* @since 7.0.0
*/
public function isEncrypted();
/**
2014-01-13 13:42:14 +00:00
* 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
2014-01-13 13:42:14 +00:00
*
* @return int
* @since 7.0.0 - namespace of constants has changed in 8.0.0
*/
public function getPermissions();
/**
2014-01-13 13:42:14 +00:00
* Check whether this is a file or a folder
*
2014-05-11 17:28:45 +00:00
* @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();
2014-12-16 13:24:48 +00:00
/**
* Get the mountpoint the file belongs to
*
* @return \OCP\Files\Mount\IMountPoint
* @since 8.0.0
2014-12-16 13:24:48 +00:00
*/
public function getMountPoint();
2015-11-02 13:56:38 +00:00
/**
* Get the owner of the file
*
* @return \OCP\IUser
* @since 9.0.0
*/
public function getOwner();
/**
* Get the stored checksum for this file
*
* @return string
* @since 9.0.0
*/
public function getChecksum();
}