Merge branch 'develop' into loic

1 files changed, 95 insertions, 0 deletions

diff --git a/server/vendor/php-opencloud/common/src/Common/Transport/JsonSerializer.php b/server/vendor/php-opencloud/common/src/Common/Transport/JsonSerializer.php
new file mode 100644
index 0000000..11b31d3
--- /dev/null
+++ b/server/vendor/php-opencloud/common/src/Common/Transport/JsonSerializer.php
@@ -0,0 +1,95 @@
+<?php
+
+namespace OpenCloud\Common\Transport;
+
+use OpenCloud\Common\Api\Parameter;
+use OpenCloud\Common\JsonPath;
+
+/**
+ * Class responsible for populating the JSON body of a {@see GuzzleHttp\Message\Request} object.
+ *
+ * @package OpenCloud\Common\Transport
+ */
+class JsonSerializer
+{
+    /**
+     * Populates the actual value into a JSON field, i.e. it has reached the end of the line and no
+     * further nesting is required.
+     *
+     * @param Parameter $param     The schema that defines how the JSON field is being populated
+     * @param mixed     $userValue The user value that is populating a JSON field
+     * @param array     $json      The existing JSON structure that will be populated
+     *
+     * @return array|mixed
+     */
+    private function stockValue(Parameter $param, $userValue, $json)
+    {
+        $name = $param->getName();
+        if ($path = $param->getPath()) {
+            $jsonPath = new JsonPath($json);
+            $jsonPath->set(sprintf("%s.%s", $path, $name), $userValue);
+            $json = $jsonPath->getStructure();
+        } elseif ($name) {
+            $json[$name] = $userValue;
+        } else {
+            $json[] = $userValue;
+        }
+
+        return $json;
+    }
+
+    /**
+     * Populates a value into an array-like structure.
+     *
+     * @param Parameter $param     The schema that defines how the JSON field is being populated
+     * @param mixed     $userValue The user value that is populating a JSON field
+     *
+     * @return array|mixed
+     */
+    private function stockArrayJson(Parameter $param, $userValue)
+    {
+        $elems = [];
+        foreach ($userValue as $item) {
+            $elems = $this->stockJson($param->getItemSchema(), $item, $elems);
+        }
+        return $elems;
+    }
+
+    /**
+     * Populates a value into an object-like structure.
+     *
+     * @param Parameter $param     The schema that defines how the JSON field is being populated
+     * @param mixed     $userValue The user value that is populating a JSON field
+     *
+     * @return array
+     */
+    private function stockObjectJson(Parameter $param, $userValue)
+    {
+        $object = [];
+        foreach ($userValue as $key => $val) {
+            $object = $this->stockJson($param->getProperty($key), $val, $object);
+        }
+        return $object;
+    }
+
+    /**
+     * A generic method that will populate a JSON structure with a value according to a schema. It
+     * supports multiple types and will delegate accordingly.
+     *
+     * @param Parameter $param     The schema that defines how the JSON field is being populated
+     * @param mixed     $userValue The user value that is populating a JSON field
+     * @param array     $json      The existing JSON structure that will be populated
+     *
+     * @return array
+     */
+    public function stockJson(Parameter $param, $userValue, $json)
+    {
+        if ($param->isArray()) {
+            $userValue = $this->stockArrayJson($param, $userValue);
+        } elseif ($param->isObject()) {
+            $userValue = $this->stockObjectJson($param, $userValue);
+        }
+        // Populate the final value
+        return $this->stockValue($param, $userValue, $json);
+    }
+}