Java EE telepítésleírók használata a környezeti hivatkozások megadásához

Ez a szabály azokat a Context <Environment> elemeket jelöli meg a META-INF/context.xml fájlban, amelyeket <env-entry> elemekké kell átalakítani a WEB-INF/web.xml fájlban.

Az Apache Tomcat a következő helyeken engedi meg a Context <Environment> elemek meghatározását:

Mivel az átállítási eszköz nem fér hozzá a Tomcat konfigurációs könyvtárához, csak a META-INF/context.xml fájlban található Context <Environment> elemeket jelöli meg. A más helyeken definiált Context <Environment> információk átmásolhatók a META-INF/context.xml fájlba, hogy az eszköz feldolgozhassa azokat.

Ha a világhálós törekvésben van létező WEB-INF/web.xml:

A Context <Environment> elemek az alábbi feltételek teljesülése esetén kerülnek megjelölésre:

A forráselemzőben rendelkezésre áll egy gyorsjavítás ehhez a szabályhoz. A gyorsjavítás új <env-entry> elemet vesz fel a web.xml fájlban, amely a Context <Environment> elemet képviseli, ha az még nem létezik a web.xml fájlban. Ha a bejegyzés létezik, akkor frissítésre kerül.

Ha a WEB-INF/web.xml fájl nem létezik:

Minden Context <Environment> elem megjelölésre kerül.

A gyorsjavítás olyan WEB-INF/web.xml fájlt hoz létre, amely tartalmazza a megfelelő <env-entry> elemeket, ha a világhálós törekvés legalább Java EE 5 szintű. A gyorsjavítás hibajelentést küld, ha a világhálós törekvés J2EE 1.4 vagy kisebb szintű.

Tegyük fel például, hogy a META-INF/context.xml fájl tartalma a következő:
<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 az alkalmazás a következő web.xml fájlt tartalmazza:

<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>

A gyorsjavítás alkalmazása után a frissített web.xml a következőket fogja tartalmazni:

<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>