/**
* Combines the same functionality that {@link createFromArray()} and
* {@link updateFromArray} have.
*
* @param epObject $o
* @param array $array
* @param boolean $dispatch_event whether to dispatch events
* @param boolean $clean
* @return null|epObject|string (error message if string)
* @throws epExceptionManagerBase
*/
protected function &_fromArray(&$o, $array, $dispatch_event, $clean = true)
{
// get class from object
$class = $o->epGetClass();
// copy array values to object
foreach ($array as $var => $val) {
// skip oid
if ($var == 'oid') {
$o->epSetObjectId($val);
continue;
}
// check if var exists in class
if (!$o->epIsVar($var)) {
// unrecognized var
throw new epExceptionManagerBase('Variable [' . $var . '] does not exist in class [' . $class . ']');
return self::$null;
}
//
// a primitive var?
//
if ($o->epIsPrimitive($var)) {
// primitive must be a scalar
if (!is_scalar($val)) {
throw new epExceptionManagerBase('Value is not scalar for primitive var [' . $class . '::' . $var . ']');
return self::$null;
}
// assign value to var in object
$o[$var] = $val;
continue;
}
//
// a relationship var
//
// get class of var
$class = $o->epGetClassOfVar($var);
//
// a single-valued var
//
if ($o->epIsSingle($var)) {
// recursion if value is an array
if (is_array($val)) {
// recursion: object to var in object
$o->epSet($var, $this->createFromArray($class, $val, $dispatch_event, $clean));
continue;
}
// if value is int, it might be an oid of an existing object
if (is_integer($val) || ctype_digit($val)) {
// get the corresponding object
if ($sub =& $this->get($class, $val)) {
// yep, it exists
$o->epSet($var, $sub);
continue;
}
}
// if it is an object, it might be an existing object
if ($val instanceof epObject) {
$o->epSet($var, $val);
continue;
}
throw new epExceptionManagerBase('Value is not array or object id for relationship var [' . $class . '::' . $var . ']');
continue;
}
//
// a many-valued var
//
// value should be either an integer (oid) or an array.
$vals = is_array($val) ? $val : array($val);
// check if value is multiple. arrayize it if not.
$vals = isset($val[0]) ? $val : array($val);
// create objects for many-valued field
$os = array();
foreach ($vals as $val) {
// recursion: object to var in object
if (is_array($val)) {
$os[] =& $this->createFromArray($class, $val, $dispatch_event, $clean);
continue;
}
// if value is int, it might be an oid of an existing object
if (is_integer($val) || ctype_digit($val)) {
if ($sub =& $this->get($class, $val)) {
// yep, it exists
$os[] =& $sub;
continue;
}
}
// if it is an object, it might be an existing object
if ($val instanceof epObject) {
$os[] =& $val;
continue;
}
throw new epExceptionManagerBase('Value is not array or object id for relationship var [' . $class . '::' . $var . ']');
continue;
}
$o->epSet($var, $os);
}
return $o;
}