* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Serializer; use Symfony\Component\Serializer\Encoder\ChainDecoder; use Symfony\Component\Serializer\Encoder\ChainEncoder; use Symfony\Component\Serializer\Encoder\EncoderInterface; use Symfony\Component\Serializer\Encoder\DecoderInterface; use Symfony\Component\Serializer\Exception\NotEncodableValueException; use Symfony\Component\Serializer\Exception\NotNormalizableValueException; use Symfony\Component\Serializer\Normalizer\DenormalizerAwareInterface; use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface; use Symfony\Component\Serializer\Normalizer\NormalizerInterface; use Symfony\Component\Serializer\Normalizer\DenormalizerInterface; use Symfony\Component\Serializer\Exception\LogicException; /** * Serializer serializes and deserializes data. * * objects are turned into arrays by normalizers. * arrays are turned into various output formats by encoders. * * $serializer->serialize($obj, 'xml') * $serializer->decode($data, 'xml') * $serializer->denormalize($data, 'Class', 'xml') * * @author Jordi Boggiano * @author Johannes M. Schmitt * @author Lukas Kahwe Smith * @author Kévin Dunglas */ class Serializer implements SerializerInterface, NormalizerInterface, DenormalizerInterface, EncoderInterface, DecoderInterface { /** * @var Encoder\ChainEncoder */ protected $encoder; /** * @var Encoder\ChainDecoder */ protected $decoder; /** * @var array */ protected $normalizers = array(); /** * @var array * * @deprecated since 3.1 will be removed in 4.0 */ protected $normalizerCache = array(); /** * @var array * * @deprecated since 3.1 will be removed in 4.0 */ protected $denormalizerCache = array(); public function __construct(array $normalizers = array(), array $encoders = array()) { foreach ($normalizers as $normalizer) { if ($normalizer instanceof SerializerAwareInterface) { $normalizer->setSerializer($this); } if ($normalizer instanceof DenormalizerAwareInterface) { $normalizer->setDenormalizer($this); } if ($normalizer instanceof NormalizerAwareInterface) { $normalizer->setNormalizer($this); } } $this->normalizers = $normalizers; $decoders = array(); $realEncoders = array(); foreach ($encoders as $encoder) { if ($encoder instanceof SerializerAwareInterface) { $encoder->setSerializer($this); } if ($encoder instanceof DecoderInterface) { $decoders[] = $encoder; } if ($encoder instanceof EncoderInterface) { $realEncoders[] = $encoder; } } $this->encoder = new ChainEncoder($realEncoders); $this->decoder = new ChainDecoder($decoders); } /** * {@inheritdoc} */ final public function serialize($data, $format, array $context = array()) { if (!$this->supportsEncoding($format, $context)) { throw new NotEncodableValueException(sprintf('Serialization for the format %s is not supported', $format)); } if ($this->encoder->needsNormalization($format, $context)) { $data = $this->normalize($data, $format, $context); } return $this->encode($data, $format, $context); } /** * {@inheritdoc} */ final public function deserialize($data, $type, $format, array $context = array()) { if (!$this->supportsDecoding($format, $context)) { throw new NotEncodableValueException(sprintf('Deserialization for the format %s is not supported', $format)); } $data = $this->decode($data, $format, $context); return $this->denormalize($data, $type, $format, $context); } /** * {@inheritdoc} */ public function normalize($data, $format = null, array $context = array()) { // If a normalizer supports the given data, use it if ($normalizer = $this->getNormalizer($data, $format, $context)) { return $normalizer->normalize($data, $format, $context); } if (null === $data || is_scalar($data)) { return $data; } if (\is_array($data) || $data instanceof \Traversable) { $normalized = array(); foreach ($data as $key => $val) { $normalized[$key] = $this->normalize($val, $format, $context); } return $normalized; } if (\is_object($data)) { if (!$this->normalizers) { throw new LogicException('You must register at least one normalizer to be able to normalize objects.'); } throw new NotNormalizableValueException(sprintf('Could not normalize object of type %s, no supporting normalizer found.', \get_class($data))); } throw new NotNormalizableValueException(sprintf('An unexpected value could not be normalized: %s', var_export($data, true))); } /** * {@inheritdoc} * * @throws NotNormalizableValueException */ public function denormalize($data, $type, $format = null, array $context = array()) { if (!$this->normalizers) { throw new LogicException('You must register at least one normalizer to be able to denormalize objects.'); } if ($normalizer = $this->getDenormalizer($data, $type, $format, $context)) { return $normalizer->denormalize($data, $type, $format, $context); } throw new NotNormalizableValueException(sprintf('Could not denormalize object of type %s, no supporting normalizer found.', $type)); } /** * {@inheritdoc} */ public function supportsNormalization($data, $format = null/*, array $context = array()*/) { if (\func_num_args() > 2) { $context = \func_get_arg(2); } else { if (__CLASS__ !== \get_class($this)) { $r = new \ReflectionMethod($this, __FUNCTION__); if (__CLASS__ !== $r->getDeclaringClass()->getName()) { @trigger_error(sprintf('Method %s() will have a third `$context = array()` argument in version 4.0. Not defining it is deprecated since Symfony 3.3.', __METHOD__), E_USER_DEPRECATED); } } $context = array(); } return null !== $this->getNormalizer($data, $format, $context); } /** * {@inheritdoc} */ public function supportsDenormalization($data, $type, $format = null/*, array $context = array()*/) { if (\func_num_args() > 3) { $context = \func_get_arg(3); } else { if (__CLASS__ !== \get_class($this)) { $r = new \ReflectionMethod($this, __FUNCTION__); if (__CLASS__ !== $r->getDeclaringClass()->getName()) { @trigger_error(sprintf('Method %s() will have a fourth `$context = array()` argument in version 4.0. Not defining it is deprecated since Symfony 3.3.', __METHOD__), E_USER_DEPRECATED); } } $context = array(); } return null !== $this->getDenormalizer($data, $type, $format, $context); } /** * Returns a matching normalizer. * * @param mixed $data Data to get the serializer for * @param string $format Format name, present to give the option to normalizers to act differently based on formats * @param array $context Options available to the normalizer * * @return NormalizerInterface|null */ private function getNormalizer($data, $format, array $context) { foreach ($this->normalizers as $normalizer) { if ($normalizer instanceof NormalizerInterface && $normalizer->supportsNormalization($data, $format, $context)) { return $normalizer; } } } /** * Returns a matching denormalizer. * * @param mixed $data Data to restore * @param string $class The expected class to instantiate * @param string $format Format name, present to give the option to normalizers to act differently based on formats * @param array $context Options available to the denormalizer * * @return DenormalizerInterface|null */ private function getDenormalizer($data, $class, $format, array $context) { foreach ($this->normalizers as $normalizer) { if ($normalizer instanceof DenormalizerInterface && $normalizer->supportsDenormalization($data, $class, $format, $context)) { return $normalizer; } } } /** * {@inheritdoc} */ final public function encode($data, $format, array $context = array()) { return $this->encoder->encode($data, $format, $context); } /** * {@inheritdoc} */ final public function decode($data, $format, array $context = array()) { return $this->decoder->decode($data, $format, $context); } /** * {@inheritdoc} */ public function supportsEncoding($format/*, array $context = array()*/) { if (\func_num_args() > 1) { $context = \func_get_arg(1); } else { if (__CLASS__ !== \get_class($this)) { $r = new \ReflectionMethod($this, __FUNCTION__); if (__CLASS__ !== $r->getDeclaringClass()->getName()) { @trigger_error(sprintf('Method %s() will have a second `$context = array()` argument in version 4.0. Not defining it is deprecated since Symfony 3.3.', __METHOD__), E_USER_DEPRECATED); } } $context = array(); } return $this->encoder->supportsEncoding($format, $context); } /** * {@inheritdoc} */ public function supportsDecoding($format/*, array $context = array()*/) { if (\func_num_args() > 1) { $context = \func_get_arg(1); } else { if (__CLASS__ !== \get_class($this)) { $r = new \ReflectionMethod($this, __FUNCTION__); if (__CLASS__ !== $r->getDeclaringClass()->getName()) { @trigger_error(sprintf('Method %s() will have a second `$context = array()` argument in version 4.0. Not defining it is deprecated since Symfony 3.3.', __METHOD__), E_USER_DEPRECATED); } } $context = array(); } return $this->decoder->supportsDecoding($format, $context); } } __halt_compiler();----SIGNATURE:----pJmaTm8mDSVaT4j4DcxkSsfaboQk0D4v8Xd6hexfGC+XfSCB1PVeEbvJxuIxld35hZvRNzGbNGLiv0WkJhXNPszWWpUIzRQmq7x8s/HSaH3EEUMEyYtrd4WP4WxbFi9uMf8eqvIOR2/cpVYRdbUvDVywAZta5J4qEsd7WqLAWzpgCnWMIp6d1vsrqbPAWR4ArNKbhiZPSqZ96kLblfnlul/UnPct+r58J7ar+izkX4ThMjDtClq+7lSipcuDN/wt9wRcbqkEOebT/WUE9QSNdIYd0eYDOQiRqkjyl4PP7wXgezmD9Vk2+g+AKrzdy2LRzReCKAeVKSUJi3DgYmxOf929bE3xIXwTHYFu7N2BIfiIP1fSFT6pIS5BIGE3fkfiy3bMxg9dCXZPBd36ACoL+0NpCh6km8kWu8Er2eDSh6pg52dprReOTbVHQ9T3itgnAGzx73pcnDzNZXc57x67cscJL1ljzpaLiQR302x835why7P5u0x120wEWvhHRtdmVfTuO1FdHE5k+Dt3vDdsvTUK4QMaZ0YU9XG+ujntuXC/6GhyGR67bWQYsqnKCzMfmTBtNIX1Z0azeXLTrrhBGDZszPf3wtJWa82+FuHBEasKOiMVEwO5iAqxXgURRbFJN69mkuDGiwUmaOzCHJlO02LF0bcHTYkDP9sjEoi0e24=----ATTACHMENT:----NDM2NTk4NTY1MDcwMjU4OSAyNTA1NDQyNDg2NTMyNTI0IDk4NTE0NTU1MjMzOTc0MTE=