split off an EncoderInterface and NormalizerInterface from Serializer…

…Interface
symfony · fabpot · Dec 14, 2011 · Nov 1, 2011 · Nov 8, 2011 · Nov 8, 2011
commit b0daf3516f659b939728d3b289b46b2085690f96
diff --git a/src/Symfony/Component/Serializer/EncoderInterface.php b/src/Symfony/Component/Serializer/EncoderInterface.php
@@ -0,0 +1,63 @@
+<?php
+
+namespace Symfony\Component\Serializer;
+
+use Symfony\Component\Serializer\Encoder\EncoderInterface;
+
+/*
+ * 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 Encoder
+ *
+ * @author Jordi Boggiano <j.boggiano@seld.be>
+ */
+interface EncoderInterface
+{
+    /**
+     * 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 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);
+}
diff --git a/src/Symfony/Component/Serializer/NormalizerInterface.php b/src/Symfony/Component/Serializer/NormalizerInterface.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace Symfony\Component\Serializer;
+
+use Symfony\Component\Serializer\Encoder\EncoderInterface;
+
+/*
+ * 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 Normalizer
+ *
+ * @author Jordi Boggiano <j.boggiano@seld.be>
+ */
+interface NormalizerInterface
+{
+    /**
+     * 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);
+}
diff --git a/src/Symfony/Component/Serializer/Serializer.php b/src/Symfony/Component/Serializer/Serializer.php
@@ -32,7 +32,7 @@
  * @author Johannes M. Schmitt <schmittjoh@gmail.com>
  * @author Lukas Kahwe Smith <smith@pooteeweet.org>
  */
-class Serializer implements SerializerInterface
+class Serializer implements SerializerInterface, NormalizerInterface, EncoderInterface
 {
     protected $normalizers = array();
     protected $encoders = array();

diff --git a/src/Symfony/Component/Serializer/SerializerInterface.php b/src/Symfony/Component/Serializer/SerializerInterface.php
@@ -38,43 +38,6 @@ function serialize($data, $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
      *
@@ -90,27 +53,4 @@ function supportsSerialization($format);
      * @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);
 }