Diese Regel markiert Folgendes:
Context <Parameter>
Elemente in der Datei META-INF/context.xml .
Apache Tomcat ermöglicht
Context <Parameter>
an den folgenden Positionen zu definierende Elemente:
- Datei META-INF/context.xml
- XML-Anwendungskonfigurationsdatei im Tomcat-Verzeichnis conf
- Der
<Host>
element in der conf/server.xml
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:
Context <Parameter>
elemente werden unter einer der folgenden Bedingungen gekennzeichnet:
- Der Eintrag hat keinen entsprechenden Eintrag in der Datei web.xml.
- Der Eintrag hat einen anderen Wert als der entsprechende Eintrag in der Datei
web.xml, und das Flag für Überschreibung (override) des Eintrags ist auf "false" gesetzt.
Eine automatische Korrektur fügt eine neue
<context-param>
element in der Datei web.xml, das repräsentiert die
Context <Parameter>
element, wenn es nicht bereits in der web.xml datei existiert.
Ist der Eintrag vorhanden, wird er aktualisiert.
Wenn die Datei WEB-INF/web.xml nicht vorhanden ist, geschieht Folgendes:
Alle
Context <Parameter>
elemente markiert werden.
Eine automatische Korrektur erstellt eine WEB-INF/web.xml datei die die entsprechende
<context-param>
elemente, wenn das webprojekt auf Java EE 5 oder höher ist. Die automatische Korrektur meldet einen Fehler, wenn das Webprojekt auf J2EE 1.4 oder niedriger 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="neuer Wert"/>
<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:
<kontext-param>
<description>Auslösung wegen eines anderen Wertes</description>
<param-name>parameter_1</param-name>
<param-value>oldValue</param-value>
</context-param>
<context-param>
<description>Wird nicht ausgelöst, weil die Überschreibung auf true gesetzt ist</description>
<param-name>parameter_2</param-name>
<param-value>123456789</param-value>
</context-param>
Nachdem die automatische Korrektur angewendet wurde, wird die web.xml aktualisiert werden und enthalten:
<kontext-param>
<description>Auslösen, weil es nicht existiert</description>
<param-name>newEntry</param-name>
<param-value>abc123</param-value>
</context-param>
<context-param>
<description>Auslösung wegen eines anderen Wertes</description>
<param-name>parameter_1</param-name>
<param-value>neuer Wert</param-value>
</context-param>
<context-param>
<description>Wird nicht ausgelöst, weil die Überschreibung 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: