Add a controller with the most important methods

Signed-off-by: Joas Schilling <coding@schilljs.com>

2 files changed, 168 insertions, 0 deletions

diff --git a/core/Controller/CollaborationResourcesController.php b/core/Controller/CollaborationResourcesController.php
new file mode 100644
index 00000000000..b56d67d8454
--- /dev/null
+++ b/core/Controller/CollaborationResourcesController.php
@@ -0,0 +1,163 @@
+<?php
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2018 Joas Schilling <coding@schilljs.com>
+ *
+ * @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 OC\Core\Controller;
+
+use OCP\AppFramework\Http;
+use OCP\AppFramework\OCSController;
+use OCP\AppFramework\Http\DataResponse;
+use OCP\Collaboration\Resources\CollectionException;
+use OCP\Collaboration\Resources\ICollection;
+use OCP\Collaboration\Resources\IManager;
+use OCP\Collaboration\Resources\IResource;
+use OCP\Collaboration\Resources\ResourceException;
+use OCP\IRequest;
+
+class CollaborationResourcesController extends OCSController {
+	/** @var IManager */
+	private $manager;
+
+	public function __construct(
+		$appName,
+		IRequest $request,
+		IManager $manager
+	) {
+		parent::__construct($appName, $request);
+
+		$this->manager = $manager;
+	}
+
+	/**
+	 * @param int $collectionId
+	 * @return ICollection
+	 * @throws CollectionException when the collection was not found for the user
+	 */
+	protected function getCollection(int $collectionId): ICollection {
+		$collection = $this->manager->getCollection($collectionId);
+
+		if (false) { // TODO auth checking
+			throw new CollectionException('Not found');
+		}
+
+		return $collection;
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * @param int $collectionId
+	 * @return DataResponse
+	 */
+	public function listCollection(int $collectionId): DataResponse {
+		try {
+			$collection = $this->getCollection($collectionId);
+		} catch (CollectionException $e) {
+			return new DataResponse([], Http::STATUS_NOT_FOUND);
+		}
+
+		return new DataResponse($this->prepareCollection($collection));
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * @param int $collectionId
+	 * @param string $resourceType
+	 * @param string $resourceId
+	 * @return DataResponse
+	 */
+	public function addResource(int $collectionId, string $resourceType, string $resourceId): DataResponse {
+		try {
+			$collection = $this->getCollection($collectionId);
+		} catch (CollectionException $e) {
+			return new DataResponse([], Http::STATUS_NOT_FOUND);
+		}
+
+		try {
+			$resource = $this->manager->getResource($resourceType, $resourceId);
+		} catch (ResourceException $e) {
+			return new DataResponse([], Http::STATUS_NOT_FOUND);
+		}
+
+		try {
+			$collection->addResource($resource);
+		} catch (ResourceException $e) {
+		}
+
+		return new DataResponse($this->prepareCollection($collection));
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * @param int $collectionId
+	 * @param string $resourceType
+	 * @param string $resourceId
+	 * @return DataResponse
+	 */
+	public function removeResource(int $collectionId, string $resourceType, string $resourceId): DataResponse {
+		try {
+			$collection = $this->getCollection($collectionId);
+		} catch (CollectionException $e) {
+			return new DataResponse([], Http::STATUS_NOT_FOUND);
+		}
+
+		try {
+			$resource = $this->manager->getResource($resourceType, $resourceId);
+		} catch (CollectionException $e) {
+			return new DataResponse([], Http::STATUS_NOT_FOUND);
+		}
+
+		$collection->removeResource($resource);
+
+		return new DataResponse($this->prepareCollection($collection));
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * @param string $resourceType
+	 * @param string $resourceId
+	 * @return DataResponse
+	 */
+	public function getCollectionsByResource(string $resourceType, string $resourceId): DataResponse {
+		try {
+			// TODO auth checking
+			$resource = $this->manager->getResource($resourceType, $resourceId);
+		} catch (CollectionException $e) {
+			return new DataResponse([], Http::STATUS_NOT_FOUND);
+		}
+
+		return new DataResponse(array_map([$this, 'prepareCollection'], $resource->getCollections()));
+	}
+
+	protected function prepareCollection(ICollection $collection): array {
+		return array_map([$this, 'prepareResources'], $collection->getResources());
+	}
+
+	protected function prepareResources(IResource $resource): array {
+		return [
+			'type' => $resource->getType(),
+			'id' => $resource->getId()
+		];
+	}
+}
diff --git a/core/routes.php b/core/routes.php
index d79fea1ca21..7fcd576d322 100644
--- a/core/routes.php
+++ b/core/routes.php
@@ -90,6 +90,11 @@ $application->registerRoutes($this, [
 		['root' => '/core', 'name' => 'WhatsNew#get', 'url' => '/whatsnew', 'verb' => 'GET'],
 		['root' => '/core', 'name' => 'WhatsNew#dismiss', 'url' => '/whatsnew', 'verb' => 'POST'],
 		['root' => '/core', 'name' => 'AppPassword#getAppPassword', 'url' => '/getapppassword', 'verb' => 'GET'],
+
+		['root' => '/collaboration', 'name' => 'CollaborationResources#listCollection', 'url' => '/resources/collections/{collectionId}', 'verb' => 'GET'],
+		['root' => '/collaboration', 'name' => 'CollaborationResources#addResource', 'url' => '/resources/collections/{collectionId}', 'verb' => 'POST'],
+		['root' => '/collaboration', 'name' => 'CollaborationResources#removeResource', 'url' => '/resources/collections/{collectionId}', 'verb' => 'DELETE'],
+		['root' => '/collaboration', 'name' => 'CollaborationResources#getCollectionsByResource', 'url' => '/resources/{resourceType}/{resourceId}', 'verb' => 'GET'],
 	],
 ]);