Toto pravidlo označí
Context <Environment>
prvky nalezené v souboru META-INF/context.xml , které musí být transformovány
<env-entry>
prvky v
WEB-INF/web.xml soubor.
Apache Tomcat umožňuje
Context <Environment>
prvky, které mají být definovány v těchto umístěních:
- Soubor META-INF/context.xml
- Konfigurační soubor XML aplikace v adresáři Tomcat conf
- V případě
<Host>
prvek v souboru conf/server.xml
Protože migrační nástroj nemusí mít přístup ke konfiguračnímu adresáři Tomcat, označí pouze
Context <Environment>
v META-INF/context.xml souboru.
Context <Environment>
informace definované v ostatních místech lze zkopírovat do META-INF/context.xml souboru v pořadí aby je nástroj mohl zpracovat.
Pokud ve webovém projektu existuje soubor WEB-INF/web.xml:
Context <Environment>
prvky budou označeny za některé z následujících podmínek:
- Položka nemá odpovídající položku v souboru web.xml.
- Položka má jiný typ než odpovídající položka v souboru web.xml.
- Položka má jinou hodnotu než odpovídající položka v souboru web.xml a její příznak přepisu je nastaven na false.
Přidání nového
<env-entry>
prvek v web.xml který představuje
Context <Environment>
prvek, pokud již neexistuje v web.xml souboru.
Pokud položka existuje, bude aktualizována.
Pokud soubor WEB-INF/web.xml neexistuje:
Vše
Context <Environment>
prvky budou označeny.
Vytvořit WEB-INF/web.xml soubor který obsahuje příslušné
<env-entry>
prvky, pokud je webového projektu na adrese Java EE 5 nebo vyšší. Automatická oprava ohlásí chybu, pokud webový projekt je na adrese J2EE 1.4 nebo nižší.
Například zvažte soubor
META-INF/context.xml s následujícím obsahem:
<Prostředí
description="Trigger because it does not exist"
name="newEntry"
override="false"
type=" java.lang.String " value=" abc123 "/>
<Environment
description="Trigger because of different value"
name="contextEnvString_1"
override="false"
type="java.lang.String"
value="nová hodnota"/>
<Environment
description="Trigger because of different type"
name="contextEnvString_2"
override="false"
type="java.lang.Integer"
value="123"/>
<Environment
description="will not Trigger because of override set to true."
name="contextEnvString_3"
override="true"
type="java.lang.Integer"
value="123"/>
s následujícím souborem web.xml v aplikaci:
<env-entry>
<description>Spuštění kvůli jiné hodnotě</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>Spouštěč kvůli jinému typu</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>se nespustí, protože přepsání je nastaveno na true.</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>
Po použití automatické opravy se web.xml bude aktualizován na obsahovat:
<env-entry>
<description>Spuštění kvůli jiné hodnotě</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>nová hodnota</env-entry-value>
</env-entry>
<env-entry>
<description>Spouštěč kvůli jinému typu</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>se nespustí, protože přepsání je nastaveno na true.</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>Spouštěč, protože neexistuje</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>