1#@!#!123s

: / usr / local / psa / admin / plib / modules / rest-api / vendor / jms / serializer / src /
Filename : SerializerBuilder.php
back
<?php

declare (strict_types=1);
namespace PleskRestApi\JMS\Serializer;

use PleskRestApi\Doctrine\Common\Annotations\AnnotationReader;
use PleskRestApi\Doctrine\Common\Annotations\CachedReader;
use PleskRestApi\Doctrine\Common\Annotations\PsrCachedReader;
use PleskRestApi\Doctrine\Common\Annotations\Reader;
use PleskRestApi\Doctrine\Common\Cache\FilesystemCache;
use PleskRestApi\JMS\Serializer\Accessor\AccessorStrategyInterface;
use PleskRestApi\JMS\Serializer\Accessor\DefaultAccessorStrategy;
use PleskRestApi\JMS\Serializer\Builder\DefaultDriverFactory;
use PleskRestApi\JMS\Serializer\Builder\DocBlockDriverFactory;
use PleskRestApi\JMS\Serializer\Builder\DriverFactoryInterface;
use PleskRestApi\JMS\Serializer\Construction\ObjectConstructorInterface;
use PleskRestApi\JMS\Serializer\Construction\UnserializeObjectConstructor;
use PleskRestApi\JMS\Serializer\ContextFactory\CallableDeserializationContextFactory;
use PleskRestApi\JMS\Serializer\ContextFactory\CallableSerializationContextFactory;
use PleskRestApi\JMS\Serializer\ContextFactory\DeserializationContextFactoryInterface;
use PleskRestApi\JMS\Serializer\ContextFactory\SerializationContextFactoryInterface;
use PleskRestApi\JMS\Serializer\EventDispatcher\EventDispatcher;
use PleskRestApi\JMS\Serializer\EventDispatcher\EventDispatcherInterface;
use PleskRestApi\JMS\Serializer\EventDispatcher\Subscriber\DoctrineProxySubscriber;
use PleskRestApi\JMS\Serializer\EventDispatcher\Subscriber\EnumSubscriber;
use PleskRestApi\JMS\Serializer\Exception\InvalidArgumentException;
use PleskRestApi\JMS\Serializer\Exception\RuntimeException;
use PleskRestApi\JMS\Serializer\Expression\CompilableExpressionEvaluatorInterface;
use PleskRestApi\JMS\Serializer\Expression\ExpressionEvaluatorInterface;
use PleskRestApi\JMS\Serializer\GraphNavigator\Factory\DeserializationGraphNavigatorFactory;
use PleskRestApi\JMS\Serializer\GraphNavigator\Factory\GraphNavigatorFactoryInterface;
use PleskRestApi\JMS\Serializer\GraphNavigator\Factory\SerializationGraphNavigatorFactory;
use PleskRestApi\JMS\Serializer\Handler\ArrayCollectionHandler;
use PleskRestApi\JMS\Serializer\Handler\DateHandler;
use PleskRestApi\JMS\Serializer\Handler\EnumHandler;
use PleskRestApi\JMS\Serializer\Handler\HandlerRegistry;
use PleskRestApi\JMS\Serializer\Handler\HandlerRegistryInterface;
use PleskRestApi\JMS\Serializer\Handler\IteratorHandler;
use PleskRestApi\JMS\Serializer\Handler\StdClassHandler;
use PleskRestApi\JMS\Serializer\Handler\UnionHandler;
use PleskRestApi\JMS\Serializer\Naming\CamelCaseNamingStrategy;
use PleskRestApi\JMS\Serializer\Naming\PropertyNamingStrategyInterface;
use PleskRestApi\JMS\Serializer\Naming\SerializedNameAnnotationStrategy;
use PleskRestApi\JMS\Serializer\Type\Parser;
use PleskRestApi\JMS\Serializer\Type\ParserInterface;
use PleskRestApi\JMS\Serializer\Visitor\Factory\DeserializationVisitorFactory;
use PleskRestApi\JMS\Serializer\Visitor\Factory\JsonDeserializationVisitorFactory;
use PleskRestApi\JMS\Serializer\Visitor\Factory\JsonSerializationVisitorFactory;
use PleskRestApi\JMS\Serializer\Visitor\Factory\SerializationVisitorFactory;
use PleskRestApi\JMS\Serializer\Visitor\Factory\XmlDeserializationVisitorFactory;
use PleskRestApi\JMS\Serializer\Visitor\Factory\XmlSerializationVisitorFactory;
use PleskRestApi\Metadata\Cache\CacheInterface;
use PleskRestApi\Metadata\Cache\FileCache;
use PleskRestApi\Metadata\MetadataFactory;
use PleskRestApi\Metadata\MetadataFactoryInterface;
use PleskRestApi\Symfony\Component\Cache\Adapter\FilesystemAdapter;
/**
 * Builder for serializer instances.
 *
 * This object makes serializer construction a breeze for projects that do not use
 * any special dependency injection container.
 *
 * @author Johannes M. Schmitt <schmittjoh@gmail.com>
 */
final class SerializerBuilder
{
    /**
     * @var string[]
     */
    private $metadataDirs = [];
    /**
     * @var HandlerRegistryInterface
     */
    private $handlerRegistry;
    /**
     * @var bool
     */
    private $handlersConfigured = \false;
    /**
     * @var EventDispatcherInterface
     */
    private $eventDispatcher;
    /**
     * @var bool
     */
    private $enableEnumSupport = \false;
    /**
     * @var bool
     */
    private $listenersConfigured = \false;
    /**
     * @var ObjectConstructorInterface
     */
    private $objectConstructor;
    /**
     * @var SerializationVisitorFactory[]
     */
    private $serializationVisitors;
    /**
     * @var DeserializationVisitorFactory[]
     */
    private $deserializationVisitors;
    /**
     * @var bool
     */
    private $deserializationVisitorsAdded = \false;
    /**
     * @var bool
     */
    private $serializationVisitorsAdded = \false;
    /**
     * @var PropertyNamingStrategyInterface
     */
    private $propertyNamingStrategy;
    /**
     * @var bool
     */
    private $debug = \false;
    /**
     * @var string
     */
    private $cacheDir;
    /**
     * @var Reader
     */
    private $annotationReader;
    /**
     * @var bool
     */
    private $includeInterfaceMetadata = \false;
    /**
     * @var DriverFactoryInterface
     */
    private $driverFactory;
    /**
     * @var SerializationContextFactoryInterface
     */
    private $serializationContextFactory;
    /**
     * @var DeserializationContextFactoryInterface
     */
    private $deserializationContextFactory;
    /**
     * @var ParserInterface
     */
    private $typeParser;
    /**
     * @var ExpressionEvaluatorInterface
     */
    private $expressionEvaluator;
    /**
     * @var AccessorStrategyInterface
     */
    private $accessorStrategy;
    /**
     * @var CacheInterface
     */
    private $metadataCache;
    /**
     * @var bool
     */
    private $docBlockTyperResolver;
    /**
     * @param mixed ...$args
     *
     * @return SerializerBuilder
     */
    public static function create(...$args) : self
    {
        return new static(...$args);
    }
    public function __construct(?HandlerRegistryInterface $handlerRegistry = null, ?EventDispatcherInterface $eventDispatcher = null)
    {
        $this->typeParser = new Parser();
        $this->handlerRegistry = $handlerRegistry ?: new HandlerRegistry();
        $this->eventDispatcher = $eventDispatcher ?: new EventDispatcher();
        $this->serializationVisitors = [];
        $this->deserializationVisitors = [];
        if ($handlerRegistry) {
            $this->handlersConfigured = \true;
        }
        if ($eventDispatcher) {
            $this->listenersConfigured = \true;
        }
    }
    public function setAccessorStrategy(AccessorStrategyInterface $accessorStrategy) : self
    {
        $this->accessorStrategy = $accessorStrategy;
        return $this;
    }
    private function getAccessorStrategy() : AccessorStrategyInterface
    {
        if (!$this->accessorStrategy) {
            $this->accessorStrategy = new DefaultAccessorStrategy($this->expressionEvaluator);
        }
        return $this->accessorStrategy;
    }
    public function setExpressionEvaluator(ExpressionEvaluatorInterface $expressionEvaluator) : self
    {
        $this->expressionEvaluator = $expressionEvaluator;
        return $this;
    }
    public function setTypeParser(ParserInterface $parser) : self
    {
        $this->typeParser = $parser;
        return $this;
    }
    public function setAnnotationReader(Reader $reader) : self
    {
        $this->annotationReader = $reader;
        return $this;
    }
    public function setDebug(bool $bool) : self
    {
        $this->debug = $bool;
        return $this;
    }
    public function setCacheDir(string $dir) : self
    {
        if (!\is_dir($dir)) {
            $this->createDir($dir);
        }
        if (!\is_writable($dir)) {
            throw new InvalidArgumentException(\sprintf('The cache directory "%s" is not writable.', $dir));
        }
        $this->cacheDir = $dir;
        return $this;
    }
    public function addDefaultHandlers() : self
    {
        $this->handlersConfigured = \true;
        $this->handlerRegistry->registerSubscribingHandler(new DateHandler());
        $this->handlerRegistry->registerSubscribingHandler(new StdClassHandler());
        $this->handlerRegistry->registerSubscribingHandler(new ArrayCollectionHandler());
        $this->handlerRegistry->registerSubscribingHandler(new IteratorHandler());
        if ($this->enableEnumSupport) {
            $this->handlerRegistry->registerSubscribingHandler(new EnumHandler());
        }
        if (\PHP_VERSION_ID >= 80000) {
            $this->handlerRegistry->registerSubscribingHandler(new UnionHandler());
        }
        return $this;
    }
    public function configureHandlers(\Closure $closure) : self
    {
        $this->handlersConfigured = \true;
        $closure($this->handlerRegistry);
        return $this;
    }
    public function addDefaultListeners() : self
    {
        $this->listenersConfigured = \true;
        $this->eventDispatcher->addSubscriber(new DoctrineProxySubscriber());
        if ($this->enableEnumSupport) {
            $this->eventDispatcher->addSubscriber(new EnumSubscriber());
        }
        return $this;
    }
    public function configureListeners(\Closure $closure) : self
    {
        $this->listenersConfigured = \true;
        $closure($this->eventDispatcher);
        return $this;
    }
    public function setObjectConstructor(ObjectConstructorInterface $constructor) : self
    {
        $this->objectConstructor = $constructor;
        return $this;
    }
    public function setPropertyNamingStrategy(PropertyNamingStrategyInterface $propertyNamingStrategy) : self
    {
        $this->propertyNamingStrategy = $propertyNamingStrategy;
        return $this;
    }
    public function setSerializationVisitor(string $format, SerializationVisitorFactory $visitor) : self
    {
        $this->serializationVisitorsAdded = \true;
        $this->serializationVisitors[$format] = $visitor;
        return $this;
    }
    public function setDeserializationVisitor(string $format, DeserializationVisitorFactory $visitor) : self
    {
        $this->deserializationVisitorsAdded = \true;
        $this->deserializationVisitors[$format] = $visitor;
        return $this;
    }
    public function addDefaultSerializationVisitors() : self
    {
        $this->serializationVisitorsAdded = \true;
        $this->serializationVisitors = ['xml' => new XmlSerializationVisitorFactory(), 'json' => new JsonSerializationVisitorFactory()];
        return $this;
    }
    public function addDefaultDeserializationVisitors() : self
    {
        $this->deserializationVisitorsAdded = \true;
        $this->deserializationVisitors = ['xml' => new XmlDeserializationVisitorFactory(), 'json' => new JsonDeserializationVisitorFactory()];
        return $this;
    }
    /**
     * @param bool $include Whether to include the metadata from the interfaces
     *
     * @return SerializerBuilder
     */
    public function includeInterfaceMetadata(bool $include) : self
    {
        $this->includeInterfaceMetadata = $include;
        return $this;
    }
    /**
     * Sets a map of namespace prefixes to directories.
     *
     * This method overrides any previously defined directories.
     *
     * @param array <string,string> $namespacePrefixToDirMap
     *
     * @return SerializerBuilder
     *
     * @throws InvalidArgumentException When a directory does not exist.
     */
    public function setMetadataDirs(array $namespacePrefixToDirMap) : self
    {
        foreach ($namespacePrefixToDirMap as $dir) {
            if (!\is_dir($dir)) {
                throw new InvalidArgumentException(\sprintf('The directory "%s" does not exist.', $dir));
            }
        }
        $this->metadataDirs = $namespacePrefixToDirMap;
        return $this;
    }
    /**
     * Adds a directory where the serializer will look for class metadata.
     *
     * The namespace prefix will make the names of the actual metadata files a bit shorter. For example, let's assume
     * that you have a directory where you only store metadata files for the ``MyApplication\Entity`` namespace.
     *
     * If you use an empty prefix, your metadata files would need to look like:
     *
     * ``my-dir/MyApplication.Entity.SomeObject.yml``
     * ``my-dir/MyApplication.Entity.OtherObject.xml``
     *
     * If you use ``MyApplication\Entity`` as prefix, your metadata files would need to look like:
     *
     * ``my-dir/SomeObject.yml``
     * ``my-dir/OtherObject.yml``
     *
     * Please keep in mind that you currently may only have one directory per namespace prefix.
     *
     * @param string $dir             The directory where metadata files are located.
     * @param string $namespacePrefix An optional prefix if you only store metadata for specific namespaces in this directory.
     *
     * @return SerializerBuilder
     *
     * @throws InvalidArgumentException When a directory does not exist.
     * @throws InvalidArgumentException When a directory has already been registered.
     */
    public function addMetadataDir(string $dir, string $namespacePrefix = '') : self
    {
        if (!\is_dir($dir)) {
            throw new InvalidArgumentException(\sprintf('The directory "%s" does not exist.', $dir));
        }
        if (isset($this->metadataDirs[$namespacePrefix])) {
            throw new InvalidArgumentException(\sprintf('There is already a directory configured for the namespace prefix "%s". Please use replaceMetadataDir() to override directories.', $namespacePrefix));
        }
        $this->metadataDirs[$namespacePrefix] = $dir;
        return $this;
    }
    /**
     * Adds a map of namespace prefixes to directories.
     *
     * @param array <string,string> $namespacePrefixToDirMap
     *
     * @return SerializerBuilder
     */
    public function addMetadataDirs(array $namespacePrefixToDirMap) : self
    {
        foreach ($namespacePrefixToDirMap as $prefix => $dir) {
            $this->addMetadataDir($dir, $prefix);
        }
        return $this;
    }
    /**
     * Similar to addMetadataDir(), but overrides an existing entry.
     *
     * @return SerializerBuilder
     *
     * @throws InvalidArgumentException When a directory does not exist.
     * @throws InvalidArgumentException When no directory is configured for the ns prefix.
     */
    public function replaceMetadataDir(string $dir, string $namespacePrefix = '') : self
    {
        if (!\is_dir($dir)) {
            throw new InvalidArgumentException(\sprintf('The directory "%s" does not exist.', $dir));
        }
        if (!isset($this->metadataDirs[$namespacePrefix])) {
            throw new InvalidArgumentException(\sprintf('There is no directory configured for namespace prefix "%s". Please use addMetadataDir() for adding new directories.', $namespacePrefix));
        }
        $this->metadataDirs[$namespacePrefix] = $dir;
        return $this;
    }
    public function setMetadataDriverFactory(DriverFactoryInterface $driverFactory) : self
    {
        $this->driverFactory = $driverFactory;
        return $this;
    }
    /**
     * @param SerializationContextFactoryInterface|callable $serializationContextFactory
     */
    public function setSerializationContextFactory($serializationContextFactory) : self
    {
        if ($serializationContextFactory instanceof SerializationContextFactoryInterface) {
            $this->serializationContextFactory = $serializationContextFactory;
        } elseif (\is_callable($serializationContextFactory)) {
            $this->serializationContextFactory = new CallableSerializationContextFactory($serializationContextFactory);
        } else {
            throw new InvalidArgumentException('expected SerializationContextFactoryInterface or callable.');
        }
        return $this;
    }
    /**
     * @param DeserializationContextFactoryInterface|callable $deserializationContextFactory
     */
    public function setDeserializationContextFactory($deserializationContextFactory) : self
    {
        if ($deserializationContextFactory instanceof DeserializationContextFactoryInterface) {
            $this->deserializationContextFactory = $deserializationContextFactory;
        } elseif (\is_callable($deserializationContextFactory)) {
            $this->deserializationContextFactory = new CallableDeserializationContextFactory($deserializationContextFactory);
        } else {
            throw new InvalidArgumentException('expected DeserializationContextFactoryInterface or callable.');
        }
        return $this;
    }
    public function enableEnumSupport(bool $enableEnumSupport = \true) : self
    {
        if ($enableEnumSupport && \PHP_VERSION_ID < 80100) {
            throw new InvalidArgumentException('Enum support can be enabled only on PHP 8.1 or higher.');
        }
        $this->enableEnumSupport = $enableEnumSupport;
        return $this;
    }
    public function setMetadataCache(CacheInterface $cache) : self
    {
        $this->metadataCache = $cache;
        return $this;
    }
    public function setDocBlockTypeResolver(bool $docBlockTypeResolver) : self
    {
        $this->docBlockTyperResolver = $docBlockTypeResolver;
        return $this;
    }
    public function build() : Serializer
    {
        $annotationReader = $this->annotationReader;
        if (null === $annotationReader && \class_exists(AnnotationReader::class)) {
            $annotationReader = $this->decorateAnnotationReader(new AnnotationReader());
        }
        if (null === $this->driverFactory) {
            $this->initializePropertyNamingStrategy();
            $this->driverFactory = new DefaultDriverFactory($this->propertyNamingStrategy, $this->typeParser, $this->expressionEvaluator instanceof CompilableExpressionEvaluatorInterface ? $this->expressionEvaluator : null);
            $this->driverFactory->enableEnumSupport($this->enableEnumSupport);
        }
        if ($this->docBlockTyperResolver) {
            $this->driverFactory = new DocBlockDriverFactory($this->driverFactory, $this->typeParser);
        }
        $metadataDriver = $this->driverFactory->createDriver($this->metadataDirs, $annotationReader);
        $metadataFactory = new MetadataFactory($metadataDriver, null, $this->debug);
        $metadataFactory->setIncludeInterfaces($this->includeInterfaceMetadata);
        if (null !== $this->metadataCache) {
            $metadataFactory->setCache($this->metadataCache);
        } elseif (null !== $this->cacheDir) {
            $this->createDir($this->cacheDir . '/metadata');
            $metadataFactory->setCache(new FileCache($this->cacheDir . '/metadata'));
        }
        if (!$this->handlersConfigured) {
            $this->addDefaultHandlers();
        }
        if (!$this->listenersConfigured) {
            $this->addDefaultListeners();
        }
        if (!$this->serializationVisitorsAdded) {
            $this->addDefaultSerializationVisitors();
        }
        if (!$this->deserializationVisitorsAdded) {
            $this->addDefaultDeserializationVisitors();
        }
        $navigatorFactories = [GraphNavigatorInterface::DIRECTION_SERIALIZATION => $this->getSerializationNavigatorFactory($metadataFactory), GraphNavigatorInterface::DIRECTION_DESERIALIZATION => $this->getDeserializationNavigatorFactory($metadataFactory)];
        return new Serializer($metadataFactory, $navigatorFactories, $this->serializationVisitors, $this->deserializationVisitors, $this->serializationContextFactory, $this->deserializationContextFactory, $this->typeParser);
    }
    private function getSerializationNavigatorFactory(MetadataFactoryInterface $metadataFactory) : GraphNavigatorFactoryInterface
    {
        return new SerializationGraphNavigatorFactory($metadataFactory, $this->handlerRegistry, $this->getAccessorStrategy(), $this->eventDispatcher, $this->expressionEvaluator);
    }
    private function getDeserializationNavigatorFactory(MetadataFactoryInterface $metadataFactory) : GraphNavigatorFactoryInterface
    {
        return new DeserializationGraphNavigatorFactory($metadataFactory, $this->handlerRegistry, $this->objectConstructor ?: new UnserializeObjectConstructor(), $this->getAccessorStrategy(), $this->eventDispatcher, $this->expressionEvaluator);
    }
    private function initializePropertyNamingStrategy() : void
    {
        if (null !== $this->propertyNamingStrategy) {
            return;
        }
        $this->propertyNamingStrategy = new SerializedNameAnnotationStrategy(new CamelCaseNamingStrategy());
    }
    private function createDir(string $dir) : void
    {
        if (\is_dir($dir)) {
            return;
        }
        if (\false === @\mkdir($dir, 0777, \true) && \false === \is_dir($dir)) {
            throw new RuntimeException(\sprintf('Could not create directory "%s".', $dir));
        }
    }
    private function decorateAnnotationReader(Reader $annotationReader) : Reader
    {
        if (null !== $this->cacheDir) {
            $this->createDir($this->cacheDir . '/annotations');
            if (\class_exists(FilesystemAdapter::class)) {
                $annotationsCache = new FilesystemAdapter('', 0, $this->cacheDir . '/annotations');
                $annotationReader = new PsrCachedReader($annotationReader, $annotationsCache, $this->debug);
            } elseif (\class_exists(FilesystemCache::class) && \class_exists(CachedReader::class)) {
                $annotationsCache = new FilesystemCache($this->cacheDir . '/annotations');
                $annotationReader = new CachedReader($annotationReader, $annotationsCache, $this->debug);
            }
        }
        return $annotationReader;
    }
}