From 3cc716706c0b36d3e3986962cbebcfa7161fab05 Mon Sep 17 00:00:00 2001
From: Peter Grundmann <mail@peter-grundmann.de>
Date: Thu, 7 Nov 2024 18:38:49 +0100
Subject: [PATCH] new "JsonComplete" attribute

---
 .gitignore                      |  1 +
 src/Attributes/Json.php         |  3 ++-
 src/Attributes/JsonComplete.php | 11 +++++++++++
 src/Attributes/JsonDateTime.php |  3 ++-
 src/Attributes/JsonEnum.php     |  3 ++-
 src/Attributes/JsonType.php     |  3 ++-
 src/JsonDeserializer.php        | 30 +++++++++++++++++++++++++++++-
 7 files changed, 49 insertions(+), 5 deletions(-)
 create mode 100644 src/Attributes/JsonComplete.php

diff --git a/.gitignore b/.gitignore
index 1a3eb7a..28eb210 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,3 +2,4 @@ composer.lock
 vendor/
 .vscode/
 notes.md
+demos2/
\ No newline at end of file
diff --git a/src/Attributes/Json.php b/src/Attributes/Json.php
index 6f45753..f0b5b11 100644
--- a/src/Attributes/Json.php
+++ b/src/Attributes/Json.php
@@ -5,6 +5,7 @@
  * Attribute that allows overwriting individual property names.
  */
 #[\Attribute]
-class Json {
+class Json
+{
     public function __construct(public string $name) {}
 }
\ No newline at end of file
diff --git a/src/Attributes/JsonComplete.php b/src/Attributes/JsonComplete.php
new file mode 100644
index 0000000..344b6ca
--- /dev/null
+++ b/src/Attributes/JsonComplete.php
@@ -0,0 +1,11 @@
+<?php
+namespace Pyther\Json\Attributes;
+
+/**
+ * Attribute that allows pre- and post processing.
+ */
+#[\Attribute]
+class JsonComplete
+{
+    public function __construct() {}
+}
\ No newline at end of file
diff --git a/src/Attributes/JsonDateTime.php b/src/Attributes/JsonDateTime.php
index 3a2e28e..88b8197 100644
--- a/src/Attributes/JsonDateTime.php
+++ b/src/Attributes/JsonDateTime.php
@@ -5,6 +5,7 @@
  * Attribute that allows overwriting individual datetime formats.
  */
 #[\Attribute]
-class JsonDateTime {
+class JsonDateTime
+{
     public function __construct(public string $format) {}
 }
\ No newline at end of file
diff --git a/src/Attributes/JsonEnum.php b/src/Attributes/JsonEnum.php
index 0dbd2b0..1789a34 100644
--- a/src/Attributes/JsonEnum.php
+++ b/src/Attributes/JsonEnum.php
@@ -7,6 +7,7 @@
  * Attribute that allows overwriting individual enum formats.
  */
 #[\Attribute]
-class JsonEnum {
+class JsonEnum
+{
     public function __construct(public EnumFormat $format = EnumFormat::Value) {}
 }
\ No newline at end of file
diff --git a/src/Attributes/JsonType.php b/src/Attributes/JsonType.php
index 5548b5a..5fda35e 100644
--- a/src/Attributes/JsonType.php
+++ b/src/Attributes/JsonType.php
@@ -5,6 +5,7 @@
  * Attribute that allows overwriting individual property types. This is especially useful for array types.
  */
 #[\Attribute]
-class JsonType {
+class JsonType
+{
     public function __construct(public ?string $type) {}
 }
\ No newline at end of file
diff --git a/src/JsonDeserializer.php b/src/JsonDeserializer.php
index a72b7b4..927ba6f 100644
--- a/src/JsonDeserializer.php
+++ b/src/JsonDeserializer.php
@@ -2,6 +2,7 @@
 namespace Pyther\Json;
 
 use Exception;
+use Pyther\Json\Attributes\JsonComplete;
 use Pyther\Json\Attributes\JsonDateTime;
 use Pyther\Json\Exceptions\JsonException;
 
@@ -136,6 +137,8 @@ private function fillObject(object $object, array $data): ?object
             $this->setValue($object, $value, $prop);
         }
 
+        $this->finalize($object);
+
         return $object;
     }
 
@@ -205,7 +208,32 @@ private function getEnum(string $enumClass, mixed $value, ?string $propertyName
         } catch (Exception $ex) {
             throw new JsonException($ex->getMessage(), $propertyName);
         }
-        
+    }
+
+    /**
+     * Find and invoke the objects #[JsonFinalize] method (if any).
+     *
+     * @param [type] $object
+     * @return void
+     */
+    public function finalize($object)
+    {
+        $reflObject = new \ReflectionObject($object);
+        $methods = $reflObject->getMethods();
+
+        foreach ($methods as $method)
+        {
+            $attributes = $method->getAttributes(JsonComplete::class);
+            if (count($attributes) > 0) {
+                $methodName = $method->getName();                
+                $method = $reflObject->getMethod($methodName);
+                if (version_compare(PHP_VERSION, '8.1.0') < 0) {
+                    $method->setAccessible(true);
+                }
+                $method->invoke($object);
+                break;
+            }
+        }
     }
 
 }
\ No newline at end of file