Использование ant

Помимо использования IDE основной be4-функционал доступен с помощью ant-таргетов.

Стандартные таргеты

В проектах на be4 определены следующие ant-таргеты:

• be.validate — валидация проекта (вычитывание всех файлов, базовые проверки на корректность, исполнение всего Freemarker; никаких обращений к базе не делается)
• be.update — инкрементальное обновление схемы, метаданных и локализаций. Если обновление схемы может привести к потере данных, операция будет отклонена. Для принудительного выполнения определите BE4_FORCE_UPDATE=true
• be.meta — инкрементальное обновление метаданных (включая roles, icons, references, page customizations, pages)
• be.locale — инкрементальное обновление локализаций
• be.ddl — инкрементальное обновление схемы. Для принудительного выполнения определите BE4_FORCE_UPDATE=true.
• be.ddl.check — вывод SQL-предложений, которые потребуются для инкрементального обновления схемы. Никаких изменений в базу не вносится.
• setup.db — полное разворачивание базы с нуля (как в BE)
• setup.meta — полное внесение метаданных и локализаций
• setup.just.meta — полное внесение метаданных
• setup.locale — полное внесение локализаций
• setup.adhoc — выполнение одного или нескольких FTL-скриптов из custom steps (передаются параметром -DA_SCRIPT='script1;script2'). Можно запускать скрипты из модуля (-DA_SCRIPT='realty:dictionaries') либо из всех модулей, где такой скрипт есть (-DA_SCRIPT='all:dictionaries')
• main (таргет по умолчанию) — сборка war

Переменные

Имеются следующие BE4-специфичные переменные

• BE4_DIR — каталог с проектом be4 (без него ничего не заработает)
• BE4_PROFILE — если задано, указывает профиль соединения к базе данных (из connectionProfiles.*.yaml), который необходимо использовать.
• BE4_LOG_DIR — если задано, данный каталог будет использован для логирования BE4-операций.
• BE4_DEBUG — если "true", будет выводиться дополнительная отладочная информация в stderr.
• BE4_FORCE_UPDATE — если "true", будут выполняться потенциально опасные изменения в схеме базы данных (которые могут привести к потере пользовательских данных).
• BE4_UNLOCK_PROTECTED_PROFILE — если "true", защищённый (protected) профиль соединения будет использоваться без дополнительных подтверждений.

• BE4_<имя_модуля> — если true, то будут использованы метаданные из BE4-модуля (BE4-модуль должен существовать), иначе — из старого BE-модуля с тем же именем.

Только с таргетом be.validate:

• BE4_RDBMS=mysql/postgres/oracle/db2/sqlserver/m4 — если задано, валидация будет выполняться с использованием соответствующей СУБД (это может повлиять на выполнение условных секций в FTL, результат разворачивания макросов, включения extras и т. д.).
• BE4_CHECK_QUERY="entity.query" — если задано, текст указанного запроса после выполнения FTL будет выведен на экран). Если указана фиктивная BE4_RDBMS=m4, на место СУБД-специфичных FTL-функций будут подставлены соответствующие m4-функции (может пригодиться для обратного портирования кода в m4).
• BE4_CHECK_DDL=entity — если задано, DDL, необходимый для создания указанной сущности будет выведен на экран. Если указана фиктивная BE4_RDBMS=m4, будет сгенерирован соответствующий m4-код (может пригодиться для обратного портирования кода в m4).
• BE4_CHECK_ROLES=true — если задано, на экран будет выведен список ролей проекта, действующий в данных условиях. Может пригодиться, если часть ролей устанавливается условно через extras и хочется проверить, правильно ли отработали условия.
• BE4_CREATE_PROFILE_PROPERTIES=<file_path> — создаёт файл properties со свойствами профиля соединения и проекта, который может пригодиться для старой системы тестирования.
• BE4_SAVE=true — если задано, проект будет пересохранён (только основной проект, без учёта подключенных модулей) с помощью той же процедуры, как при сохранении через Eclipse. Могут быть отсортированы или переформатированы некоторые элементы проекта.

Задачи

При редактировании ant-скриптов можно использовать следующие задачи (tasks):

• be4.db — создание базы по BE4-проекту. Параметры:

• modules: если true, будут использованы BE4-модули

• be4.meta — синхронизация. Параметры:

• modules: если true, будут использованы BE4-модули
• mode: режим синхронизации (all, meta, locale, ddl, security)

• be4.data — выполнение скрипта или набора скриптов. Параметры:

• scriptName: имена скриптов через точку с запятой. Можно написать moduleName:scriptName для выполнения скрипта из модуля, либо all:scriptName для выполнения скрипта с таким именем из всех модулей.

• be4.validate — валидировать BE4-проект и (для немодульного проекта) заполнить свойства ANT из модели
• be4.tools — дополнительный инструментарий BE4.

У всех задач есть общие параметры:

• projectPath (обязательно) — путь к проекту
• logDir — каталог для логирования (переопределяет переменную BE4_LOG_DIR)

Инструментарий

Для технических операций имеется специальная ant-задача be4.tools. По умолчанию эта задача не соответствует никакому ant-таргету. Если она требуется, можно создать таргет, например, так:

<target name="be.tools" depends="be4_settings"><be4.tools projectPath="${project.home}"/></target>

Для пользования инструментами необходимо задавать дополнительные свойства:

• BE4_DUMP_TABLES="таблица1,таблица2,..." — сдампить из базы соответствующей текущему connection-profile заданные таблицы в новый yaml-проект (будет создан подкаталог yamlDump в текущем каталоге). Может пригодиться для создания болванки при переносе таблиц из m4 в yaml. Пример:

ant be.tools -DBE4_PROFILE=foo -DBE4_DUMP_TABLES=users,queries,operations

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

Для компиляции самого BE4 (в объёме необходимом для последующего использования вышеуказанных ant-таргетов) необходимо набрать ant в каталоге be4/src. Не требуется никаких внешних зависимостей.

Использование вне приложений

Следующие цели можно запускать без какого-либо приложения, т.е. досаточно просто зайти в папку be4/src и написать "ant someTarget":

• wizard — позволяет генерировать новые BE4 приложения. Функционал аналогичен функционалу создания нового приложения в BEclipse (File → New → Project → BeanExplorer → BeanExplorer Project), однако все данные вводятся в консоли, а не в GUI.