Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

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

Пользовательские JSP страницы располагайте в каталогах WEB-INF/jspf/.../custom/.., это гарантирует вас от перетирания названия каталога штатными шаблонами. Например: "/WEB-INF/jspf/user/process/process/custom/process_jur/zayavka.jsp".

Вкратце схема работы JSP шаблона представлена на схеме ниже.

На вход шаблона передаётся объект Request. Изначально это чаще всего HTTP запрос с параметрами, но в общем и целом это просто некий Map c Java объектами. По мере обработки запроса в этот Map помещаются:

Любой объект в Request доступен в JSP шаблоне как ${object}. Для вызова метода ${object.method()}. На выходе шаблона образуется по сути текст, который указан в шаблоне, за исключением специальных инструкций. Это может быть HTML, передаваемый на клиента, либо простой текст. Специальные инструкции, оперируя с объектами из Request, добавляют в этот текст дополнительные данные.

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

Обзор использования тегов с элементами управления пользователя вы можете посмотреть в файле webapps/test.jsp, для выполнения шаблона наберите в браузере http://<host>:<port>/test.jsp. Полный обзор библиотеки BGCRM вы можете получить в файлах объявлениях webapps/WEB-INF/tld/...

Создание произвольных Java объектов

Хотелось бы особо отметить следующую возможность. Создание произвольного Java объекта, использование параметризованного конструктора, что не позволяет стандартный тег <bean>. Данный подход позволяет существенно уменьшить использование скриплетов (вставок Java кода).

Изменение данных в Request

Шаблон может менять объекты в Request. Этот немного нестандартный метод используется в плагине Document для подготовки шаблоном структурированных данных, вставляемых в дальнейшем в шаблоны документов PDF либо DOCX/ODT.

Ссылки:

  • Нет меток
Документация BGCRM 3.0