Použít deskriptory implementace Java EE k definování odkazů na prostředí

Toto pravidlo označí prvky Context <Environment> nalezené v souboru META-INF/context.xml, které musí být převedeny na prvky <env-entry> v souboru WEB-INF/web.xml.

Apache Tomcat umožňuje definování prvků Context <Environment> v těchto umístěních:

Vzhledem k tomu, že nástroj migrace nemusí mít přístup ke konfiguračnímu adresáři Tomcat, označí pouze prvky Context <Environment> v souboru META-INF/context.xml. Informace o prvku Context <Environment> definované v jiných umístěních lze pro jeho zpracování zkopírovat do souboru to the META-INF/context.xml, aby je bylo možné zpracovat nástrojem.

Pokud ve webovém projektu existuje soubor WEB-INF/web.xml:

Prvky Context <Environment> budou označeny některou z následujících podmínek:

Rychlá oprava pro toto pravidlo je k dispozici ve zdrojovém skeneru. Rychlá oprava přidá nový prvek <env-entry> do souboru web.xml, který představuje prvek Context <Environment>, pokud již neexistuje v souboru web.xml. Pokud položka existuje, bude aktualizována.

Pokud soubor WEB-INF/web.xml neexistuje:

Všechny prvky Context <Environment> budou označeny.

Rychlá oprava vytvoří soubor WEB-INF/web.xml, který obsahuje příslušné prvky <env-entry>, pokud je webový projekt v prostředí Java EE 5 nebo vyšší. Rychlá oprava nahlásí chybu, pokud je webový projekt ve verzi J2EE 1.4 nebo nižší.

Například zvažte soubor META-INF/context.xml s následujícím obsahem:
<Environment
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="new Value"/>
<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>Trigger because of different value</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>Trigger because of different type</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>will not Trigger because of override set to 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 provedení rychlé opravy bude soubor web.xml aktualizován, aby obsahoval:

<env-entry>
<description>Trigger because of different value</description>
<env-entry-name>contextEnvString_1</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>new Value</env-entry-value>
</env-entry>

<env-entry>
<description>Trigger because of different type</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>will not Trigger because of override set to 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>Trigger becasue it does not exist</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>