Maslosoft Mangan API
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 <?php
/**
* This software package is licensed under AGPL or Commercial license.
*
* @package maslosoft/mangan
* @licence AGPL or Commercial
* @copyright Copyright (c) Piotr Masełkowski <pmaselkowski@gmail.com>
* @copyright Copyright (c) Maslosoft
* @copyright Copyright (c) Others as mentioned in code
* @link https://maslosoft.com/mangan/
*/
namespace Maslosoft\Mangan\Decorators;
use Maslosoft\Addendum\Interfaces\AnnotatedInterface;
use Maslosoft\Mangan\Helpers\DbRefManager;
use Maslosoft\Mangan\Interfaces\Decorators\Property\DecoratorInterface;
use Maslosoft\Mangan\Interfaces\Transformators\TransformatorInterface;
use Maslosoft\Mangan\Model\DbRef;
/**
* EmbeddedArrayDecorator
*
* @author Piotr Maselkowski <pmaselkowski at gmail.com>
*/
class EmbeddedArrayDecorator extends EmbeddedDecorator implements DecoratorInterface
{
public function read($model, $name, &$dbValue, $transformatorClass = TransformatorInterface::class)
{
if (is_array($dbValue))
{
$docs = [];
foreach ($dbValue as $key => $data)
{
static::ensureClass($model, $name, $data);
// Set ensured class to $dbValue
$instance = $this->_getInstance($model->$name, $dbValue, $data);
$embedded = $transformatorClass::toModel($data, $instance, $instance);
// Field was transformed from DB Ref
$embedded = DbRefManager::maybeCreateInstanceFrom($embedded);
$docs[] = $embedded;
}
$model->$name = $docs;
}
else
{
$model->$name = $dbValue;
}
}
public function write($model, $name, &$dbValue, $transformatorClass = TransformatorInterface::class)
{
if (is_array($model->$name))
{
$dbValue[$name] = [];
$key = 0;
foreach ($model->$name as $key => $document)
{
$data = $transformatorClass::fromModel($document);
$dbValue[$name][] = $data;
}
}
else
{
$dbValue[$name] = $model->$name;
}
}
/**
* TODO: This relies on _id
* @param AnnotatedInterface[] $instances
* @param mixed[] $dbValue
* @param mixed[] $data
* @return AnnotatedInterface|null
*/
private function _getInstance($instances, $dbValue, $data)
{
if (!count($instances))
{
return null;
}
$map = [];
/**
* TODO Workaround for manganel not having _id
*/
if (!isset($data['_id']) && isset($data['id']))
{
$data['_id'] = $data['id'];
}
foreach ($dbValue as $val)
{
/**
* TODO Workaround for manganel not having _id
*/
if (!isset($val['_id']) && isset($val['id']))
{
$val['_id'] = $val['id'];
}
assert(array_key_exists('_id', $val), sprintf('_id not defined for %s', $val['_class']));
$id = (string) $val['_id'];
$map[$id] = true;
}
foreach ($instances as $instance)
{
$id = (string) $instance->_id;
if (isset($map[$id]) && $data['_id'] == $id && $instance instanceof $data['_class'])
{
return $instance;
}
}
return null;
}
}
API documentation generated by ApiGen