Java-EE-Implementierungsdeskriptoren für die Definition von Kontextparametern verwenden

Diese Regel markiert Elemente Context <Parameter> in der Datei META-INF/context.xml.

Apache Tomcat lässt die Definition von Elementen "Context <Parameter>" an den folgenden Positionen zu:

Das Migrationstool migriert nur Parameterelemente in die Datei META-INF/context.xml. An den anderen Positionen definierte Parameterinformationen können zur Verarbeitung in die Datei META-INF/context.xml kopiert werden.

Angenommen, das Webprojekt enthält eine Datei WEB-INF/web.xml:

Elemente "Context <Parameter>" werden markiert, wenn eine der folgenden Bedingungen zutrifft:

Es ist eine Schnellkorrektur für diese Regel im Quellenscanner verfügbar. Diese Schnellkorrektur fügt ein neues Element <context-param> in der Datei "web.xml" hinzu, das das Element "Context <Parameter>" darstellt, sofern dieses Element noch nicht in der Datei web.xml vorhanden ist. Ist der Eintrag vorhanden, wird er aktualisiert.

Wenn die Datei WEB-INF/web.xml nicht vorhanden ist, geschieht Folgendes:

Alle Elemente "Context <Parameter>" werden markiert.

Diese Schnellkorrektur erstellt eine Datei WEB-INF/web.xml, die die entsprechenden Elemente <context-param> enthält, wenn das Webprojekt ein Java-EE-Projekt der Version 5 oder höher ist. Diese Schnellkorrektur meldet einen Fehler, wenn das Webprojekt ein J2EE-Projekt der Version 1.4 oder früher ist.

Stellen Sie sich als Beispiel eine Datei META-INF/context.xml mit dem folgenden Inhalt vor:

<Parameter
description="Auslösen, weil das Element nicht vorhanden ist"
name="newEntry"
override="false"
value="abc123"/>
<Parameter
description="Auslösen, weil das Element einen anderen Wert hat"
name="parameter_1"
override="false"
value="new Value"/>
<Parameter
description="Nicht auslösen, weil override auf true gesetzt ist"
name="parameter_2"
override="true"
value="123"/>

Stellen Sie sich weiter vor, dass diese Datei die folgende Datei web.xml in der Anwendung hat:

<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>Nicht auslösen, weil override auf true gesetzt ist</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>

Nach der Anwendung der Schnellkorrektur ist die Datei web.xml so aktualisiert, dass sie den folgenden Inhalt aufweist:

<context-param>
<description>Auslösen, weil das Element nicht vorhanden ist</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>Nicht auslösen, weil override auf true gesetzt ist</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>

Weitere Informationen zum Kontextparameter in Tomcat finden Sie im folgenden Dokument: