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

Материал из AltecDocs
Версия от 15:52, 2 марта 2023; imported>Kirillche (save from wiki docs editor)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к:навигация, поиск

В разделе настраиваются 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 - порт, который будет слушаться сервером.