From c479658f0bb953ded4b29ca573404a318f1e798f Mon Sep 17 00:00:00 2001
From: EoleDev <root@serverpc.home>
Date: Wed, 9 Mar 2016 15:36:02 +0100
Subject: New Library

---
 .../common/src/Common/Resource/HasMetadata.php     | 67 ++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 server/vendor/php-opencloud/common/src/Common/Resource/HasMetadata.php

(limited to 'server/vendor/php-opencloud/common/src/Common/Resource/HasMetadata.php')

diff --git a/server/vendor/php-opencloud/common/src/Common/Resource/HasMetadata.php b/server/vendor/php-opencloud/common/src/Common/Resource/HasMetadata.php
new file mode 100644
index 0000000..53b51fc
--- /dev/null
+++ b/server/vendor/php-opencloud/common/src/Common/Resource/HasMetadata.php
@@ -0,0 +1,67 @@
+<?php
+
+namespace OpenCloud\Common\Resource;
+
+use Psr\Http\Message\ResponseInterface;
+
+interface HasMetadata
+{
+    /**
+     * Retrieves the metadata for the resource in the form of an associative array or hash. Each key represents the
+     * metadata item's name, and each value represents the metadata item's remote value.
+     *
+     * @return array
+     */
+    public function getMetadata();
+
+    /**
+     * Merges a set of new values with those which already exist (on the remote API) for a resource. For example, if
+     * the resource has this metadata already set:
+     *
+     *  Foo: val1
+     *  Bar: val2
+     *
+     * and mergeMetadata(['Foo' => 'val3', 'Baz' => 'val4']); is called, then the resource will have the following
+     * metadata:
+     *
+     *  Foo: val3
+     *  Bar: val2
+     *  Baz: val4
+     *
+     * You will notice that any metadata items which are not specified in the call are preserved.
+     *
+     * @param array $metadata The new metadata items
+     *
+     * @return mixed
+     */
+    public function mergeMetadata(array $metadata);
+
+    /**
+     * Replaces all of the existing metadata items for a resource with a new set of values. Any metadata items which
+     * are not provided in the call are removed from the resource. For example, if the resource has this metadata
+     * already set:
+     *
+     *  Foo: val1
+     *  Bar: val2
+     *
+     * and resetMetadata(['Foo' => 'val3', 'Baz' => 'val4']); is called, then the resource will have the following
+     * metadata:
+     *
+     *  Foo: val3
+     *  Baz: val4
+     *
+     * @param array $metadata The new metadata items
+     *
+     * @return mixed
+     */
+    public function resetMetadata(array $metadata);
+
+    /**
+     * Extracts metadata from a response object and returns it in the form of an associative array.
+     *
+     * @param ResponseInterface $response
+     *
+     * @return array
+     */
+    public function parseMetadata(ResponseInterface $response);
+}
-- 
cgit v1.2.3