Шаблоны интерфейсов в FBI.

Основные принципы

Основная работа по созданию интерфейсов в FBI состоит в связывании бакендов с формами HTML. Формы описываются при помощи так называемых шаблонов. Существует два основных приёма работы:
1. Связывание шаблона с URL. При обращении Web-браузера по данному URL происходит запуск связанного с ним шаблона и генерация требуемых форм.
2. Регистрация шаблона по имени. При обращении Web-браузера по данному URL происходит запрос бакенда-спутника (с префиксом template) с именем равным первой компоненте пути. Например при обращении по URL a/b/c запрашивается бакенд template-a. У бакенда выясняется (через вызов операции template) имя шаблона и параметры к нему после чего собственно и производится запуск требуемого шаблона и передаются ему требуемые параметры.

Замечание: путь / приравнивается к /index.
Замечание: при наличии двух вариантов одновременно система отдаёт предпочтение первому.

Второй способ удобен в случае когда администратор выполняет некоторую типовую задачу, совершенно не хочет задумываться о создании какого-либо интерфейсного шаблона, но отлаживать желает уже в некотором интерфейсе. Существуют два заранее подготовленных шаблона: object (для работы со свойствами объекта), list (для работы с группой объектов). В этом варианте работы возможно не создавать отдельного бакенда, а разместить обработку операции template и связанных с ней в основном бакенде и сделать на него символическую ссылку с именем template-<бакенд>.

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

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

Замечание: В связи с последним предложением – заказывайте шаблоны, если они будут чётко формализованные – сделаем и добавим в пакет.

Создание и регистрация шаблонов

Файл шаблона размещается в каталоге /usr/share/alterator/templates/. Описание шаблона представляет собой маленькую программу на языке програмирования Scheme (нет никаких проблем в будущих версиях сделать возможной разработку шаблонов на произвольных языках программирования)

Каждый шаблон представляет собой функцию, в результате исполнения которой получается строка – она и отдаётся в качестве ответа Web-браузеру.

Регистрация шаблона по имени:

• (register-get-template <name> <name-template-proc) – регистрация процедуры-обработчика запросов <name-template-proc> как шаблона с именем <name>. Данная процедура будет вызываться в случае запроса GET.
• (register-post-template <name> <name-template-proc>) – регистрация процедуры-обработчика запросов <name-template-proc> как шаблона с именем <name>. Данная процедура будет вызываться в случае запроса POST.

Каждая продедура <name-template-proc> принимает следующие параметры:

• url – URL по которому было произведено обращение
• url-args – параметры запроса. В случае запроса POST url-args также включают в себя данные формы. В случае наличия одинаковых параметров в строке запроса и в форме предпочтение отдаётся вторым.
• template-args – параметры шаблона, переданные бакендом-спутником.