nextcloud/lib/public/Share/IShare.php

328 lines
6.8 KiB
PHP
Raw Normal View History

<?php
/**
2016-01-12 17:02:16 +03:00
* @copyright Copyright (c) 2016, ownCloud, Inc.
2016-07-21 18:07:57 +03:00
*
* @author Roeland Jago Douma <roeland@famdouma.nl>
*
* @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/>
*
*/
2016-01-27 14:13:53 +03:00
namespace OCP\Share;
use OCP\Files\File;
use OCP\Files\Folder;
use OCP\Files\Node;
use OCP\Files\NotFoundException;
use OCP\Share\Exceptions\IllegalIDChangeException;
2016-01-27 14:13:53 +03:00
/**
* Interface IShare
*
* @package OCP\Share
* @since 9.0.0
*/
interface IShare {
/**
* Set the internal id of the share
* It is only allowed to set the internal id of a share once.
* Attempts to override the internal id will result in an IllegalIDChangeException
*
* @param string $id
* @return \OCP\Share\IShare
* @throws IllegalIDChangeException
* @throws \InvalidArgumentException
* @since 9.1.0
*/
public function setId($id);
/**
* Get the internal id of the share.
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getId();
/**
* Get the full share id. This is the <providerid>:<internalid>.
* The full id is unique in the system.
*
2016-02-08 17:28:36 +03:00
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
2016-02-08 17:28:36 +03:00
* @throws \UnexpectedValueException If the fullId could not be constructed
*/
public function getFullId();
/**
* Set the provider id of the share
* It is only allowed to set the provider id of a share once.
* Attempts to override the provider id will result in an IllegalIDChangeException
*
* @param string $id
* @return \OCP\Share\IShare
* @throws IllegalIDChangeException
* @throws \InvalidArgumentException
* @since 9.1.0
*/
public function setProviderId($id);
/**
* Set the node of the file/folder that is shared
*
* @param Node $node
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setNode(Node $node);
/**
* Get the node of the file/folder that is shared
2016-01-27 14:13:53 +03:00
*
* @return File|Folder
2016-01-27 14:13:53 +03:00
* @since 9.0.0
* @throws NotFoundException
*/
public function getNode();
/**
* Set file id for lazy evaluation of the node
* @param int $fileId
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setNodeId($fileId);
/**
* Get the fileid of the node of this share
* @return int
* @since 9.0.0
* @throws NotFoundException
*/
public function getNodeId();
/**
* Set the type of node (file/folder)
*
* @param string $type
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setNodeType($type);
/**
* Get the type of node (file/folder)
*
* @return string
* @since 9.0.0
* @throws NotFoundException
*/
public function getNodeType();
/**
* Set the shareType
*
* @param int $shareType
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setShareType($shareType);
/**
2016-01-27 14:13:53 +03:00
* Get the shareType
*
* @return int
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getShareType();
/**
* Set the receiver of this share.
*
* @param string $sharedWith
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setSharedWith($sharedWith);
/**
* Get the receiver of this share.
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getSharedWith();
/**
* Set the permissions.
* See \OCP\Constants::PERMISSION_*
*
* @param int $permissions
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setPermissions($permissions);
/**
* Get the share permissions
* See \OCP\Constants::PERMISSION_*
*
* @return int
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getPermissions();
/**
* Set the expiration date
*
* @param \DateTime $expireDate
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setExpirationDate($expireDate);
/**
* Get the expiration date
*
* @return \DateTime
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getExpirationDate();
/**
* Set the sharer of the path.
*
* @param string $sharedBy
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setSharedBy($sharedBy);
/**
* Get share sharer
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getSharedBy();
/**
* Set the original share owner (who owns the path that is shared)
*
* @param string $shareOwner
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setShareOwner($shareOwner);
/**
* Get the original share owner (who owns the path that is shared)
2016-01-27 14:13:53 +03:00
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getShareOwner();
/**
* Set the password for this share.
* When the share is passed to the share manager to be created
* or updated the password will be hashed.
*
* @param string $password
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setPassword($password);
/**
* Get the password of this share.
* If this share is obtained via a shareprovider the password is
* hashed.
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getPassword();
/**
* Set the public link token.
*
* @param string $token
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setToken($token);
/**
* Get the public link token.
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getToken();
/**
* Set the target path of this share relative to the recipients user folder.
*
* @param string $target
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
*/
public function setTarget($target);
2015-11-02 23:06:55 +03:00
/**
* Get the target path of this share relative to the recipients user folder.
2015-11-02 23:06:55 +03:00
*
* @return string
2016-01-27 14:13:53 +03:00
* @since 9.0.0
2015-11-02 23:06:55 +03:00
*/
public function getTarget();
2016-01-27 13:50:49 +03:00
/**
* Set the time this share was created
*
* @param \DateTime $shareTime
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
2016-01-27 13:50:49 +03:00
*/
public function setShareTime(\DateTime $shareTime);
2016-01-27 13:50:49 +03:00
/**
* Get the timestamp this share was created
*
* @return \DateTime
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
2016-01-27 13:50:49 +03:00
public function getShareTime();
/**
* Set if the recipient is informed by mail about the share.
2016-01-27 13:50:49 +03:00
*
* @param bool $mailSend
2016-01-27 14:13:53 +03:00
* @return \OCP\Share\IShare The modified object
* @since 9.0.0
2016-01-27 13:50:49 +03:00
*/
public function setMailSend($mailSend);
/**
* Get if the recipient informed by mail about the share.
*
* @return bool
2016-01-27 14:13:53 +03:00
* @since 9.0.0
*/
public function getMailSend();
}