/**
* Converts a response from the Shippo API to the corresponding PHP object.
*
* @param array $resp The response from the Shippo API.
* @param string $apiKey
* @return Shippo_Object|array
*/
public static function convertToShippoObject($resp, $apiKey)
{
// TODO: Have API Return Object: Type in order to cast properly
$types = array('QUOTE' => 'Shippo_Address');
if (self::isList($resp)) {
$mapped = array();
foreach ($resp as $i) {
array_push($mapped, self::convertToShippoObject($i, $apiKey));
}
return $mapped;
} else {
if (is_array($resp)) {
if (isset($resp['object_purpose']) && is_string($resp['object_purpose']) && isset($types[$resp['object_purpose']])) {
$class = $types[$resp['object_purpose']];
} else {
$class = 'Shippo_Object';
}
return Shippo_Object::scopedConstructFrom($class, $resp, $apiKey);
} else {
return $resp;
}
}
}
/**
* Refreshes this object using the provided values.
*
* @param array $values
* @param string $apiKey
* @param boolean $partial Defaults to false.
*/
public function refreshFrom($values, $apiKey, $partial = false)
{
$this->_apiKey = $apiKey;
// Wipe old state before setting new. This is useful for e.g. updating a
// customer, where there is no persistent card parameter. Mark those values
// which don't persist as transient
if ($partial) {
$removed = new Shippo_Util_Set();
} else {
$removed = array_diff(array_keys($this->_values), array_keys($values));
}
foreach ($removed as $k) {
if (self::$permanentAttributes->includes($k)) {
continue;
}
unset($this->{$k});
}
foreach ($values as $k => $v) {
if (self::$permanentAttributes->includes($k) && isset($this[$k])) {
continue;
}
if (self::$nestedUpdatableAttributes->includes($k) && is_array($v)) {
$this->_values[$k] = Shippo_Object::scopedConstructFrom('Shippo_AttachedObject', $v, $apiKey);
} else {
$this->_values[$k] = Shippo_Util::convertToShippoObject($v, $apiKey);
}
$this->_transientValues->discard($k);
$this->_unsavedValues->discard($k);
}
}