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

Это правило отмечает элементы Context <Parameter> в файле META-INF/context.xml.

Apache Tomcat позволяет определять элементы 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 со следующим содержимым:

<Parameter 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>Trigger because of different value</description> <param-name>parameter_1</param-name> <param-value>oldValue</param-value> </context-param> <context-param> <description>Will not trigger because of override set to true</description> <param-name>parameter_2</param-name> <param-value>123456789</param-value> </context-param>

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

<context-param> <description>Trigger because it does not exist</description> <param-name>newEntry</param-name> <param-value>abc123</param-value> </context-param> <context-param> <description>Trigger because of different value</description> <param-name>parameter_1</param-name> <param-value>new Value</param-value> </context-param> <context-param> <description>Will not trigger because of override set to true</description> <param-name>parameter_2</param-name> <param-value>123456789</param-value> </context-param>

Дополнительная информация о параметре контекста в Tomcat приведена в следующем разделе:

• Справочник по конфигурации Apache Tomcat - параметры контекста.