* Copyright 2011 Google Inc.
* 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.
* This class defines attributes, valid values, and usage which is generated
* from a given json schema.
* http://tools.ietf.org/html/draft-zyp-json-schema-03#section-5
class Google_Model implements ArrayAccess
* If you need to specify a NULL JSON value, use Google_Model::NULL_VALUE
* instead - it will be replaced when converting to JSON with a real null.
const NULL_VALUE = "{}gapi-php-null";
protected $internal_gapi_mappings = array();
protected $modelData = array();
protected $processed = array();
* Polymorphic - accepts a variable number of arguments dependent
* on the type of the model subclass.
final public function __construct()
if (func_num_args() == 1 && is_array(func_get_arg(0))) {
// Initialize the model with the array's contents.
$array = func_get_arg(0);
* Getter that handles passthrough access to the data array, and lazy object creation.
* @param string $key Property name.
* @return mixed The value if any, or null.
public function __get($key)
$keyTypeName = $this->keyType($key);
$keyDataType = $this->dataType($key);
if (isset($this->$keyTypeName) && !isset($this->processed[$key])) {
if (isset($this->modelData[$key])) {
$val = $this->modelData[$key];
} else if (isset($this->$keyDataType) &&
($this->$keyDataType == 'array' || $this->$keyDataType == 'map')) {
if ($this->isAssociativeArray($val)) {
if (isset($this->$keyDataType) && 'map' == $this->$keyDataType) {
foreach ($val as $arrayKey => $arrayItem) {
$this->modelData[$key][$arrayKey] =
$this->createObjectFromName($keyTypeName, $arrayItem);
$this->modelData[$key] = $this->createObjectFromName($keyTypeName, $val);
} else if (is_array($val)) {
foreach ($val as $arrayIndex => $arrayItem) {
$arrayObject[$arrayIndex] =
$this->createObjectFromName($keyTypeName, $arrayItem);
$this->modelData[$key] = $arrayObject;
$this->processed[$key] = true;
return isset($this->modelData[$key]) ? $this->modelData[$key] : null;
* Initialize this object's properties from an array.
* @param array $array Used to seed this object's properties.
protected function mapTypes($array)
// Hard initialise simple types, lazy load more complex ones.
foreach ($array as $key => $val) {
if ( !property_exists($this, $this->keyType($key)) &&
property_exists($this, $key)) {
} elseif (property_exists($this, $camelKey = Google_Utils::camelCase($key))) {
// This checks if property exists as camelCase, leaving it in array as snake_case
// in case of backwards compatibility issues.
$this->modelData = $array;
* Blank initialiser to be used in subclasses to do post-construction initialisation - this
* avoids the need for subclasses to have to implement the variadics handling in their
protected function gapiInit()
* Create a simplified object suitable for straightforward
* conversion to JSON. This is relatively expensive
* due to the usage of reflection, but shouldn't be called
* a whole lot, and is the most straightforward way to filter.
public function toSimpleObject()
$object = new stdClass();
// Process all other data.
foreach ($this->modelData as $key => $val) {
$result = $this->getSimpleValue($val);
$object->$key = $this->nullPlaceholderCheck($result);
// Process all public properties.
$reflect = new ReflectionObject($this);
$props = $reflect->getProperties(ReflectionProperty::IS_PUBLIC);
foreach ($props as $member) {
$name = $member->getName();
$result = $this->getSimpleValue($this->$name);
$name = $this->getMappedName($name);
$object->$name = $this->nullPlaceholderCheck($result);
* Handle different types of values, primarily
* other objects and map and array data types.
private function getSimpleValue($value)
if ($value instanceof Google_Model) {
return $value->toSimpleObject();
} else if (is_array($value)) {
foreach ($value as $key => $a_value) {
$a_value = $this->getSimpleValue($a_value);
$key = $this->getMappedName($key);
$return[$key] = $this->nullPlaceholderCheck($a_value);
* Check whether the value is the null placeholder and return true null.
private function nullPlaceholderCheck($value)
if ($value === self::NULL_VALUE) {
* If there is an internal name mapping, use that.
private function getMappedName($key)
if (isset($this->internal_gapi_mappings) &&
isset($this->internal_gapi_mappings[$key])) {
$key = $this->internal_gapi_mappings[$key];
* Returns true only if the array is associative.
* @return bool True if the array is associative.
protected function isAssociativeArray($array)
$keys = array_keys($array);
foreach ($keys as $key) {
* Given a variable name, discover its type.
* @return object The object from the item.
private function createObjectFromName($name, $item)
* Verify if $obj is an array.
* @throws Google_Exception Thrown if $obj isn't an array.
* @param array $obj Items that should be validated.
* @param string $method Method expecting an array as an argument.
public function assertIsArray($obj, $method)
if ($obj && !is_array($obj)) {
throw new Google_Exception(
"Incorrect parameter type passed to $method(). Expected an array."
public function offsetExists($offset)
return isset($this->$offset) || isset($this->modelData[$offset]);
public function offsetGet($offset)
return isset($this->$offset) ?
public function offsetSet($offset, $value)
if (property_exists($this, $offset)) {
$this->modelData[$offset] = $value;
$this->processed[$offset] = true;
public function offsetUnset($offset)
unset($this->modelData[$offset]);
protected function keyType($key)
protected function dataType($key)
return $key . "DataType";
public function __isset($key)
return isset($this->modelData[$key]);
public function __unset($key)
unset($this->modelData[$key]);
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
