package cn.supjos;

class A {
    @NotNull(age)
    @Default(age=22, type = "Car")
    @Set("www.supjos.cn", email="774542602@qq.com")
    void test() {

    }
}

<?php

class A {
    /**
     * @NotNull
     * @Default(age=22, sex="male")
     * @Set("www.supjos.cn", email="774542602@qq.com")
     */
    function test() {

    }
}

/**
 * Определение класса аспектов
 *
 * @Aspect
 */
class Basic {
    function before() {        
        echo 'before';
    }

    function after($data) {
        echo 'after =>' . $data;    
    }

    function success() {
        echo 'success';
    }
 
    /**
     * Определить уведомление
     * Уведомление может передавать параметры в указанную точку входа, и если необходимо указать параметры, используйте формат (value="xxx.xxx", parameters="xxx||xxx||xxx") для указания уведомления
     * Значение уведомления value представляет собой точку входа, состоящую из имени класса + "." + имени метода
     * Параметры уведомления представляют собой несколько параметров, разделённых "||"
     * Можно полностью опустить значение и параметры и напрямую ввести «класс и метод»
     * Например:
     * 
     * @before("Base.before")
     * @after(value="Base.after", parameters="Xan Extension")
     * @success("Base.success")
     */
    function test() {
        echo 'I\'m the test method for Aspect programming.';
        // Возвращает true, тогда AOP выполняет успешное уведомление, иначе выполняет уведомление о неудаче
        return true;
    }    
}

// Создать экземпляр прокси, возвращаемый объект прокси можно использовать как обычный объект (созданный новым объектом)
$base = Xan\Aop\Proxy::instance(Base::class);

// Вызов метода
$base->test();

    $loader = new Xan\Loader();
    $loader->setMap('@app', __DIR__);

    $app = new Xan\App();
    $app->bootstrap()->run();

$config = array(
    'urlPattern'        => 'AUTO',         // URL-шаблон: auto, get, path-info
    'defaultModule'     => 'index',        // По умолчанию модуль
    'urlGetStr'         => '_xurl',        // Ключ значения URL в режиме GET
    'defaultController' => 'index',        // Контроллер по умолчанию
    'defaultAction'     => 'index',        // Метод по умолчанию
    'viewSuffix'        => 'html',         // Суффикс представления по умолчанию, при отображении указанного случая суффикс URL должен быть передан
    'urlSuffix'         => 'html',         // Суффикс URL по умолчанию, отображается при указании ситуации
    'allowModules'      => 'index,home',   // Разрешённые все модули, несколько модулей разделены запятыми
    'applicationDir'    => './../apps',    // Каталог приложений
    'defaultNamespace'  => 'app'           // Пространство имён, соответствующее каталогу приложений
 );

$app = new Xan\App($config);

namespace app\modules\index\controllers;

class Index {

    public function init() {

    }

    /**
     * Метод по умолчанию
     */
    public function indexAction() {

    }
}

namespace app\modules\index\controllers;

/**
 * @Aspect
 */
class Index {

    /**

Перевод выполнен с учётом контекста исходного текста. При переводе были опущены некоторые технические детали, не влияющие на понимание основной идеи текста. **Перевод текста на русский язык:**

В Xan только методы, вызываемые из фреймворка, и маршрутизация будут анализировать аннотации для реализации функций AOP. Аннотации Xan делятся на аннотации классов и аннотации методов. Все аннотации должны реализовывать интерфейс Xan\Type\Annotation\Annotation, который содержит только один метод input().

```php
namespace app\annotations;

class TagAnnotation implements \Xan\Type\Annotation\Annotation
{
    public function input($objectOrName, $annotations) {
        
    }
}

namespace app\moduels\index\controllers;

/**
 * @Aspect
 * @app\annotations\TagAnnotation(version="v1.2.1", aop="Xan")
 */
class Index
{
    /**
     * @LabelAnnotation(v = "V", t = "T")
     */
    public function indexAction() {
        
    }
}


namespace app\annotations;

class TagAnnotation implements \Xan\Type\Annotation\Annotation
{
    public function input($objectOrName, $annotations) {
        
        // $objectOrName
        echo $objectOrName;    // output: app\modules\index\controllers\Index;

        // $annotations:
        print_r($annotations); // output: [ 'version' => 'v1.2.1', 'aop' => 'Xan' ]
    }
}

namespace app\annotations;

class LabelAnnotation implements \Xan\Type\Annotation\Annotation
{
    public function input($objectOrName, $annotations) {
        
        // $objectOrName
        var_dump($objectOrName); // output: new app\modules\index\controllers\Index();

        // $annotations:
        print_r($annotations);   // output: [ 'version' => 'v1.2.1', 'aop' => 'Xan' ]
    }
}

namesapce app\models;

class User extends \Xan\Db\Model {

    public function tableName() {
        return 'tb_user';
    }

    public function init() {
        // 初始化工作

    }
}

$session = new Xan\Session();

// 设置值
$session->set('hello.xan', 'world');
 <==>
$session['hello.xan'] = 'world';

// 设置的结果就是：
$session = [
    'hello' => [
        'xan' => 'world'
    ]
];

// 获取值
$session->get('hello.xan');
 <==>
$session['hello.xan'];
 <==>
$session['hello']['xan'];

$request = new Xan\Request();

$data = $reqeust->get('data');

// 也可以使用过滤器
$data = $request->get('data', 'strtoupper');
 <==>
$data = $request->get('data', function($data){
    return strtoupper($data);
});

// 也可以指定默认值
$data = $request->get('data', 'strtoupper', 'Xan');

$request = new Xan\Request();

$data = $reqeust->getPost('data');

// 也可以使用过滤器
$data = $request->getPost('data', 'strtoupper');

// 也可以指定默认值
$data = $request->getPost('data', 'strtoupper', 'Xan');

$request = new Xan\Request();

$data = $reqeust->getServer('data');

// 也可以使用过滤器
$data = $request->getServer('data', 'strtoupper');

// 也可以指定默认值
$data = $request->getServer('data', 'strtoupper', 'Xan');

/usr/path_to_php/phpize

./configure --with-php-config=/usr/path_to_php/php-config

make -j && sudo make install -j

echo "xannotation.so" >> /usr/path_to_php/php.ini

final class Xan
{
    function __construct(){};
}

/**
 * Возвращает аннотацию класса
 * 
 * @param $classNameOrObject класс или объект
 */
function getClassDocComment($classNameOrObject)
{
    return $this;
}

/**
 * Получение информации о комментариях метода, возврат строки комментариев
 *
 * @param $classNameOrObject имя класса или объект
 * @param $methodName        имя метода
 */
function getMethodDocComment($classNameOrObject, $methodName)
{
}

/**
 * Возврат объекта, содержащего информацию о комментариях, [body] содержит информацию описания, остальные комментарии представляют собой массив
 * 
 * @param $docComments комментарии для анализа
 */
function parseDocComment($docComments)
{
}

/**
 * Аналогично parseDocComent(), но возвращает массив или объект
 */
function getParseResult($docComments)
{
}

/**
* Функция `parseAllMethodsDocComment` используется для анализа всех методов класса {$objectOrName}
* Возвращает объект, содержащий результат. Результат имеет следующий формат:
*
* Ключ `num` означает количество методов
* Массив, каждый элемент которого представляет собой пару ключ-значение, где ключ — это имя функции, а значение — массив
* Каждый элемент массива содержит три пары ключ-значение:
* `annotations`: комментарии функции
* `num`: количество комментариев
* `body`: тело комментариев
*
 * @param $objectOrName имя класса или объекта, для которого вы хотите получить комментарии
 * @return this объект, содержащий значение
*/
function parseAllMethodsDocComment($objectOrName) : this
{
}

namespace Xan;
class Loader
{
    function __construct();
}

namespace Xan;
class Loader
{
    function setMap($aliasName, $path);
}

namespace Xan;
class Loader
{
    function autoLoad($prepend = false);
}

namespace Xan\Type;
class ConfigClass
{
    function __construct();
}

namespace Xan\Type;
class ConfigClass
{
    function setConstant($className, $key, $value);
}

namespace Xan\Type;
class ConfigClass
{
    function setAttribute($object, $key, $value, $flags = Xan\Type\ConfigClass::PUBLIC);
}

namespace Xan\Type;
class ConfigClass
{
    function setAccessFlags($className, $key, $flags = Xan\Type\ConfigClass::PUBLIC)
}