* * 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:----dveLpcCSD+kQoayz1GDsdo+aR3v6OfyQMoj/IerbLV5kkPRN7zSHxJwKGRAJSphuFot5Z4IHmeEXPInKWVfh4oxF3c3hF9G/bhRIOZlpdmHhHz8c6aVpu//htLRrBPgY5BsF3ekLpg+4uD7pH6Qwi+LTZ0vJCu8y3knaJteZLX1DCfRgTChQw9jzk4fO9CWG9m+y5koqnvBgqn/c3abE8e9onFaNW04B2tDH9vUXEcKkI1cPqVH3huHH6sZyY3E+G1nn7LJdfoQQqXZhvlb8cnGJgIJ0A6zy0JbuE9cylfFK6zm0FNNnkLKz+8G/Py+GpdCosrcaXWzTBPUzwIJqNMyKvq8RevOxkidf1zvfokGhJ2I/dl8Y56NmfCA1rhojptga6vgDxrqbpjV61XaeGtxNDqODezTjlCIGD4vSC7aKRITaV09Sy5tVApm4NQMCrlojKx1h2g08pFMX5ips/gK/6mfYJXgCgimxjOrrU1yh6uTMnafGl9+N4iG7Xd0D1F3YTeSvT3oBIXsuSnD4TdR38FMMLeWRopZxYW/y/KlAQ3WdD9AOkinJBx1zUEgFhthctpYLU8Zq96uFDbZScubaVYYZeLrhsBTUARoewOIuLFmePCctXXwYjpRwtaBE5cQqm5X4DP2MK0unH3t0iGVpko1ow6DaFX5pGpGDKSE=----ATTACHMENT:----NzkxMDcxOTYwMTUzMjc4NyAzMTQxNDg2MjQ3NjAyMDAzIDM0MjI0NTU1NjcwMDE1Mjc=