new service to handle multi entity levels

Author: thomas-kl1

docs/sample/code/zcrm_oauthtokens.txt

@@ -0,0 +1 @@
+2021-03-24 09:14:01 INFO: Access Token has expired. Hence refreshing.

docs/sample/code/zoho_oauth.log

@@ -12,14 +12,20 @@
 use Zoho\Desk\Exception\Exception;
 use Zoho\Desk\Exception\InvalidArgumentException;
 use Zoho\Desk\OAuth\ClientInterface;
+
+use function array_keys;
+use function array_map;
 use function array_merge;
+use function array_values;
 use function curl_init;
 use function curl_setopt;
 use function http_build_query;
 use function is_array;
 use function is_numeric;
 use function json_encode;
 use function sprintf;
+use function str_replace;
+
 use const CURLOPT_CUSTOMREQUEST;
 use const CURLOPT_HEADER;
 use const CURLOPT_HTTPHEADER;
@@ -61,13 +67,25 @@ public function __construct(ClientInterface $client, array $mandatoryData = [])
         $this->data = [];
     }
 
+    /**
+     * @deprecated
+     */
     public function setEntityType(string $entityType): self
     {
         $this->data['entityType'] = $entityType;
 
         return $this;
     }
 
+    public function setPath(string $path, array $bind = []): self
+    {
+        $search = array_map(static function (string $variable): string {
+            return '{' . $variable . '}';
+        }, array_keys($bind));
+
+        return $this->setEntityType(str_replace($search, array_values($bind), $path));
+    }
+
     public function setMethod(string $method): self
     {
         $this->data['method'] = $method;

src/Client/RequestBuilder.php

@@ -12,6 +12,7 @@
 
 /**
  * @api
+ * @deprecated
  */
 interface CreateOperationInterface
 {

src/Model/Operation/CreateOperationInterface.php

@@ -11,6 +11,7 @@
 
 /**
  * @api
+ * @deprecated
  */
 interface DeleteOperationInterface
 {

src/Model/Operation/DeleteOperationInterface.php

@@ -13,6 +13,7 @@
 
 /**
  * @api
+ * @deprecated
  */
 interface ListOperationInterface
 {

src/Model/Operation/ListOperationInterface.php

@@ -12,6 +12,7 @@
 
 /**
  * @api
+ * @deprecated
  */
 interface ReadOperationInterface
 {

src/Model/Operation/ReadOperationInterface.php

@@ -12,6 +12,7 @@
 
 /**
  * @api
+ * @deprecated
  */
 interface UpdateOperationInterface
 {

src/Model/Operation/UpdateOperationInterface.php

@@ -21,6 +21,9 @@
 use function implode;
 use function md5;
 
+/**
+ * @deprecated
+ */
 final class OperationPool
 {
     private RequestBuilder $requestBuilder;

src/Model/OperationPool.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * Copyright © Thomas Klein, All rights reserved.
+ * See LICENSE bundled with this library for license details.
+ */
+declare(strict_types=1);
+
+namespace Zoho\Desk\Service;
+
+use Zoho\Desk\Client\RequestBuilder;
+use Zoho\Desk\Client\ResponseInterface;
+use Zoho\Desk\Exception\CouldNotSaveException;
+use Zoho\Desk\Exception\Exception;
+use Zoho\Desk\Exception\InvalidArgumentException;
+use Zoho\Desk\Exception\InvalidRequestException;
+use Zoho\Desk\Model\DataObjectFactory;
+use Zoho\Desk\Model\DataObjectInterface;
+
+final class CreateOperation implements CreateOperationInterface
+{
+    private RequestBuilder $requestBuilder;
+
+    private DataObjectFactory $dataObjectFactory;
+
+    private string $entityType;
+
+    private ?string $path;
+
+    /**
+     * @var string[]
+     */
+    private array $arguments;
+
+    public function __construct(
+        RequestBuilder $requestBuilder,
+        DataObjectFactory $dataObjectFactory,
+        string $entityType,
+        ?string $path = null,
+        array $arguments = []
+    ) {
+        $this->requestBuilder = $requestBuilder;
+        $this->dataObjectFactory = $dataObjectFactory;
+        $this->entityType = $entityType;
+        $this->path = $path;
+        $this->arguments = $arguments;
+    }
+
+    public function create(DataObjectInterface $dataObject, array $bind = []): DataObjectInterface
+    {
+        try {
+            return $this->dataObjectFactory->create($this->entityType, $this->saveEntity($dataObject)->getResult());
+        } catch (InvalidArgumentException $e) {
+            throw new CouldNotSaveException($e->getMessage(), $e->getCode(), $e);
+        } catch (InvalidRequestException $e) {
+            throw new CouldNotSaveException($e->getMessage(), $e->getCode(), $e);
+        } catch (Exception $e) {
+            throw new CouldNotSaveException('Could not create the entity.', $e->getCode(), $e);
+        }
+    }
+
+    /**
+     * @throws Exception
+     * @throws InvalidArgumentException
+     * @throws InvalidRequestException
+     */
+    private function saveEntity(DataObjectInterface $dataObject, array $bind = []): ResponseInterface
+    {
+        return $this->requestBuilder
+            ->setPath($this->path ?? $this->entityType, $bind)
+            ->setMethod(RequestBuilder::HTTP_POST)
+            ->setArguments($this->arguments)
+            ->setFields($dataObject->toArray())
+            ->create()
+            ->execute();
+    }
+}