From 0058e2408400865e70250b73fd1298626571e995 Mon Sep 17 00:00:00 2001
From: Christopher Gammie <contact@gammie.co.uk>
Date: Wed, 26 Aug 2015 19:36:08 +0100
Subject: [PATCH] Add StandardObjectInterface, closes #4

---
 .../Object/StandardObjectInterface.php        | 110 ++++++++++++++++++
 src/Object/StandardObject.php                 |   6 +-
 2 files changed, 114 insertions(+), 2 deletions(-)
 create mode 100644 src/Contracts/Object/StandardObjectInterface.php

diff --git a/src/Contracts/Object/StandardObjectInterface.php b/src/Contracts/Object/StandardObjectInterface.php
new file mode 100644
index 0000000..b4700e7
--- /dev/null
+++ b/src/Contracts/Object/StandardObjectInterface.php
@@ -0,0 +1,110 @@
+<?php
+
+/**
+ * Copyright 2015 Cloud Creativity Limited
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+namespace CloudCreativity\JsonApi\Contracts\Object;
+
+/**
+ * Interface StandardObjectInterface
+ * @package CloudCreativity\JsonApi
+ */
+interface StandardObjectInterface extends \Traversable, \Countable
+{
+
+    /**
+     * @param $key
+     * @param $default
+     * @return mixed
+     */
+    public function get($key, $default = null);
+
+    /**
+     * @param array $keys
+     * @param $default
+     * @return array
+     */
+    public function getProperties(array $keys, $default = null);
+
+    /**
+     * @param $key
+     * @param $value
+     * @return $this
+     */
+    public function set($key, $value);
+
+    /**
+     * @param array $values
+     * @return $this
+     */
+    public function setProperties(array $values);
+
+    /**
+     * @param $key
+     * @return bool
+     */
+    public function has($key);
+
+    /**
+     * Whether the object has all of the specified keys.
+     *
+     * @param array $keys
+     * @return bool
+     */
+    public function hasAll(array $keys);
+
+    /**
+     * Whether the object has any (at least one) of the specified keys.
+     *
+     * @param array $keys
+     * @return bool
+     */
+    public function hasAny(array $keys);
+
+    /**
+     * @param $key
+     * @return $this
+     */
+    public function remove($key);
+
+    /**
+     * @param array $keys
+     * @return $this
+     */
+    public function removeProperties(array $keys);
+
+    /**
+     * Reduce this object so that it only has the supplied allowed keys.
+     *
+     * @param array $keys
+     * @return $this
+     */
+    public function reduce(array $keys);
+
+    /**
+     * Get a list of the object's keys.
+     *
+     * @return string[]
+     */
+    public function keys();
+
+    /**
+     * Get the object's property values as an array.
+     *
+     * @return array
+     */
+    public function toArray();
+}
diff --git a/src/Object/StandardObject.php b/src/Object/StandardObject.php
index 708658f..026e914 100644
--- a/src/Object/StandardObject.php
+++ b/src/Object/StandardObject.php
@@ -18,11 +18,13 @@
 
 namespace CloudCreativity\JsonApi\Object;
 
+use CloudCreativity\JsonApi\Contracts\Object\StandardObjectInterface;
+
 /**
  * Class StandardObject
  * @package CloudCreativity\JsonApi
  */
-class StandardObject implements \IteratorAggregate, \Countable
+class StandardObject implements \IteratorAggregate, StandardObjectInterface
 {
 
     use ObjectProxyTrait;
@@ -95,4 +97,4 @@ public function count()
     {
         return count($this->toArray());
     }
-}
\ No newline at end of file
+}