diff -r 000000000000 -r 7f95f8617b0b vendor/symfony/src/Symfony/Component/Serializer/Serializer.php --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/vendor/symfony/src/Symfony/Component/Serializer/Serializer.php Sat Sep 24 15:40:41 2011 +0200 @@ -0,0 +1,252 @@ + + * + * This source file is subject to the MIT license that is bundled + * with this source code in the file LICENSE. + */ + +/** + * 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 + */ +class Serializer implements SerializerInterface +{ + protected $normalizers = array(); + protected $encoders = array(); + protected $normalizerCache = array(); + protected $denormalizerCache = array(); + + public function __construct(array $normalizers = array(), array $encoders = array()) + { + foreach ($normalizers as $normalizer) { + if ($normalizer instanceof SerializerAwareInterface) { + $normalizer->setSerializer($this); + } + } + $this->normalizers = $normalizers; + + foreach ($encoders as $encoder) { + if ($encoder instanceof SerializerAwareInterface) { + $encoder->setSerializer($this); + } + } + $this->encoders = $encoders; + } + + /** + * {@inheritdoc} + */ + public final function serialize($data, $format) + { + if (!$this->supportsSerialization($format)) { + throw new UnexpectedValueException('Serialization for the format '.$format.' is not supported'); + } + + $encoder = $this->getEncoder($format); + + if (!$encoder instanceof NormalizationAwareInterface) { + $data = $this->normalize($data, $format); + } + + return $this->encode($data, $format); + } + + /** + * {@inheritdoc} + */ + public final function deserialize($data, $type, $format) + { + if (!$this->supportsDeserialization($format)) { + throw new UnexpectedValueException('Deserialization for the format '.$format.' is not supported'); + } + + $data = $this->decode($data, $format); + + return $this->denormalize($data, $type, $format); + } + + /** + * {@inheritdoc} + */ + public function normalize($data, $format = null) + { + if (null === $data || is_scalar($data)) { + return $data; + } + if ($data instanceof \Traversable) { + $normalized = array(); + foreach ($data as $key => $val) { + $normalized[$key] = $this->normalize($val, $format); + } + + return $normalized; + } + if (is_object($data)) { + return $this->normalizeObject($data, $format); + } + if (is_array($data)) { + foreach ($data as $key => $val) { + $data[$key] = $this->normalize($val, $format); + } + + return $data; + } + throw new UnexpectedValueException('An unexpected value could not be normalized: '.var_export($data, true)); + } + + /** + * {@inheritdoc} + */ + public function denormalize($data, $type, $format = null) + { + return $this->denormalizeObject($data, $type, $format); + } + + /** + * {@inheritdoc} + */ + public final function encode($data, $format) + { + return $this->getEncoder($format)->encode($data, $format); + } + + /** + * {@inheritdoc} + */ + public final function decode($data, $format) + { + return $this->getEncoder($format)->decode($data, $format); + } + + /** + * Normalizes an object into a set of arrays/scalars + * + * @param object $object object to normalize + * @param string $format format name, present to give the option to normalizers to act differently based on formats + * @return array|scalar + */ + private function normalizeObject($object, $format = null) + { + if (!$this->normalizers) { + throw new LogicException('You must register at least one normalizer to be able to normalize objects.'); + } + $class = get_class($object); + if (isset($this->normalizerCache[$class][$format])) { + return $this->normalizerCache[$class][$format]->normalize($object, $format); + } + foreach ($this->normalizers as $normalizer) { + if ($normalizer->supportsNormalization($object, $class, $format)) { + $this->normalizerCache[$class][$format] = $normalizer; + + return $normalizer->normalize($object, $format); + } + } + throw new UnexpectedValueException('Could not normalize object of type '.$class.', no supporting normalizer found.'); + } + + /** + * Denormalizes data back into an object of the given class + * + * @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 + * @return object + */ + private function denormalizeObject($data, $class, $format = null) + { + if (!$this->normalizers) { + throw new LogicException('You must register at least one normalizer to be able to denormalize objects.'); + } + if (isset($this->denormalizerCache[$class][$format])) { + return $this->denormalizerCache[$class][$format]->denormalize($data, $class, $format); + } + foreach ($this->normalizers as $normalizer) { + if ($normalizer->supportsDenormalization($data, $class, $format)) { + $this->denormalizerCache[$class][$format] = $normalizer; + + return $normalizer->denormalize($data, $class, $format); + } + } + throw new UnexpectedValueException('Could not denormalize object of type '.$class.', no supporting normalizer found.'); + } + + /** + * {@inheritdoc} + */ + public function supportsSerialization($format) + { + return $this->supportsEncoding($format); + } + + /** + * {@inheritdoc} + */ + public function supportsDeserialization($format) + { + return $this->supportsDecoding($format); + } + + /** + * {@inheritdoc} + */ + public function supportsEncoding($format) + { + try { + $encoder = $this->getEncoder($format); + } catch (\RuntimeException $e) { + return false; + } + + return $encoder instanceof EncoderInterface; + } + + /** + * {@inheritdoc} + */ + public function supportsDecoding($format) + { + try { + $encoder = $this->getEncoder($format); + } catch (\RuntimeException $e) { + return false; + } + + return $encoder instanceof DecoderInterface; + } + + /** + * {@inheritdoc} + */ + public function getEncoder($format) + { + if (!isset($this->encoders[$format])) { + throw new RuntimeException(sprintf('No encoder found for format "%s".', $format)); + } + + return $this->encoders[$format]; + } +}