README

sidalex/swoole-app Framework for Working with Swoole

Install
Config
List of config parameters
Task
1. Methods:
BasicTaskData
1. Parameters
TaskResulted
1. Properties:
Cyclic Job
Controller
notFoundController

Install

To install, execute the following commands:

composer require sidalex/swoole-app

To run the Swoole application, you need to create a script named server.php with the following content:

<?php
declare(strict_types=1);
require_once "./vendor/autoload.php";
use Swoole\Http\Request;
use Swoole\Http\Response;
use Swoole\Http\Server;
use Swoole\Constant;
$config = json_decode(file_get_contents('./config.json'));
$http = new Server("0.0.0.0", 9501);
$http->set(
    [
        Constant::OPTION_WORKER_NUM => 2,
        Constant::OPTION_TASK_WORKER_NUM => (swoole_cpu_num()) * 10,
    ]
);

$app = new \Sidalex\SwooleApp\Application($config);
$http->on(
    "start",
    function (Server $http) use ($app) {
        echo "Swoole HTTP server is started.\n";
        $app->initCyclicJobs($http);
    }
);
$http->on(
    "request",
    function (Request $request, Response $response) use ($app,$http) {
        $app->execute($request, $response,$http);
    }
);
$http->on(
    'task',
    function (Server $server, $taskId, $reactorId, $data) use ($app) {
        return $app->taskExecute($server, $taskId, $reactorId, $data);
    }
);
$http->start();

The $config variable should be \stdClass and can contain parameters described here.

To run background processes that should execute periodically (not triggered by user action but by scheduler), the CyclicJobsInterface is implemented. For a more detailed description of its usage, see here. To automatically start background cyclic processes, they need to be specified in the config here.

To create application endpoints, you need to create controllers classes. For each endpoint, you need to create your own class. Alternatively, create your own routing rule via notFoundController.

All operations inside CyclicJobs and controllers must be non-blocking. Otherwise, instead of increasing performance, you may lose it significantly, and the next request will not be processed until the blocking operation is completed.

All blocking operations must be wrapped in TaskExecutorInterface and executed as separate Task.

Config

To run the application, you need to create a stdClass with a set of properties (described in more detail below).

The intended use is to initiate configuration data from a json file, see example server.php

$config = json_decode(file_get_contents('./config.json'));

List of config parameters

$config = new stdClass();
$config->notFoundController = 'appNameSpaceMyApp\MyNotFoundController';
$config->controllers = [
'appNameSpaseMyApp\MyFirstControllerNamespace',
'appNameSpaseMyApp\MySecondControllerNamespace',
'appNameSpaseMyApp\MyThreeControllerNamespace',
];
$config->CyclicJobs =[
'appNameSpaseMyApp\MyFirstCyclicJobsClass',
'appNameSpaseMyApp\MySecondCyclicJobsClass',
'appNameSpaseMyApp\MyThreeCyclicJobsClass',
];

notFoundController - a string with the class that handles routes not found by the default flow. This class must implement Sidalex\SwooleApp\Classes\Controllers\ControllerInterface.

controllers - an array of namespaces in which the search for Controller classes (implementing the Sidalex\SwooleApp\Classes\Controllers\ControllerInterface interface) will be carried out recursively. Additionally, for controller class implementation, inheritance from AbstractController can be used. For more details, see here.

CyclicJobs - an array of classes implementing the CyclicJobsInterface interface which are launched when the application starts and executed cyclically at a certain interval of time. For more details, see here.

Task

Tasks represent processes that run outside of the asynchronous execution process and can be invoked from any part of the application.

To simplify working with tasks and standardize their execution within the framework, a mechanism has been added to initiate these processes. To use this mechanism when starting the Swoole server (server.php), you need to add the following code block:

$http->on(
    'task',
    function (Server $server, $taskId, $reactorId, $data) use ($app) {
        return $app->taskExecute($server, $taskId, $reactorId, $data);
    }
);

If this code block is not initiated, the framework won't be able to work with the BasicTaskData class and the TaskDataInterface interface.

These processes may contain blocking operations.

To run a task, you need to create an object of the BasicTaskData class or use your own class implementing the TaskDataInterface interface. Learn more here.

Methods:

task

Task Runs a task without waiting for its completion.

Swoole\Server->task(Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface $data, int $dstWorkerId = -1, callable $finishCallback = null);

$data: An object implementing the Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface. By default, the BasicTaskData class is recommended. Learn more here.

$dstWorkerId: Worker process ID. If not provided, Swoole server will choose a random and unoccupied worker process for you.

$finishCallback: A callback to be executed before the task finishes. This parameter is optional.

taskwait

Taskwait Runs a task with waiting for its completion and getting the result. Result waiting is done in a non-blocking manner. Tasks can be launched from the controller.

$result = Swoole\Server->taskwait((Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface $data, float $timeout = 0.5, int $dstWorkerId = -1) :TaskResulted

$data: An object implementing the Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface. By default, the BasicTaskData class is recommended. Learn more here.

$timeout: Timeout period for task completion in seconds. If the timeout is reached, false will be returned. Minimum value is 1 ms.

$dstWorkerId: Worker process ID. If not provided, Swoole server will choose a random and unoccupied worker process for you.

$result: The result of the task execution, should be an instance of the TaskResulted class. Learn more here.

BasicTaskData

The BasicTaskData class is a part of Sidalex\SwooleApp framework and can be found in the Classes\Tasks\Data directory. It is used for creating task data to be executed by Swoole Task Worker.

Usage Create an instance of BasicTaskData and pass two parameters to the constructor:

The name of the class that will be created in the task for execution. This class must implement the TaskExecutorInterface interface. An array of context data required for executing the logic contained in the task class.

$taskData = new BasicTaskData('Sidalex\TestSwoole\Tasks\TestTaskExecutor', ['test' => 'test1']);

$taskData object can then be passed to the taskwait() method of the Swoole Server to execute the task synchronously and get the result.

$taskResult = $this->server->taskwait($taskData);
var_export($taskResult->getResult());

Parameters

Class Name - The first parameter is a string representing the name of the class that will be created in the task for execution. This class must implement the TaskExecutorInterface interface.

Context Data - The second parameter is an associative array of data required for executing the logic contained in the task class.

Example

$taskData = new BasicTaskData('Sidalex\TestSwoole\Tasks\TestTaskExecutor', ['test' => 'test1']);
        /**
         * @var $taskResult TaskResulted
         */
        $taskResult =  $this->server->taskwait($taskData);
        var_export($taskResult->getResult());

TaskResulted

Description: The TaskResulted class represents the result of task execution. It contains information about whether the task was successfully executed and its result.

Properties:

$success - a private property containing information about the success of the task execution.

$result - a private property containing the result of the task execution.

__construct(mixed $inData, bool $success = true) - the class constructor, accepting input data and information about the success of the task execution.

Methods:

getResult(): mixed - a method returning the result of the task execution. It may throw a TaskException exception.

isSuccess(): bool - a method returning information about the success of the task execution.

Example:

$taskData = new BasicTaskData('Sidalex\TestSwoole\Tasks\TestTaskExecutor', ['test' => 'test1']);
/**
* @var $taskResult TaskResulted
*/
$taskResult =  $this->server->taskwait($taskData);
var_export($taskResult->getResult());

Cyclic Job

This is the code that requires periodic execution. This mechanism allows you to run scripts at regular intervals. It replaces cron.

To initialize Cyclic Job, you need to declare the CyclicJobs parameter in the configuration file.

Example initialization of config using stdClass:

$config = new stdClass();
$config->CyclicJobs =[
"Sidalex\TestSwoole\CyclicJobs\TestCyclicJobs",
];

Example initialization of config using a json file:

{
"CyclicJobs": [
"Sidalex\\TestSwoole\\CyclicJobs\\TestCyclicJobs"
]
}

Example class for Cyclic Job:

class MyCyclicJob implements CyclicJobsInterface
{
private $application;
private $server;

    public function __construct(Application $application, Server $server)
    {
        $this->application = $application;
        $this->server = $server;
    }

    public function getTimeSleepSecond(): float
    {
        // Returns the sleep time in seconds
        return 5.0;
    }

    public function runJob(): void
    {
        $arr = [1,2,3,4,5,6,7,8,9];
        foreach ($arr as $value){
            if($value % 3 == 0)
            {
                echo "example";
            }
        }
    }
}

Any class specified in the config must implement the CyclicJobsInterface interface.

getTimeSleepSecond - returns the time in seconds at which the runJob method will be executed periodically.

runJob - a method that contains the useful payload in terms of business logic. This is the code that contains the main business logic that should be executed cyclically.

Controller

To create new routes, the Controller class is used. To add a new route, you need to create a class that implements the ControllerInterface interface and add the namespace in which this class is contained to the configuration file with the key "controllers". More details here

Also, the framework has a special abstract class AbstractController that can simplify the creation of a Controller class.

To create a Route for the Controller class, you need to specify an attribute of the following form:

#[\Sidalex\SwooleApp\Classes\Controllers\Route(uri: '/api/{v1}/get_resume',method:"POST")]
class TestController extends AbstractController
{

use Sidalex\SwooleApp\Classes\Controllers\Route;

#[Route(uri: '/api/{v1}/get_resume',method:"POST")]
class TestController extends AbstractController
{

It is critically important that the attribute be specified first for this class.

If no suitable controller is found, the NotFoundController will be called.

uri attribute parameter

uri - this parameter determines for which route this controller will be used.

If you specify a * in the route, for example, /test/version/*/items, then this controller will work for uris corresponding to /test/version/(any string)/items.

If you specify /test/version/{version_number}/items in the route, the behavior will be similar to the behavior with *, but $uri_params['version_number'] will be added to the controller constructor.

method attribute parameter

method - shows which method will be relevant for calling this controller.

Request processing

The Controller class execute method contains the main business logic that the application should perform for this request. This method must return a response (\Swoole\Http\Response), which is contained in

$this->response

Response

In the Controller class:

$this->response

For a more detailed description of the methods of this class, see the official documentation Swoole

Example of use:

$this->response->setHeader('Content-Type', 'application/json');
$this->response->end(
                json_encode(
                 [
                     'status' => 'error',
                     'message' => 'collection '.$this->uri_params['collection_name'] . 'not found in collectionList',
                 ]
                )
            );

Request

In the Controller class:

$this->request;

For a more detailed description of the methods of this class, see the official documentation Swoole

Example of use:

$obj = json_decode($this->request->getContent());

notFoundController

It is designed to process routes that have not been found by the framework router, to issue a 404 response, or to organize the unique routing logic of the application.

To initialize, you need to pass the class name in the config. more details about this here

The notFoundController must implement the ControllerInterface

example:

class NotFoundController implements ControllerInterface
{

    private \Swoole\Http\Request $request;
    private \Swoole\Http\Response $responce;
    /**
     * @var array|string[]
     */
    private array $uri_params;

    public function __construct(\Swoole\Http\Request $request, \Swoole\Http\Response $response, array $uri_params=[])
    {
        $this->request = $request;
        $this->responce = $response;
        $this->uri_params = $uri_params;
    }

    public function execute(): \Swoole\Http\Response
    {
        $this->responce->setStatusCode(404);
        $this->responce->setHeader('Content-Type', 'application/json');
        $this->responce->end(json_encode(
            [
                'codeStatus' => '404',
                'text' => 'Page not found'
            ]
        ));
        return $this->responce;
    }

    public function setApplication(Application $application, Server $server)
    {

    }
}

sidalex/swoole-app фреймворк для работы со swoole

Установка
Config
1. Список параметров конфига
Task
1. Методы:
BasicTaskData
Класс TaskResulted
1. Свойства:
2. Методы:
Cyclic Job
Controller
notFoundController

Установка

Для утсановки выполните следующие команды:

composer require sidalex/swoole-app

Для запуска приложения свули необходимо создать скрипт server.php следующего содержания:

<?php
declare(strict_types=1);
require_once "./vendor/autoload.php";
use Swoole\Http\Request;
use Swoole\Http\Response;
use Swoole\Http\Server;
use Swoole\Constant;
$config = json_decode(file_get_contents('./config.json'));
$http = new Server("0.0.0.0", 9501);
$http->set(
    [
        Constant::OPTION_WORKER_NUM => 2,
        Constant::OPTION_TASK_WORKER_NUM => (swoole_cpu_num()) * 10,
    ]
);

$app = new \Sidalex\SwooleApp\Application($config);
$http->on(
    "start",
    function (Server $http) use ($app) {
        echo "Swoole HTTP server is started.\n";
        $app->initCyclicJobs($http);
    }
);
$http->on(
    "request",
    function (Request $request, Response $response) use ($app,$http) {
        $app->execute($request, $response,$http);
    }
);
$http->on(
    'task',
    function (Server $server, $taskId, $reactorId, $data) use ($app) {
        return $app->taskExecute($server, $taskId, $reactorId, $data);
    }
);
$http->start();

Переменная $config должна быть \stdClass и может содержать параметры писанные тут

Для запуска фоновых процессов, которые должны исполняться периодичски (не от действия пользователя а по планировщику) реализован интерфейс CyclicJobsInterface более подробное описание его использования тут. Для Автоматического запуска фоновых циклических процессов их необходимо указать в конфиге тут.

Для создания Эндпойнов приложения необходимо создать классы контроллеры, для каждого эндпойнта необходимо создать свой класс. Либо создать свое правило маршрутизации через notFoundController.

Все операции внутри CyclicJobs и controllers должны быть не блокирующими в противном случае вместо прироста производительности вы можете сильно потерять в ней и следующий запрос не будет обработан, пока блокирующая операция не будет выполнена.

Все блокирующие операции необходимо оборачивать в TaskExecutorInterface и выполнять отдельными Task.

Конфиг

Для запуска приложения необходимо создать stdClass с набором свойств(далее описаны более поробно)

Целевым использованием считается инициация конфигурационных данных из файла json смоттри пример server.php

$config = json_decode(file_get_contents('./config.json'));

Список параметров конфига

$config = new stdClass();
$config->notFoundController = 'appNameSpaceMyApp\MyNotFoundController';
$config->controllers = [
    'appNameSpaseMyApp\MyFirstControllerNamespace',
    'appNameSpaseMyApp\MySecondControllerNamespace',
    'appNameSpaseMyApp\MyThreeControllerNamespace',
];
$config->CyclicJobs =[
    'appNameSpaseMyApp\MyFirstCyclicJobsClass',
    'appNameSpaseMyApp\MySecondCyclicJobsClass',
    'appNameSpaseMyApp\MyThreeCyclicJobsClass',
];

notFoundController - строка класс с классом , который обрабатывает роуты не найденные по стандартному флоу, данный клас должен имплементировать Sidalex\SwooleApp\Classes\Controllers\ControllerInterface

controllers - массив namespace в которых рекурсивно удет осуществляться поиск классов Контроллеров(имплементирующих интерфейс Sidalex\SwooleApp\Classes\Controllers\ControllerInterface) так же для реализации класса контроллера можно испрользовать наследование AbstractController более подробно тут.

CyclicJobs - мкассив слассов , которые имплементируют интерфейс CyclicJobsInterface которы запускаются при стапрте приложения и выполняются циклично раз в определенный интервал времени подробнее тут

Task Задача

Tasks (задачи) представляют собой процессы, которые выполняются вне асинхронного процесса выполнения и могут быть вызваны в любой части приложения.

Для упрощения работы с задачами и стандартизации их выполнения в рамках фреймворка был добавлен механизм, позволяющий инициировать эти процессы. Для использования этого механизма при запуске сервера Swoole(server.php) необходимо добавить следующий блок кода:

$http->on(
    'task',
    function (Server $server, $taskId, $reactorId, $data) use ($app) {
        return $app->taskExecute($server, $taskId, $reactorId, $data);
    }
);

Если данный блок кода не будет инициирован, то фреймворк не сможет работать с классом BasicTaskData и интерфейсом TaskDataInterface.

В этих процессах могут содержаться блокирующие операции.

Для запуска задачи необходимо создать объект класса BasicTaskData или использовать собственный класс, реализующий интерфейс TaskDataInterface. Подробнее здесь.

Методы Task:

task: запускает задачу без ожидания её завершения.

Swoole\Server->task(Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface $data, int $dstWorkerId = -1, callable $finishCallback = null)

$data: объект, реализующий интерфейс Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface. По умолчанию предлагается использовать класс BasicTaskData. Подробнее здесь.

$dstWorkerId: идентификационный номер рабочего процесса. Если параметр не передан, сервер Swoole выберет для вас случайный и незанятый рабочий процесс.

$finishCallback: колбэк, который будет выполнен перед завершением задачи. Параметр необязателен.

taskwait - запуск ззадачи с ожитанием завершения и получения результата. ожидание результата происходит неблокирующим образом. задачи можно запускать из контоллера.

$result = Swoole\Server->taskwait((Sidalex\SwooleApp\Classes\Tasks\Data\TaskDataInterface $data, float $timeout = 0.5, int $dstWorkerId = -1) :TaskResulted

$timeout: время ожидания завершения задачи в секундах. Если истекает время ожидания, будет возвращено значение false. Минимальное значение - 1 мс.

$result: результат выполнения задачи, должен быть экземпляром класса TaskResulted. Подробнее здесь.

Класс BasicTaskData

#Sidalex\SwooleApp\Classes\Tasks\Data\BasicTaskData
$taskData = new BasicTaskData('Sidalex\TestSwoole\Tasks\TestTaskExecutor', ['test' => 'test1']);

В котором в конструкторе передается 2 параметра

1 параметр ('Sidalex\TestSwoole\Tasks\TestTaskExecutor') - это название класса, который будет создан в задаче для исполнения. Он должен имплементировать интерфейс TaskExecutorInterface

2 параметр ( ['test' => 'test1'] ) - это массив с данными контекста, который необходим для исполнения логики содержащейся в классе задачи ('Sidalex\TestSwoole\Tasks\TestTaskExecutor' для примера)

Пример применения например в контроллере или в Cyclic Job:

$taskData = new BasicTaskData('Sidalex\TestSwoole\Tasks\TestTaskExecutor', ['test' => 'test1']);
        /**
         * @var $taskResult TaskResulted
         */
        $taskResult =  $this->server->taskwait($taskData);
        var_export($taskResult->getResult());

Класс TaskResulted

Описание: Класс TaskResulted представляет собой результат выполнения задачи. Он содержит информацию о успешном выполнении задачи и её результате.

Свойства TaskResulted:

$success - приватное свойство, содержащее информацию о успешном выполнении задачи.

$result - приватное свойство, содержащее результат выполнения задачи.

__construct(mixed $inData, bool $success = true) - конструктор класса, принимающий входные данные и информацию о успешном выполнении задачи.

Методы TaskResulted:

getResult(): mixed - метод, возвращающий результат выполнения задачи. Может выбрасывать исключение типа TaskException.

isSuccess(): bool - метод, возвращающий информацию о успешном выполнении задачи.

Пример:

$taskData = new BasicTaskData('Sidalex\TestSwoole\Tasks\TestTaskExecutor', ['test' => 'test1']);
/**
* @var $taskResult TaskResulted
*/
$taskResult =  $this->server->taskwait($taskData);
var_export($taskResult->getResult());

Класс Cyclic Job

Этот код требует периодического выполнения. Этот механизм позволяет запускать скрипты с регулярными интервалами. Он заменяет cron.

Для инициализации Cyclic Job необходимо объявить параметр CyclicJobs в файле конфигурации.

Пример инициализации конфига с использованием stdClass:

$config = new stdClass();
$config->CyclicJobs = [
    "Sidalex\TestSwoole\CyclicJobs\TestCyclicJobs",
];

Пример инициализации конфига с использованием файла json:

{
  "CyclicJobs": [
    "Sidalex\\TestSwoole\\CyclicJobs\\TestCyclicJobs"
  ]
}

Пример класса для Cyclic Job:

class MyCyclicJob implements CyclicJobsInterface
{
    private $application;
    private $server;

    public function __construct(Application $application, Server $server)
    {
        $this->application = $application;
        $this->server = $server;
    }

    public function getTimeSleepSecond(): float
    {
        // Возвращает время задержки в секундах
        return 5.0;
    }

    public function runJob(): void
    {
        $arr = [1,2,3,4,5,6,7,8,9];
        foreach ($arr as $value){
            if($value % 3 == 0)
            {
                echo "example";
            }
        }
    }
}

Любой класс, указанный в конфиге, должен реализовывать интерфейс CyclicJobsInterface.

Метод getTimeSleepSecond возвращает время в секундах, через которое будет выполняться метод runJob периодически.

Метод runJob содержит полезную нагрузку в плане бизнес-логики. Это метод содержит бизнес-логику, которая должна выполняться циклически.

Класс Controller

Для создания новых маршрутов используется класс Controller. Чтобы добавить новый маршрут, вам необходимо создать класс, реализующий интерфейс ControllerInterface, и добавить пространство имен, в котором содержится этот класс, в файл конфигурации с ключом "controllers". Подробнее здесь

Также в фреймворке есть специальный абстрактный класс AbstractController, который может упростить создание класса Controller.

Чтобы создать маршрут для класса Controller, вам необходимо указать атрибут следующего вида:

#[\Sidalex\SwooleApp\Classes\Controllers\Route(uri: '/api/{v1}/get_resume',method:"POST")]
class TestController extends AbstractController
{

или

use Sidalex\SwooleApp\Classes\Controllers\Route;

#[Route(uri: '/api/{v1}/get_resume',method:"POST")]
class TestController extends AbstractController
{

Крайне важно, чтобы сначала был указан атрибут для этого класса.

Если подходящий контроллер не найден, будет вызван NotFoundController.

uri атрибутивный параметр

uri - этот параметр определяет, для какого маршрута будет использоваться данный контроллер.

Если вы укажете * в маршруте, например, /test/version/*/items, то этот контроллер будет работать для uri, соответствующих /test/version/(любая строка)/items.

Если вы укажете /test/version/{version_number}/элементы в маршруте, поведение будет аналогично поведению с *, но $uri_params['version_number'] будет добавлен в конструктор контроллера.

параметр атрибута

method - показывает, какой метод будет уместен для вызова данного контроллера.

Обработка запроса

Метод execute класса Controller содержит основную бизнес-логику, которую приложение должно выполнить для этого запроса. Этот метод должен возвращать ответ (\Swoole\Http\Response), который содержится в

$this->response

Response

В классе Controller:

$this->response

Более подробное описание методов этого класса смотрите в официальной документации Swoole

Пример использования:

$this->response->setHeader('Content-Type', 'application/json');
$this->response->end(
                json_encode(
                 [
                     'status' => 'error',
                     'message' => 'collection '.$this->uri_params['collection_name'] . 'not found in collectionList',
                 ]
                )
            );

Запрос

В классе контроллера:

$this->request;

Более подробное описание методов этого класса смотрите в официальной документации Swoole

Пример использования:

$obj = json_decode($this->request->getContent());

notFoundController

Предназначен для обработки роутов, которые не были найдены роутером фреймворка, для выдачи ответа 404 или организации уникальной логики роутинга приложения.

Для инициализации необходимо передать имя класса в конфиге более подробно об этом тут

notFoundController должен имплементировать ControllerInterface

пример:

class NotFoundController implements ControllerInterface
{

    private \Swoole\Http\Request $request;
    private \Swoole\Http\Response $responce;
    /**
     * @var array|string[]
     */
    private array $uri_params;

    public function __construct(\Swoole\Http\Request $request, \Swoole\Http\Response $response, array $uri_params=[])
    {
        $this->request = $request;
        $this->responce = $response;
        $this->uri_params = $uri_params;
    }

    public function execute(): \Swoole\Http\Response
    {
        $this->responce->setStatusCode(404);
        $this->responce->setHeader('Content-Type', 'application/json');
        $this->responce->end(json_encode(
            [
                'codeStatus' => '404',
                'text' => 'Page not found'
            ]
        ));
        return $this->responce;
    }

    public function setApplication(Application $application, Server $server)
    {

    }
}

sidalex / swoole-app

Maintainers

Details

README

sidalex/swoole-app Framework for Working with Swoole

Install

Config

List of config parameters

Task

Methods:

task

taskwait

BasicTaskData

Parameters

TaskResulted

Properties:

Cyclic Job

Controller

uri attribute parameter

method attribute parameter

Request processing

Response

Request

notFoundController

sidalex/swoole-app фреймворк для работы со swoole

Установка

Конфиг

Список параметров конфига

Task Задача

Методы Task:

Класс BasicTaskData

Класс TaskResulted

Свойства TaskResulted:

Методы TaskResulted:

Класс Cyclic Job

Класс Controller

uri атрибутивный параметр

параметр атрибута

Обработка запроса

Response

Запрос

notFoundController