Java EE telepítésleírók használata a kontextus paraméterek megadásához

Ez a szabály a META-INF/context.xml fájlban található Context <Parameter> elemeket jelöli meg.

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

• A META-INF/context.xml fájlban
• Az alkalmazás XML konfigurációs fájljában a Tomcat conf könyvtárában
• A <Host> elemben a conf/server.xml fájlban

Az áttérési eszköz csak a META-INF/context.xml fájlban található elemeket állítja át. A más helyeken definiált paraméter 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 <Parameter> elemek az alábbi feltételek teljesülése esetén kerülnek megjelölésre:

• Nincs a bejegyzésnek megfelelő bejegyzés a web.xml fájlban.
• A bejegyzés értéke más, mint az egyező bejegyzésé a web.xml fájlban és felülbírálási kapcsolója hamis értékre van beállítva.

A forráselemzőben rendelkezésre áll egy gyorsjavítás ehhez a szabályhoz. A gyorsjavítás új <context-param> elemet vesz fel a web.xml fájlban, amely a Context <Parameter> 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 <Parameter> elem megjelölésre kerül.

A gyorsjavítás olyan WEB-INF/web.xml fájlt hoz létre, amely tartalmazza a megfelelő <context-param> 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ő:

<Parameter description="Trigger because it does not exist" name="newEntry" override="false" value="abc123"/> <Parameter description="Trigger because of different value" name="parameter_1" override="false" value="new Value"/> <Parameter description="Will not trigger because of override set to true" name="parameter_2" override="true" value="123"/>

és az alkalmazás a következő web.xml fájlt tartalmazza:

<context-param> <description>Trigger because of different value</description> <param-name>parameter_1</param-name> <param-value>oldValue</param-value> </context-param> <context-param> <description>Will not trigger because of override set to true</description> <param-name>parameter_2</param-name> <param-value>123456789</param-value> </context-param>

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

<context-param> <description>Trigger because it does not exist</description> <param-name>newEntry</param-name> <param-value>abc123</param-value> </context-param> <context-param> <description>Trigger because of different value</description> <param-name>parameter_1</param-name> <param-value>new Value</param-value> </context-param> <context-param> <description>Will not trigger because of override set to true</description> <param-name>parameter_2</param-name> <param-value>123456789</param-value> </context-param>

A Tomcat kontextus paraméterrel kapcsolatos további információkért lásd:

• Apache Tomcat konfigurációs referencia - Kontextus paraméterek.