6.1.1. Конфигурационный каталог

Каталог конфигурации предназначен для размещения ресурсов, дополняющих и переопределяющих свойства приложения, пользовательский интерфейс и бизнес-логику после развертывания приложения. Переопределение обеспечивается механизмом загрузки интерфейса инфраструктуры Resources, который сначала выполняет поиск в конфигурационном каталоге, а потом в CLASSPATH, так что одноименные ресурсы в конфигурационном каталоге имеют приоритет над расположенными в JAR-файлах и каталогах классов.

Конфигурационный каталог может содержать следующие типы ресурсов:

  • Файл local.app.properties, определяющий параметры развертывания блоков приложения, работающих под управлением веб-сервера.

  • Конфигурационные файлы metadata.xml, persistence.xml, views.xml, remoting-spring.xml.

  • XML-дескрипторы экранов UI.

  • Контроллеры экранов UI в виде исходных текстов Java или Groovy.

  • Скрипты или классы Groovy, а также исходные тексты классов Java, используемые приложением через интерфейс Scripting.

Расположение конфигурационного каталога определяется свойством приложения cuba.confDir. Для блоков Middleware, Web Client и Web Portal в варианте быстрого развертывания в Tomcat это подкаталог с именем веб-приложения в каталоге tomcat/conf, например tomcat/conf/app-core для Middleware.