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

Diese Regel markiert Folgendes: Context <Environment> Elemente in der Datei META-INF/context.xml , die umgewandelt werden müssen <env-entry> Elemente in der Datei WEB-INF/web.xml .

Apache Tomcat ermöglicht Context <Environment> an den folgenden Positionen zu definierende Elemente:

Datei META-INF/context.xml
XML-Anwendungskonfigurationsdatei im Tomcat-Verzeichnis conf
Der <Host> Element in der Datei conf/server.xml

Da das Migrationstool möglicherweise keinen Zugriff auf das Konfigurationsverzeichnis Tomcat hat, kennzeichnet es nur die Context <Environment> im META-INF/context.xml datei. Context <Environment> informationen, die an den anderen Standorten definiert wurden, können kopiert werden in die META-INF/context.xml datei kopiert werden, damit damit sie vom Werkzeug verarbeitet werden kann.

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

Context <Environment> elemente werden unter einer der folgenden Bedingungen gekennzeichnet:

Der Eintrag hat keinen entsprechenden Eintrag in der Datei web.xml.
Der Eintrag hat einen anderen Typ als der entsprechende 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.

Hinzufügen einer neuen <env-entry> element in der web.xml datei, das das die Context <Environment> 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 <Environment> elemente markiert werden.

Erstellen einer WEB-INF/web.xml datei die die entsprechenden <env-entry> 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:

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

<env-entry>
<description>Auslösung wegen eines anderen Wertes</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>Auslöser wegen anderer Art</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>wird nicht ausgelöst, weil die Überschreibung auf true gesetzt ist.</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>

Nachdem die automatische Korrektur angewendet wurde, wird die web.xml aktualisiert werden und enthalten:

<env-entry>
<description>Auslösung wegen eines anderen Wertes</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>neuer Wert</env-entry-value>
</env-entry>

<env-entry>
<description>Auslöser wegen anderer Art</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>wird nicht ausgelöst, weil die Überschreibung auf true gesetzt ist.</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>Auslösen, weil es nicht existiert</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>