Это правило помечает
Context <Parameter>
в файле META-INF/context.xml .
Apache Tomcat allows
Context <Parameter>
элементы, которые должны быть определены в следующих положениях:
- Файл META-INF/context.xml
- Файл конфигурации XML приложения в каталоге Tomcat conf
- Сайт
<Host>
элемент в conf/server.xml
Инструмент миграции переносит только элементы параметров в файле META-INF/context.xml.
Информация о параметре, определенная в других расположениях, может быть скопирована в файл META-INF/context.xml для обработки.
Если файл WEB-INF/web.xml существует в веб-проекте:
Context <Parameter>
элементы будут отмечены при одном из следующих условий:
- Для записи нет совпадающих записей в файле web.xml.
- Значение записи отличается от значения соответствующей записи в файле web.xml, и флагу переопределения записи присвоено значение false.
Автоматическое исправление добавит новый
<context-param>
элемент в файле web.xml, который представляет
Context <Parameter>
элемент, если он еще не существует в web.xml файле.
Если запись существует, она будет обновлена.
Если файл WEB-INF/web.xml не существует:
Все
Context <Parameter>
элементы будут отмечены.
Автоматическое исправление создаст WEB-INF/web.xml файл который включает в себя соответствующий
<context-param>
элементы, если веб-проект находится на уровне Java EE 5 или выше. Автоматическое исправление сообщит об ошибке, если веб-проект находится на J2EE 1.4 или ниже.
Пример: существует файл META-INF/context.xml со следующим содержимым:
<Параметр
description="Trigger because it does not exist"
name="newEntry"
override="false"
value=" abc123 "/>
<Parameter
description="Trigger because of different value"
name="parameter_1"
override="false"
value="new Value"/>
<Parameter
description="Will not trigger because of override set to true"
name="parameter_2"
override="true"
value="123"/>
со следующим файлом web.xml в приложении:
<context-param>
<description>Срабатывание из-за разного значения</description>
<param-name>parameter_1</param-name>
<param-value>oldValue</param-value>
</context-param>
<context-param>
<description>Не сработает из-за переопределения, установленного в true</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
После применения автоматического исправления web.xml будет обновлен до содержать:
<context-param>
<description>Триггер, потому что его не существует</description>
<param-name>newEntry</param-name>
<param-value>abc123</param-value>
</context-param>
<context-param>
<description>Срабатывание из-за разного значения</description>
<param-name>parameter_1</param-name>
<param-value>новое значение</param-value>
</context-param>
<context-param>
<description>Не сработает из-за переопределения, установленного в true</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
Дополнительная информация о параметре контекста в Tomcat приведена в следующем разделе: