vendor/symfony/src/Symfony/Component/Serializer/SerializerInterface.php
changeset 0 7f95f8617b0b
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/vendor/symfony/src/Symfony/Component/Serializer/SerializerInterface.php	Sat Sep 24 15:40:41 2011 +0200
@@ -0,0 +1,119 @@
+<?php
+
+namespace Symfony\Component\Serializer;
+
+use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+use Symfony\Component\Serializer\Encoder\EncoderInterface;
+use Symfony\Component\Serializer\Encoder\DecoderInterface;
+use Symfony\Component\Serializer\Encoder\NormalizationAwareInterface;
+
+/*
+ * This file is part of the Symfony framework.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+/**
+ * Defines the interface of the Serializer
+ *
+ * @author Jordi Boggiano <j.boggiano@seld.be>
+ */
+interface SerializerInterface
+{
+    /**
+     * Serializes data in the appropriate format
+     *
+     * @param mixed $data any data
+     * @param string $format format name
+     * @return string
+     */
+    function serialize($data, $format);
+
+    /**
+     * Deserializes data into the given type.
+     *
+     * @param mixed $data
+     * @param string $type
+     * @param string $format
+     */
+    function deserialize($data, $type, $format);
+
+    /**
+     * Normalizes any data into a set of arrays/scalars
+     *
+     * @param mixed $data data to normalize
+     * @param string $format format name, present to give the option to normalizers to act differently based on formats
+     * @return array|scalar
+     */
+    function normalize($data, $format = null);
+
+    /**
+     * Denormalizes data into the given type.
+     *
+     * @param mixed $data
+     * @param string $type
+     * @param string $format
+     * @return mixed
+     */
+    function denormalize($data, $type, $format = null);
+
+    /**
+     * Encodes data into the given format
+     *
+     * @param mixed $data data to encode
+     * @param string $format format name
+     * @return array|scalar
+     */
+    function encode($data, $format);
+
+    /**
+     * Decodes a string from the given format back into PHP data
+     *
+     * @param string $data data to decode
+     * @param string $format format name
+     * @return mixed
+     */
+    function decode($data, $format);
+
+    /**
+     * Checks whether the serializer can serialize to given format
+     *
+     * @param string $format format name
+     * @return Boolean
+     */
+    function supportsSerialization($format);
+
+    /**
+     * Checks whether the serializer can deserialize from given format
+     *
+     * @param string $format format name
+     * @return Boolean
+     */
+    function supportsDeserialization($format);
+
+    /**
+     * Checks whether the serializer can encode to given format
+     *
+     * @param string $format format name
+     * @return Boolean
+     */
+    function supportsEncoding($format);
+
+    /**
+     * Checks whether the serializer can decode from given format
+     *
+     * @param string $format format name
+     * @return Boolean
+     */
+    function supportsDecoding($format);
+
+    /**
+     * Get the encoder for the given format
+     *
+     * @return EncoderInterface
+     */
+    function getEncoder($format);
+}