*/ final class DeserializationGraphNavigator extends GraphNavigator implements GraphNavigatorInterface { /** * @var DeserializationVisitorInterface */ protected $visitor; /** * @var DeserializationContext */ protected $context; /** * @var ExpressionLanguageExclusionStrategy */ private $expressionExclusionStrategy; /** * @var EventDispatcherInterface */ private $dispatcher; /** * @var MetadataFactoryInterface */ private $metadataFactory; /** * @var HandlerRegistryInterface */ private $handlerRegistry; /** * @var ObjectConstructorInterface */ private $objectConstructor; /** * @var AccessorStrategyInterface */ private $accessor; public function __construct( MetadataFactoryInterface $metadataFactory, HandlerRegistryInterface $handlerRegistry, ObjectConstructorInterface $objectConstructor, AccessorStrategyInterface $accessor, ?EventDispatcherInterface $dispatcher = null, ?ExpressionEvaluatorInterface $expressionEvaluator = null ) { $this->dispatcher = $dispatcher ?: new EventDispatcher(); $this->metadataFactory = $metadataFactory; $this->handlerRegistry = $handlerRegistry; $this->objectConstructor = $objectConstructor; $this->accessor = $accessor; if ($expressionEvaluator) { $this->expressionExclusionStrategy = new ExpressionLanguageExclusionStrategy($expressionEvaluator); } } /** * Called for each node of the graph that is being traversed. * * @param mixed $data the data depends on the direction, and type of visitor * @param array|null $type array has the format ["name" => string, "params" => array] * * @return mixed the return value depends on the direction, and type of visitor */ public function accept($data, ?array $type = null) { // If the type was not given, we infer the most specific type from the // input data in serialization mode. if (null === $type) { throw new RuntimeException('The type must be given for all properties when deserializing.'); } // Sometimes data can convey null but is not of a null type. // Visitors can have the power to add this custom null evaluation if ($this->visitor instanceof NullAwareVisitorInterface && true === $this->visitor->isNull($data)) { $type = ['name' => 'NULL', 'params' => []]; } switch ($type['name']) { case 'NULL': return $this->visitor->visitNull($data, $type); case 'string': return $this->visitor->visitString($data, $type); case 'int': case 'integer': return $this->visitor->visitInteger($data, $type); case 'bool': case 'boolean': return $this->visitor->visitBoolean($data, $type); case 'double': case 'float': return $this->visitor->visitDouble($data, $type); case 'array': return $this->visitor->visitArray($data, $type); case 'resource': throw new RuntimeException('Resources are not supported in serialized data.'); default: $this->context->increaseDepth(); // Trigger pre-serialization callbacks, and listeners if they exist. // Dispatch pre-serialization event before handling data to have ability change type in listener if ($this->dispatcher->hasListeners('serializer.pre_deserialize', $type['name'], $this->format)) { $this->dispatcher->dispatch('serializer.pre_deserialize', $type['name'], $this->format, $event = new PreDeserializeEvent($this->context, $data, $type)); $type = $event->getType(); $data = $event->getData(); } // First, try whether a custom handler exists for the given type. This is done // before loading metadata because the type name might not be a class, but // could also simply be an artifical type. if (null !== $handler = $this->handlerRegistry->getHandler(GraphNavigatorInterface::DIRECTION_DESERIALIZATION, $type['name'], $this->format)) { $rs = \call_user_func($handler, $this->visitor, $data, $type, $this->context); $this->context->decreaseDepth(); return $rs; } /** @var ClassMetadata $metadata */ $metadata = $this->metadataFactory->getMetadataForClass($type['name']); if ($metadata->usingExpression && !$this->expressionExclusionStrategy) { throw new ExpressionLanguageRequiredException(sprintf('To use conditional exclude/expose in %s you must configure the expression language.', $metadata->name)); } if (!empty($metadata->discriminatorMap) && $type['name'] === $metadata->discriminatorBaseClass) { $metadata = $this->resolveMetadata($data, $metadata); } if (null !== $this->exclusionStrategy && $this->exclusionStrategy->shouldSkipClass($metadata, $this->context)) { $this->context->decreaseDepth(); return null; } $this->context->pushClassMetadata($metadata); $object = $this->objectConstructor->construct($this->visitor, $metadata, $data, $type, $this->context); $this->visitor->startVisitingObject($metadata, $object, $type); foreach ($metadata->propertyMetadata as $propertyMetadata) { if (null !== $this->exclusionStrategy && $this->exclusionStrategy->shouldSkipProperty($propertyMetadata, $this->context)) { continue; } if (null !== $this->expressionExclusionStrategy && $this->expressionExclusionStrategy->shouldSkipProperty($propertyMetadata, $this->context)) { continue; } if ($propertyMetadata->readOnly) { continue; } $this->context->pushPropertyMetadata($propertyMetadata); try { $v = $this->visitor->visitProperty($propertyMetadata, $data); $this->accessor->setValue($object, $v, $propertyMetadata, $this->context); } catch (NotAcceptableException $e) { } $this->context->popPropertyMetadata(); } $rs = $this->visitor->endVisitingObject($metadata, $data, $type); $this->afterVisitingObject($metadata, $rs, $type); return $rs; } } /** * @param mixed $data */ private function resolveMetadata($data, ClassMetadata $metadata): ?ClassMetadata { $typeValue = $this->visitor->visitDiscriminatorMapProperty($data, $metadata); if (!isset($metadata->discriminatorMap[$typeValue])) { throw new LogicException(sprintf( 'The type value "%s" does not exist in the discriminator map of class "%s". Available types: %s', $typeValue, $metadata->name, implode(', ', array_keys($metadata->discriminatorMap)) )); } return $this->metadataFactory->getMetadataForClass($metadata->discriminatorMap[$typeValue]); } private function afterVisitingObject(ClassMetadata $metadata, object $object, array $type): void { $this->context->decreaseDepth(); $this->context->popClassMetadata(); foreach ($metadata->postDeserializeMethods as $method) { $method->invoke($object); } if ($this->dispatcher->hasListeners('serializer.post_deserialize', $metadata->name, $this->format)) { $this->dispatcher->dispatch('serializer.post_deserialize', $metadata->name, $this->format, new ObjectEvent($this->context, $object, $type)); } } }