class ChainEncoder

Encoder delegating the decoding to a chain of encoders.

@author Jordi Boggiano <j.boggiano@seld.be> @author Johannes M. Schmitt <schmittjoh@gmail.com> @author Lukas Kahwe Smith <smith@pooteeweet.org>

Hierarchy

Expanded class hierarchy of ChainEncoder

1 file declares its use of ChainEncoder
Serializer.php in drupal/core/vendor/symfony/serializer/Symfony/Component/Serializer/Serializer.php

File

drupal/core/vendor/symfony/serializer/Symfony/Component/Serializer/Encoder/ChainEncoder.php, line 25

Namespace

Symfony\Component\Serializer\Encoder
View source
class ChainEncoder implements EncoderInterface {
  protected $encoders = array();
  protected $encoderByFormat = array();
  public function __construct(array $encoders = array()) {
    $this->encoders = $encoders;
  }

  /**
   * {@inheritdoc}
   */
  public final function encode($data, $format) {
    return $this
      ->getEncoder($format)
      ->encode($data, $format);
  }

  /**
   * {@inheritdoc}
   */
  public function supportsEncoding($format) {
    try {
      $this
        ->getEncoder($format);
    } catch (RuntimeException $e) {
      return false;
    }
    return true;
  }

  /**
   * Checks whether the normalization is needed for the given format.
   *
   * @param string $format
   *
   * @return Boolean
   */
  public function needsNormalization($format) {
    $encoder = $this
      ->getEncoder($format);
    if (!$encoder instanceof NormalizationAwareInterface) {
      return true;
    }
    if ($encoder instanceof self) {
      return $encoder
        ->needsNormalization($format);
    }
    return false;
  }

  /**
   * Gets the encoder supporting the format.
   *
   * @param string $format
   *
   * @return EncoderInterface
   * @throws RuntimeException if no encoder is found
   */
  private function getEncoder($format) {
    if (isset($this->encoderByFormat[$format]) && isset($this->encoders[$this->encoderByFormat[$format]])) {
      return $this->encoders[$this->encoderByFormat[$format]];
    }
    foreach ($this->encoders as $i => $encoder) {
      if ($encoder
        ->supportsEncoding($format)) {
        $this->encoderByFormat[$format] = $i;
        return $encoder;
      }
    }
    throw new RuntimeException(sprintf('No encoder found for format "%s".', $format));
  }

}

Members

Namesort descending Modifiers Type Description Overrides
ChainEncoder::$encoderByFormat protected property
ChainEncoder::$encoders protected property
ChainEncoder::encode final public function Encodes data into the given format Overrides EncoderInterface::encode
ChainEncoder::getEncoder private function Gets the encoder supporting the format.
ChainEncoder::needsNormalization public function Checks whether the normalization is needed for the given format.
ChainEncoder::supportsEncoding public function Checks whether the serializer can encode to given format Overrides EncoderInterface::supportsEncoding
ChainEncoder::__construct public function