Использовать файлы описания Java EE для определения ссылок на среду

Это правило отмечает элементы Context <Environment> в файле META-INF/context.xml, которые необходимо преобразовать в элементы <env-entry> в файле WEB-INF/web.xml.

Apache Tomcat позволяет определять элементы Context <Environment> в следующих расположениях:

Так как инструмент миграции может не иметь доступа к каталогу конфигурации Tomcat, то он помечает только элементы Context <Environment> в файле META-INF/context.xml. Информация Context <Environment>, определенная в других расположениях, может быть скопирована в файл META-INF/context.xml для обработки инструментом.

Если файл WEB-INF/web.xml существует в веб-проекте:

Элементы Context <Environment> будут помечены, если выполнено любое из следующих условий:

В сканере исходного кода доступно быстрое исправление для этого правила. Процедура быстрого исправления добавляет новый элемент <env-entry> в файл web.xml, который представляет элемент Context <Environment>, при его отсутствии в файле web.xml. Если запись существует, она будет обновлена.

Если файл WEB-INF/web.xml не существует:

Будут помечены все элементы Context <Environment>.

Процедура быстрого исправления создаст файл WEB-INF/web.xml, включающий соответствующие элементы <env-entry> (если веб-проект создан в Java EE версии 5 и выше), или выведет сообщение об ошибке (если веб-проект создан в J2EE 1.4 или ниже).

Пример: существует файл META-INF/context.xml со следующим содержимым:
<Environment
description="Trigger because it does not exist"
name="newEntry"
override="false"
type="java.lang.String" value="abc123"/>
<Environment
description="Trigger because of different value"
name="contextEnvString_1"
override="false"
type="java.lang.String"
value="new Value"/>
<Environment
description="Trigger because of different type"
name="contextEnvString_2"
override="false"
type="java.lang.Integer"
value="123"/>
<Environment
description="will not Trigger because of override set to true."
name="contextEnvString_3"
override="true"
type="java.lang.Integer"
value="123"/>

со следующим файлом web.xml в приложении:

<env-entry>
<description>Trigger because of different value</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>oldValue</env-entry-value>
</env-entry>

<env-entry>
<description>Trigger because of different type</description>
<env-entry-name>contextEnvString_2</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>123</env-entry-value>
</env-entry>

<env-entry>
<description>will not Trigger because of override set to true.</description>
<env-entry-name>contextEnvString_3</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>123456789</env-entry-value>
</env-entry>

После применения быстрого исправления файл web.xml будет изменен следующим образом:

<env-entry>
<description>Trigger because of different value</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>new Value</env-entry-value>
</env-entry>

<env-entry>
<description>Trigger because of different type</description>
<env-entry-name>contextEnvString_2</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>123</env-entry-value>
</env-entry>

<env-entry>
<description>will not Trigger because of override set to true.</description>
<env-entry-name>contextEnvString_3</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>123456789</env-entry-value>
</env-entry>

<env-entry>
<description>Trigger becasue it does not exist</description>
<env-entry-name>newEntry</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>abc123</env-entry-value>
</env-entry>