enabled = $enabled; return $this; } /** * @return bool */ public function isEnabled(): bool { return $this->enabled; } /** * @param string $apiVersion * * @return $this */ public function setApiVersion(string $apiVersion): static { $this->apiVersion = $apiVersion; return $this; } /** * @return string */ public function getApiVersion(): string { return $this->apiVersion; } /** * @param string $endPoint * * @return $this */ public function setEndPoint(string $endPoint): static { $this->endPoint = $endPoint; return $this; } /** * @return string */ public function getEndPoint(): string { return $this->endPoint; } /** * create a new resource to later add it with {@see IOCMProvider::addResourceType()} * @return IOCMResource */ public function createNewResourceType(): IOCMResource { return new OCMResource(); } /** * @param IOCMResource $resource * * @return $this */ public function addResourceType(IOCMResource $resource): static { $this->resourceTypes[] = $resource; return $this; } /** * @param IOCMResource[] $resourceTypes * * @return $this */ public function setResourceTypes(array $resourceTypes): static { $this->resourceTypes = $resourceTypes; return $this; } /** * @return IOCMResource[] */ public function getResourceTypes(): array { if (!$this->emittedEvent) { $this->emittedEvent = true; $event = new ResourceTypeRegisterEvent($this); $this->dispatcher->dispatchTyped($event); } return $this->resourceTypes; } /** * @param string $resourceName * @param string $protocol * * @return string * @throws OCMArgumentException */ public function extractProtocolEntry(string $resourceName, string $protocol): string { foreach ($this->getResourceTypes() as $resource) { if ($resource->getName() === $resourceName) { $entry = $resource->getProtocols()[$protocol] ?? null; if (is_null($entry)) { throw new OCMArgumentException('protocol not found'); } return (string)$entry; } } throw new OCMArgumentException('resource not found'); } /** * import data from an array * * @param array $data * * @return $this * @throws OCMProviderException in case a descent provider cannot be generated from data * @see self::jsonSerialize() */ public function import(array $data): static { $this->setEnabled(is_bool($data['enabled'] ?? '') ? $data['enabled'] : false) ->setApiVersion((string)($data['apiVersion'] ?? '')) ->setEndPoint($data['endPoint'] ?? ''); $resources = []; foreach (($data['resourceTypes'] ?? []) as $resourceData) { $resource = new OCMResource(); $resources[] = $resource->import($resourceData); } $this->setResourceTypes($resources); if (!$this->looksValid()) { throw new OCMProviderException('remote provider does not look valid'); } return $this; } /** * @return bool */ private function looksValid(): bool { return ($this->getApiVersion() !== '' && $this->getEndPoint() !== ''); } /** * @return array{ * enabled: bool, * apiVersion: string, * endPoint: string, * resourceTypes: array{ * name: string, * shareTypes: string[], * protocols: array * }[] * } */ public function jsonSerialize(): array { $resourceTypes = []; foreach ($this->getResourceTypes() as $res) { $resourceTypes[] = $res->jsonSerialize(); } return [ 'enabled' => $this->isEnabled(), 'apiVersion' => $this->getApiVersion(), 'endPoint' => $this->getEndPoint(), 'resourceTypes' => $resourceTypes ]; } }