add lazy hydrator

Author: DavidBadura

src/LazyHydrator.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\Hydrator;
+
+use ReflectionClass;
+
+final class LazyHydrator implements Hydrator
+{
+    public function __construct(
+        private readonly Hydrator $realHydrator,
+    ) {
+    }
+
+    /**
+     * @param class-string<T>      $class
+     * @param array<string, mixed> $data
+     *
+     * @return T
+     *
+     * @template T of object
+     */
+    public function hydrate(string $class, array $data): object
+    {
+        return (new ReflectionClass($class))->newLazyProxy(
+            function () use ($class, $data): object {
+                return $this->realHydrator->hydrate($class, $data);
+            },
+        );
+    }
+
+    /** @return array<string, mixed> */
+    public function extract(object $object): array
+    {
+        return $this->realHydrator->extract($object);
+    }
+}

tests/Benchmark/HydratorWithCryptographyBench.php

@@ -8,6 +8,7 @@
 use Patchlevel\Hydrator\Cryptography\PersonalDataPayloadCryptographer;
 use Patchlevel\Hydrator\Cryptography\Store\InMemoryCipherKeyStore;
 use Patchlevel\Hydrator\Hydrator;
+use Patchlevel\Hydrator\LazyHydrator;
 use Patchlevel\Hydrator\MetadataHydrator;
 use Patchlevel\Hydrator\Tests\Benchmark\Fixture\ProfileCreated;
 use Patchlevel\Hydrator\Tests\Benchmark\Fixture\ProfileId;
@@ -31,7 +32,7 @@ public function __construct()
             PersonalDataPayloadCryptographer::createWithDefaultSettings($this->store),
         ));
 
-        $this->hydrator = MetadataHydrator::create(eventDispatcher: $eventDispatcher);
+        $this->hydrator = new LazyHydrator(MetadataHydrator::create(eventDispatcher: $eventDispatcher));
     }
 
     public function setUp(): void

tests/Unit/LazyHydratorTest.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Unit;
+
+use Patchlevel\Hydrator\Hydrator;
+use Patchlevel\Hydrator\LazyHydrator;
+use Patchlevel\Hydrator\Tests\Unit\Fixture\Email;
+use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileCreated;
+use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileId;
+use PHPUnit\Framework\Attributes\RequiresPhp;
+use PHPUnit\Framework\TestCase;
+
+#[RequiresPhp('>= 8.4')]
+class LazyHydratorTest extends TestCase
+{
+    public function testNoHydration(): void
+    {
+        $realHydrator = $this->createMock(Hydrator::class);
+        $realHydrator->expects($this->never())->method('hydrate')->withAnyParameters();
+
+        $hydrator = new LazyHydrator($realHydrator);
+
+        $object = $hydrator->hydrate(
+            ProfileCreated::class,
+            ['profileId' => '1', 'email' => 'info@patchlevel.de'],
+        );
+
+        self::assertInstanceOf(ProfileCreated::class, $object);
+    }
+
+    public function testTriggerHydration(): void
+    {
+        $realHydrator = $this->createMock(Hydrator::class);
+        $realHydrator->expects($this->once())->method('hydrate')->with(
+            ProfileCreated::class,
+            ['profileId' => '1', 'email' => 'info@patchlevel.de'],
+        )->willReturn(new ProfileCreated(
+            profileId: ProfileId::fromString('1'),
+            email: Email::fromString('info@patchlevel.de'),
+        ));
+
+        $hydrator = new LazyHydrator($realHydrator);
+
+        $object = $hydrator->hydrate(
+            ProfileCreated::class,
+            ['profileId' => '1', 'email' => 'info@patchlevel.de'],
+        );
+
+        self::assertInstanceOf(ProfileCreated::class, $object);
+        self::assertSame('1', $object->profileId->toString());
+    }
+}