Это правило помечает
Context <Environment>
элементы, найденные в файле META-INF/context.xml , который должен быть преобразован в
<env-entry>
элементы в
ФайлWEB-INF/web.xml .
Apache Tomcat allows
Context <Environment>
элементы, которые должны быть определены в следующих положениях:
- Файл META-INF/context.xml
- Файл конфигурации XML приложения в каталоге Tomcat conf
- The
<Host>
в файле conf/server.xml
Поскольку инструмент миграции может не иметь доступа к каталогу конфигурации Tomcat, он отмечает только
Context <Environment>
в META-INF/context.xml файл.
Context <Environment>
информация, определенная в других местах, может быть скопирована в META-INF/context.xml файл, чтобы для его обработки инструментом.
Если файл WEB-INF/web.xml существует в веб-проекте:
Context <Environment>
элементы будут отмечены при любом из следующих условий:
- Для записи нет совпадающих записей в файле web.xml.
- Тип записи отличается от типа соответствующей записи в файле web.xml.
- Значение записи отличается от значения соответствующей записи в файле web.xml, и флагу переопределения записи присвоено значение false.
Добавить новый
<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 со следующим содержимым:
<Среда
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>Срабатывание из-за разного значения</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>Срабатывание из-за различных типов</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>не сработает из-за того, что переопределение установлено в 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>Срабатывание из-за разного значения</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>новое значение</env-entry-value>
</env-entry>
<env-entry>
<description>Срабатывание из-за различных типов</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>не сработает из-за того, что переопределение установлено в 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>Триггер, потому что его не существует</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>