* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\Serializer\Encoder; use Symfony\Component\Serializer\Exception\RuntimeException; /** * Encoder delegating the decoding to a chain of encoders. * * @author Jordi Boggiano * @author Johannes M. Schmitt * @author Lukas Kahwe Smith * * @final */ class ChainEncoder implements ContextAwareEncoderInterface { protected $encoders = []; protected $encoderByFormat = []; public function __construct(array $encoders = []) { $this->encoders = $encoders; } /** * {@inheritdoc} */ final public function encode($data, string $format, array $context = []) { return $this->getEncoder($format, $context)->encode($data, $format, $context); } /** * {@inheritdoc} */ public function supportsEncoding(string $format, array $context = []): bool { try { $this->getEncoder($format, $context); } catch (RuntimeException $e) { return false; } return true; } /** * Checks whether the normalization is needed for the given format. */ public function needsNormalization(string $format, array $context = []): bool { $encoder = $this->getEncoder($format, $context); if (!$encoder instanceof NormalizationAwareInterface) { return true; } if ($encoder instanceof self) { return $encoder->needsNormalization($format, $context); } return false; } /** * Gets the encoder supporting the format. * * @throws RuntimeException if no encoder is found */ private function getEncoder(string $format, array $context): EncoderInterface { 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, $context)) { $this->encoderByFormat[$format] = $i; return $encoder; } } throw new RuntimeException(sprintf('No encoder found for format "%s".', $format)); } }