4adac445dc
fix select statement Make trashbin api modules Apps can register trashbin backends for specific storages, allowing them to modify trashbin behavior for storages The old trashbin implementation has been wrapped in a "legacy" backend, for future work this can be replaced with a new backend that better handles shares while still keeping the legacy backend around to keep existing trash from being accessible Signed-off-by: Robin Appelman <robin@icewind.nl>
78 lines
2 KiB
PHP
78 lines
2 KiB
PHP
<?php
|
|
/**
|
|
* @copyright Copyright (c) 2018 Robin Appelman <robin@icewind.nl>
|
|
*
|
|
* @license GNU AGPL version 3 or any later version
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* 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
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
namespace OCA\Files_Trashbin\Trash;
|
|
|
|
use OCP\Files\FileInfo;
|
|
use OCP\Files\Storage\IStorage;
|
|
use OCP\IUser;
|
|
|
|
/**
|
|
* @since 15.0.0
|
|
*/
|
|
interface ITrashBackend {
|
|
/**
|
|
* List all trash items in the root of the trashbin
|
|
*
|
|
* @param IUser $user
|
|
* @return ITrashItem[]
|
|
* @since 15.0.0
|
|
*/
|
|
public function listTrashRoot(IUser $user): array;
|
|
|
|
/**
|
|
* List all trash items in a subfolder in the trashbin
|
|
*
|
|
* @param IUser $user
|
|
* @param ITrashItem $folder
|
|
* @return ITrashItem[]
|
|
* @since 15.0.0
|
|
*/
|
|
public function listTrashFolder(IUser $user, ITrashItem $folder): array;
|
|
|
|
/**
|
|
* Restore a trashbin item
|
|
*
|
|
* @param ITrashItem $item
|
|
* @since 15.0.0
|
|
*/
|
|
public function restoreItem(ITrashItem $item);
|
|
|
|
/**
|
|
* Permanently remove an item from trash
|
|
*
|
|
* @param IUser $user
|
|
* @param ITrashItem $item
|
|
* @return
|
|
* @since 15.0.0
|
|
*/
|
|
public function removeItem(IUser $user, ITrashItem $item);
|
|
|
|
/**
|
|
* Move a file or folder to trash
|
|
*
|
|
* @param IStorage $storage
|
|
* @param string $internalPath
|
|
* @return boolean whether or not the file was moved to trash, if false then the file should be deleted normally
|
|
* @since 15.0.0
|
|
*/
|
|
public function moveToTrash(IStorage $storage, string $internalPath);
|
|
}
|