Чтение аннотаций сервиса

Author: arutyunyan

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change log
 
+## v7.3.5 - June 8, 2022
+
+- Чтение аннотаций сервиса
+
+---
+
 ## v7.3.4 - June 8, 2022
 
 - Добавил поддержку SuQL Service

src/annotation/ServiceAnnotation.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace suql\annotation;
+
+/**
+ * Разбор аннотаций параметров сервиса
+ * 
+ * @author sagittaracc <sagittaracc@gmail.com>
+ */
+class ServiceAnnotation
+{
+    /**
+     * @const string регулярное выражение для парсинга аннотации
+     */
+    const REGEX = '/#\s*\[Request\(uri="(?<uri>.*?)"\s*,\s*method="(?<method>\w+)"\)\]/msi';
+    /**
+     * @var string
+     */
+    public $uri;
+    /**
+     * @var string
+     */
+    public $method;
+    /**
+     * @var string из какой модели читать аннотацию
+     */
+    private $modelNameToReadFrom;
+    /**
+     * Задает из какой модели читать аннотацию
+     * @param string $modelName имя класса модели
+     * @return self
+     */
+    public static function from($modelName)
+    {
+        $instance = new static();
+        $instance->modelNameToReadFrom = $modelName;
+        return $instance;
+    }
+    /**
+     * Разбор запрошенной аннотации
+     * @return self
+     */
+    public function read()
+    {
+        $model = new \ReflectionClass($this->modelNameToReadFrom);
+        $file = file_get_contents($model->getFileName());
+
+        preg_match(static::REGEX, $file, $matches);
+
+        if (!empty($matches)) {
+            $this->uri = $matches['uri'];
+            $this->method = $matches['method'];
+        }
+
+        return $this;
+    }
+}

src/syntax/entity/SuQLService.php

@@ -3,6 +3,7 @@
 namespace suql\syntax\entity;
 
 use GuzzleHttp\Client;
+use suql\annotation\ServiceAnnotation;
 use suql\syntax\ServiceInterface;
 
 abstract class SuQLService extends SuQLArray implements ServiceInterface
@@ -32,8 +33,9 @@ public static function find($body = [])
     {
         $instance = new static();
 
-        // $instance->uri = read from annotation
-        // $instance->method = read from annotation
+        $annotation = ServiceAnnotation::from($instance)->read();
+        $instance->uri = $annotation->uri;
+        $instance->method = $annotation->method;
         $instance->uri = $instance->method === 'GET' ? $instance->uri . '?' . http_build_query($body) : $instance->uri;
         $instance->body = $instance->method === 'POST' ? $body : [];
 

tests/suql/models/Query27.php

@@ -5,12 +5,9 @@
 use suql\db\Container;
 use suql\syntax\entity\SuQLService;
 
+# [Request(uri="http://jsonplaceholder.typicode.com/posts", method="GET")]
 class Query27 extends SuQLService
 {
-    protected $uri = 'http://jsonplaceholder.typicode.com/posts';
-    protected $method = 'GET';
-    protected $body = [];
-
     public function getDb()
     {
         return Container::get('db_test');