summaryrefslogtreecommitdiffstats
path: root/apps/files_external/lib/Lib/FrontendDefinitionTrait.php
diff options
context:
space:
mode:
authorJoas Schilling <nickvergessen@owncloud.com>2016-05-13 11:56:47 +0200
committerJoas Schilling <nickvergessen@owncloud.com>2016-05-24 08:41:22 +0200
commitf14dff680d5e1e0fe10065ed25c524d9b5078cae (patch)
treef86d6466629f4d0f5d1a6de7fcd111ca27d3f52f /apps/files_external/lib/Lib/FrontendDefinitionTrait.php
parent4576891f10aa41cc146dc6ed421384269eca283a (diff)
downloadnextcloud-server-f14dff680d5e1e0fe10065ed25c524d9b5078cae.tar.gz
nextcloud-server-f14dff680d5e1e0fe10065ed25c524d9b5078cae.zip
Move remaining classes to PSR-4
Diffstat (limited to 'apps/files_external/lib/Lib/FrontendDefinitionTrait.php')
-rw-r--r--apps/files_external/lib/Lib/FrontendDefinitionTrait.php158
1 files changed, 158 insertions, 0 deletions
diff --git a/apps/files_external/lib/Lib/FrontendDefinitionTrait.php b/apps/files_external/lib/Lib/FrontendDefinitionTrait.php
new file mode 100644
index 00000000000..ccc2a75fd1b
--- /dev/null
+++ b/apps/files_external/lib/Lib/FrontendDefinitionTrait.php
@@ -0,0 +1,158 @@
+<?php
+/**
+ * @author Robin Appelman <icewind@owncloud.com>
+ * @author Robin McCorkell <robin@mccorkell.me.uk>
+ *
+ * @copyright Copyright (c) 2016, ownCloud, Inc.
+ * @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 OCA\Files_External\Lib;
+
+use \OCA\Files_External\Lib\DefinitionParameter;
+use \OCA\Files_External\Lib\StorageConfig;
+
+/**
+ * Trait for objects that have a frontend representation
+ */
+trait FrontendDefinitionTrait {
+
+ /** @var string human-readable mechanism name */
+ private $text;
+
+ /** @var DefinitionParameter[] parameters for mechanism */
+ private $parameters = [];
+
+ /** @var string[] custom JS */
+ private $customJs = [];
+
+ /**
+ * @return string
+ */
+ public function getText() {
+ return $this->text;
+ }
+
+ /**
+ * @param string $text
+ * @return self
+ */
+ public function setText($text) {
+ $this->text = $text;
+ return $this;
+ }
+
+ /**
+ * @param FrontendDefinitionTrait $a
+ * @param FrontendDefinitionTrait $b
+ * @return int
+ */
+ public static function lexicalCompare(FrontendDefinitionTrait $a, FrontendDefinitionTrait $b) {
+ return strcmp($a->getText(), $b->getText());
+ }
+
+ /**
+ * @return DefinitionParameter[]
+ */
+ public function getParameters() {
+ return $this->parameters;
+ }
+
+ /**
+ * @param DefinitionParameter[] $parameters
+ * @return self
+ */
+ public function addParameters(array $parameters) {
+ foreach ($parameters as $parameter) {
+ $this->addParameter($parameter);
+ }
+ return $this;
+ }
+
+ /**
+ * @param DefinitionParameter $parameter
+ * @return self
+ */
+ public function addParameter(DefinitionParameter $parameter) {
+ $this->parameters[$parameter->getName()] = $parameter;
+ return $this;
+ }
+
+ /**
+ * @return string[]
+ */
+ public function getCustomJs() {
+ return $this->customJs;
+ }
+
+ /**
+ * @param string $custom
+ * @return self
+ */
+ public function addCustomJs($custom) {
+ $this->customJs[] = $custom;
+ return $this;
+ }
+
+ /**
+ * @param string $custom
+ * @return self
+ * @deprecated 9.1.0, use addCustomJs() instead
+ */
+ public function setCustomJs($custom) {
+ $this->customJs = [$custom];
+ return $this;
+ }
+
+ /**
+ * Serialize into JSON for client-side JS
+ *
+ * @return array
+ */
+ public function jsonSerializeDefinition() {
+ $configuration = [];
+ foreach ($this->getParameters() as $parameter) {
+ $configuration[$parameter->getName()] = $parameter;
+ }
+
+ $data = [
+ 'name' => $this->getText(),
+ 'configuration' => $configuration,
+ 'custom' => $this->getCustomJs(),
+ ];
+ return $data;
+ }
+
+ /**
+ * Check if parameters are satisfied in a StorageConfig
+ *
+ * @param StorageConfig $storage
+ * @return bool
+ */
+ public function validateStorageDefinition(StorageConfig $storage) {
+ foreach ($this->getParameters() as $name => $parameter) {
+ $value = $storage->getBackendOption($name);
+ if (!is_null($value) || !$parameter->isOptional()) {
+ if (!$parameter->validateValue($value)) {
+ return false;
+ }
+ $storage->setBackendOption($name, $value);
+ }
+ }
+ return true;
+ }
+
+}