20250628 1.1 Beta 2

sources/traits/JsonReWriter/JsonReWriterReadTrait.php

@@ -2,6 +2,10 @@
 
 namespace goodboyalex\php_components_pack\traits\JsonReWriter;
 
+use goodboyalex\php_components_pack\enums\JsonErrorCode;
+use goodboyalex\php_components_pack\exceptions\JsonException;
+use goodboyalex\php_components_pack\interfaces\ISerializable;
+
 /**
  * Часть кода класса JsonReWriter, отвечающая за методы чтения ключей и значений JSON.
  *
@@ -35,9 +39,12 @@ trait JsonReWriterReadTrait
      */
     public function Read (string $key, mixed $default = null): mixed
     {
+        // Проверяем, существует ли ключ
         if (!$this->IsKeyExists($key))
+            // - если нет, то возвращаем значение по умолчанию
             return $default;
 
+        // Разбиваем ключ на массив ключей
         $keys = $this->ParseKey($key);
 
         // Получаем текущий массив данных
@@ -104,6 +111,36 @@ trait JsonReWriterReadTrait
         return (object)$this->Read($key, $default);
     }
 
+    /**
+     * Читает значение ключа JSON как объект, реализующий интерфейс ISerializable.
+     *
+     * @param string $key Ключ JSON.
+     * @param string $serializableClassName Имя класса, реализующего интерфейс ISerializable, с namespace.
+     *
+     * @return ISerializable Инициализированный объект
+     * @throws JsonException Если класс не реализует интерфейс ISerializable
+     */
+    public function ReadSerializable (string $key, string $serializableClassName): ISerializable
+    {
+        // Создаем объект
+        $instance = new $serializableClassName();
+
+        // Проверяем, что он реализует интерфейс ISerializable
+        if (!$instance instanceof ISerializable)
+            // - если нет, то выбрасываем исключение
+            throw new JsonException(errorCode: JsonErrorCode::NotISerializable,
+                errorMessage: "Class $serializableClassName is not implements ISerializable interface / Класс $serializableClassName не реализует интерфейс ISerializable");
+
+        // Получаем строку JSON из ключа
+        $json = $this->ReadString($key, $instance->Serialize());
+
+        // Десериализуем строку JSON в объект
+        $instance->UnSerialize($json);
+
+        // Возвращаем объект
+        return $instance;
+    }
+
     /**
      * Читает значение ключа JSON как строку.
      *