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
Vzhledem k tomu, že nástroj migrace nemusí mít přístup ke konfiguračnímu adresáři Tomcat , označí pouze
Context <Environment>
v rámci
META-INF/context.xml soubor.
Context <Environment>
informace definované v jiných umístěních lze zkopírovat do souboru META-INF/context.xml , aby byl nástrojem zpracován.
Pokud ve webovém projektu existuje soubor WEB-INF/web.xml:
Context <Environment>
prvky budou označeny za 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>
v souboru web.xml , který představuje
Context <Environment>
prvek, pokud ještě neexistuje v
Soubor web.xml .
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:
< span class="Code"> < Prostředí
description="Trigger because it does not exist"
name="newEntry"
override="false"
type= "java.lang.String" hodnota= "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"
hodnota="123 " />
<Environment
description="will not Trigger because of override set to true."
name="contextEnvString_3"
override="true"
type="java.lang.Integer"
hodnota="123 " />
s následujícím souborem web.xml v aplikaci:
< span class="Code"> < env-entry>
<description>Spouštěč 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ěč z důvodu odlišného 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>nebude spouštěč kvůli přepsání nastaveným na hodnotu 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:
< span class="Code"> < env-entry>
<description>Spouštěč 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ěč z důvodu odlišného 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>nebude spouštěč kvůli přepsání nastaveným na hodnotu 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>