* @author Juan Pablo Villafáñez * @author Morris Jobke * @author Robin Appelman * @author Robin McCorkell * @author Roeland Jago Douma * @author Vincent Petry * * @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 * */ namespace OCA\Files_External\Controller; use OCA\Files_External\NotFoundException; use OCA\Files_External\Service\GlobalStoragesService; use OCP\AppFramework\Http; use OCP\AppFramework\Http\Attribute\PasswordConfirmationRequired; use OCP\AppFramework\Http\DataResponse; use OCP\IConfig; use OCP\IGroupManager; use OCP\IL10N; use OCP\IRequest; use OCP\IUserSession; use Psr\Log\LoggerInterface; /** * Global storages controller */ class GlobalStoragesController extends StoragesController { /** * Creates a new global storages controller. * * @param string $AppName application name * @param IRequest $request request object * @param IL10N $l10n l10n service * @param GlobalStoragesService $globalStoragesService storage service * @param LoggerInterface $logger * @param IUserSession $userSession * @param IGroupManager $groupManager * @param IConfig $config */ public function __construct( $AppName, IRequest $request, IL10N $l10n, GlobalStoragesService $globalStoragesService, LoggerInterface $logger, IUserSession $userSession, IGroupManager $groupManager, IConfig $config ) { parent::__construct( $AppName, $request, $l10n, $globalStoragesService, $logger, $userSession, $groupManager, $config ); } /** * Create an external storage entry. * * @param string $mountPoint storage mount point * @param string $backend backend identifier * @param string $authMechanism authentication mechanism identifier * @param array $backendOptions backend-specific options * @param array $mountOptions mount-specific options * @param array $applicableUsers users for which to mount the storage * @param array $applicableGroups groups for which to mount the storage * @param int $priority priority * * @return DataResponse */ #[PasswordConfirmationRequired] public function create( $mountPoint, $backend, $authMechanism, $backendOptions, $mountOptions, $applicableUsers, $applicableGroups, $priority ) { $canCreateNewLocalStorage = $this->config->getSystemValue('files_external_allow_create_new_local', true); if (!$canCreateNewLocalStorage && $backend === 'local') { return new DataResponse( [ 'message' => $this->l10n->t('Forbidden to manage local mounts') ], Http::STATUS_FORBIDDEN ); } $newStorage = $this->createStorage( $mountPoint, $backend, $authMechanism, $backendOptions, $mountOptions, $applicableUsers, $applicableGroups, $priority ); if ($newStorage instanceof DataResponse) { return $newStorage; } $response = $this->validate($newStorage); if (!empty($response)) { return $response; } $newStorage = $this->service->addStorage($newStorage); $this->updateStorageStatus($newStorage); return new DataResponse( $newStorage->jsonSerialize(true), Http::STATUS_CREATED ); } /** * Update an external storage entry. * * @param int $id storage id * @param string $mountPoint storage mount point * @param string $backend backend identifier * @param string $authMechanism authentication mechanism identifier * @param array $backendOptions backend-specific options * @param array $mountOptions mount-specific options * @param array $applicableUsers users for which to mount the storage * @param array $applicableGroups groups for which to mount the storage * @param int $priority priority * @param bool $testOnly whether to storage should only test the connection or do more things * * @return DataResponse */ #[PasswordConfirmationRequired] public function update( $id, $mountPoint, $backend, $authMechanism, $backendOptions, $mountOptions, $applicableUsers, $applicableGroups, $priority, $testOnly = true ) { $storage = $this->createStorage( $mountPoint, $backend, $authMechanism, $backendOptions, $mountOptions, $applicableUsers, $applicableGroups, $priority ); if ($storage instanceof DataResponse) { return $storage; } $storage->setId($id); $response = $this->validate($storage); if (!empty($response)) { return $response; } try { $storage = $this->service->updateStorage($storage); } catch (NotFoundException $e) { return new DataResponse( [ 'message' => $this->l10n->t('Storage with ID "%d" not found', [$id]) ], Http::STATUS_NOT_FOUND ); } $this->updateStorageStatus($storage, $testOnly); return new DataResponse( $storage->jsonSerialize(true), Http::STATUS_OK ); } }