Руководство по настройке altAwin:HTTP-обработчики

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

HTTP-запросы инициируют выполнение скриптов обработчиков. Выбор обработчика зависит HTTP-метода и URL запроса.

• Наименование — название обработчика
• HTTP-метод
• Шаблон пути — строка, используемая для сопоставления с путём в запросе
• Таймаут, мс — максимальное время исполнения скрипта
• Активен — переключатель активности обработчика
• Комментарий — текстовый комментарий

На вкладке Cкрипт приводится текст сценария, который должен быть выполнен при получении соответствующего HTTP-запороса.

В контексте скрипта доступные переменные:

• Request - объект запроса;
• Args - значения подстановок ;
• Response - объект ответа.

Задание шаблонов путей

Шаблон пути — это строка, содержащая подстановки, для которых используются фигурные скобки. Подстановка {test} задаёт имя test с регулярным выражением по умолчанию [^/]+. Чтобы задать собственное регулярное выражение следует использовать синтаксис: {test:[0-9]+}.

Некоторые примеры задания шаблонов:

/user/{id:\d+}
/user/{name}
/user/{name:.+}

Регулярные выражения для подстановок не могут использовать группы захвата. Например {lang:(en|de)} недопустимо, потому что (en|de) - это группа захвата, вместо этого можно написать {lang:en|de}.

Существует возможность задания опциональных частей пути, заключаемых в квадратные скобки. Например /del[ete] будет срабатывает для /del и /delete. Опциональные части допустимы только в конце маршрута:

шаблон

/user/{id:\d+}[/{name}]

эквивалентен

/user/{id:\d+}
/user/{id:\d+}/{name}

множественные вложенные опциональные части

/user[/{id:\d+}[/{name}]]

недопустимо, поскольку в середине шаблона

/user[/{id:\d+}]/{name}

Настройка сервера диспетчеризации

см РПА:Установка AltawinServer

Настройка порта и выбор сетевого интерфейса можно задавать в параметрах файла AltawinSvc.conf:

• http_server_ip - ip адрес сетевого адаптера,
• http_server_port - порт, который будет слушаться сервером.