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 <?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\Addendum\Utilities\ClassChecker;
use Maslosoft\Mangan\Events\ClassNotFound;
use Maslosoft\Mangan\Events\Event;
use Maslosoft\Mangan\Exceptions\ManganException;
use Maslosoft\Mangan\Helpers\DbRefManager;
use Maslosoft\Mangan\Helpers\NotFoundResolver;
use Maslosoft\Mangan\Interfaces\Decorators\Property\DecoratorInterface;
use Maslosoft\Mangan\Interfaces\Transformators\TransformatorInterface;
use Maslosoft\Mangan\Meta\DocumentPropertyMeta;
use Maslosoft\Mangan\Meta\ManganMeta;
/**
* EmbeddedDecorator
*
* @author Piotr Maselkowski <pmaselkowski at gmail.com>
*/
class EmbeddedDecorator implements DecoratorInterface
{
public function read($model, $name, &$dbValue, $transformatorClass = TransformatorInterface::class)
{
if (is_object($dbValue) && $dbValue instanceof AnnotatedInterface)
{
$model->$name = $dbValue;
return;
}
static::ensureClass($model, $name, $dbValue);
$instance = null;
if ($model->$name instanceof $dbValue['_class'])
{
$instance = $model->$name;
}
$embedded = $transformatorClass::toModel($dbValue, $instance, $instance);
// Field was transformed from DB Ref
$embedded = DbRefManager::maybeCreateInstanceFrom($embedded);
$model->$name = $embedded;
}
public function write($model, $name, &$dbValue, $transformatorClass = TransformatorInterface::class)
{
if (null === $model->$name)
{
$className = static::getClassName($model, $name);
if (!is_string($className))
{
return null;
}
$dbValue[$name] = $transformatorClass::fromModel(new $className);
return;
}
$dbValue[$name] = $transformatorClass::fromModel($model->$name);
}
public static function ensureClass($model, $name, &$dbValue)
{
if (!is_array($dbValue) || !array_key_exists('_class', $dbValue) || empty($dbValue['_class']))
{
$class = static::getClassName($model, $name);
}
else
{
$class = $dbValue['_class'];
}
if (!ClassChecker::exists($class))
{
$event = new ClassNotFound($model);
$event->notFound = $class;
if (Event::hasHandler($model, NotFoundResolver::EventClassNotFound) && Event::handled($model, NotFoundResolver::EventClassNotFound, $event))
{
$class = $event->replacement;
}
else
{
throw new ManganException(sprintf("Embedded model class `%s` not found in model `%s` field `%s`", $class, get_class($model), $name));
}
}
$dbValue['_class'] = $class;
}
protected static function getClassName($model, $name)
{
$fieldMeta = ManganMeta::create($model)->$name;
/* @var $fieldMeta DocumentPropertyMeta */
return $fieldMeta->embedded->class;
}
}
API documentation generated by ApiGen