Add cache providers

Author: SerafimArts

src/Mapping/Provider/CacheProvider.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Mapper\Mapping\Provider;
+
+use TypeLang\Mapper\Mapping\Reader\ReaderInterface;
+
+abstract class CacheProvider extends Decorator
+{
+    /**
+     * @var non-empty-string
+     */
+    protected const DEFAULT_CACHE_PREFIX = 'tlm_';
+
+    protected const DEFAULT_CACHE_TTL = null;
+
+    public function __construct(
+        protected readonly string $prefix = self::DEFAULT_CACHE_PREFIX,
+        protected readonly \DateInterval|int|null $ttl = self::DEFAULT_CACHE_TTL,
+        ReaderInterface|ProviderInterface $delegate = new NullProvider(),
+    ) {
+        parent::__construct($delegate);
+    }
+
+    /**
+     * @param \ReflectionClass<object> $class
+     *
+     * @return non-empty-string
+     */
+    protected function getKey(\ReflectionClass $class): string
+    {
+        return $this->prefix
+            . self::getKeyName($class)
+            . self::getKeySuffix($class);
+    }
+
+    /**
+     * @param \ReflectionClass<object> $class
+     *
+     * @return non-empty-string
+     */
+    protected static function getKeyName(\ReflectionClass $class): string
+    {
+        return \str_replace(['\\', "\0"], '_', \strtolower($class->name));
+    }
+
+    /**
+     * @param \ReflectionClass<object> $class
+     */
+    protected static function getKeySuffix(\ReflectionClass $class): string
+    {
+        $pathname = $class->getFileName();
+
+        if ($pathname === false) {
+            return '';
+        }
+
+        return (string) \filemtime($pathname);
+    }
+}

src/Mapping/Provider/Decorator.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Mapper\Mapping\Provider;
+
+use TypeLang\Mapper\Mapping\Metadata\ClassMetadata;
+use TypeLang\Mapper\Mapping\Reader\ReaderInterface;
+use TypeLang\Mapper\Runtime\Parser\TypeParserInterface;
+use TypeLang\Mapper\Runtime\Repository\TypeRepositoryInterface;
+
+abstract class Decorator implements ProviderInterface
+{
+    private readonly ProviderInterface $delegate;
+
+    public function __construct(
+        ProviderInterface|ReaderInterface $delegate = new NullProvider(),
+    ) {
+        $this->delegate = $this->createProvider($delegate);
+    }
+
+    private function createProvider(ProviderInterface|ReaderInterface $readerOrProvider): ProviderInterface
+    {
+        if ($readerOrProvider instanceof ReaderInterface) {
+            return $this->createDefaultProvider($readerOrProvider);
+        }
+
+        return $readerOrProvider;
+    }
+
+    private function createDefaultProvider(ReaderInterface $reader): ProviderInterface
+    {
+        return new MetadataReaderProvider($reader);
+    }
+
+    public function getClassMetadata(
+        \ReflectionClass $class,
+        TypeRepositoryInterface $types,
+        TypeParserInterface $parser,
+    ): ClassMetadata {
+        return $this->delegate->getClassMetadata($class, $types, $parser);
+    }
+}

src/Mapping/Provider/InMemoryProvider.php

@@ -8,7 +8,7 @@
 use TypeLang\Mapper\Runtime\Parser\TypeParserInterface;
 use TypeLang\Mapper\Runtime\Repository\TypeRepositoryInterface;
 
-final class InMemoryProvider extends Provider
+final class InMemoryProvider extends Decorator
 {
     /**
      * @var array<class-string, ClassMetadata<object>>

src/Mapping/Provider/MetadataReaderProvider.php

@@ -331,7 +331,7 @@ private function createDefaultExpressionLanguage(): ExpressionLanguage
         if (!\class_exists(ExpressionLanguage::class)) {
             throw ComposerPackageRequiredException::becausePackageNotInstalled(
                 package: 'symfony/expression-language',
-                purpose: 'expressions support',
+                purpose: 'condition expressions support',
             );
         }
 

src/Mapping/Provider/Provider.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Mapper\Mapping\Provider;
+
+use Psr\SimpleCache\CacheInterface;
+use TypeLang\Mapper\Mapping\Metadata\ClassMetadata;
+use TypeLang\Mapper\Mapping\Reader\ReaderInterface;
+use TypeLang\Mapper\Runtime\Parser\TypeParserInterface;
+use TypeLang\Mapper\Runtime\Repository\TypeRepositoryInterface;
+
+final class Psr16CacheProvider extends CacheProvider
+{
+    public function __construct(
+        private readonly CacheInterface $psr16,
+        string $prefix = self::DEFAULT_CACHE_PREFIX,
+        \DateInterval|int|null $ttl = self::DEFAULT_CACHE_TTL,
+        ReaderInterface|ProviderInterface $delegate = new NullProvider(),
+    ) {
+        parent::__construct($prefix, $ttl, $delegate);
+    }
+
+    public function getClassMetadata(
+        \ReflectionClass $class,
+        TypeRepositoryInterface $types,
+        TypeParserInterface $parser,
+    ): ClassMetadata {
+        $result = $this->psr16->get($key = $this->getKey($class));
+
+        if (!$result instanceof ClassMetadata) {
+            $result = parent::getClassMetadata($class, $types, $parser);
+
+            $this->psr16->set($key, $result, $this->ttl);
+        }
+
+        return $result;
+    }
+}

src/Mapping/Provider/Psr16CacheProvider.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Mapper\Mapping\Provider;
+
+use Psr\Cache\CacheItemPoolInterface;
+use TypeLang\Mapper\Mapping\Metadata\ClassMetadata;
+use TypeLang\Mapper\Mapping\Reader\ReaderInterface;
+use TypeLang\Mapper\Runtime\Parser\TypeParserInterface;
+use TypeLang\Mapper\Runtime\Repository\TypeRepositoryInterface;
+
+final class Psr6CacheProvider extends CacheProvider
+{
+    public function __construct(
+        private readonly CacheItemPoolInterface $psr6,
+        string $prefix = self::DEFAULT_CACHE_PREFIX,
+        \DateInterval|int|null $ttl = self::DEFAULT_CACHE_TTL,
+        ReaderInterface|ProviderInterface $delegate = new NullProvider(),
+    ) {
+        parent::__construct($prefix, $ttl, $delegate);
+    }
+
+    public function getClassMetadata(
+        \ReflectionClass $class,
+        TypeRepositoryInterface $types,
+        TypeParserInterface $parser,
+    ): ClassMetadata {
+        $item = $this->psr6->getItem($this->getKey($class));
+
+        $result = $item->get();
+
+        if ($result instanceof ClassMetadata) {
+            return $result;
+        }
+
+        $result = parent::getClassMetadata($class, $types, $parser);
+
+        $item->expiresAfter($this->ttl);
+        $item->set($result);
+
+        $this->psr6->saveDeferred($item);
+
+        return $result;
+    }
+}