Java EE telepítésleírók és WebSphere kötések használata az erőforrás-hivatkozások megadásához

Ez a szabály a META-INF/context.xml fájlban található Context <Resource> elemeket jelöli meg, amelyek esetleg átállítást igényelnek.

Az Apache Tomcat a következő helyeken engedi meg a Context <Resource> 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

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 elért veszi át. A más helyeken definiált erőforrás információk átmásolhatók a META-INF/context.xml fájlba, hogy az eszköz feldolgozhassa azokat.

A forráselemzőben rendelkezésre áll egy gyorsjavítás. A gyorsjavítás fogja a Resource elemekben található információkat és létrehoz egy erőforrás-hivatkozást vagy erőforrás környezet hivatkozást (szükség szerint) és a megfelelő JNDI nevet. A Tomcat javasolja (de nem követeli meg), a Resource elem megfelelő erőforrás-hivatkozásának meghatározását a WEB-INF/web.xml fájlban. A gyorsjavítás megnézi a resource-ref és resource-env-ref elemek listájában, hogy van-e a névvel egyező bejegyzés. Ha nincs, akkor létrehozásra kerül. Ha a Resource elemnek van auth attribútuma, akkor resource-ref elem kerül létrehozásra. Ha a Resource elemnek nincs auth attribútuma, akkor resource-env-ref elem kerül létrehozásra. Mindkét esetben a name érték is felhasználásra kerül JNDI névként és definiálásra kerül a kötések között.

Adott például a következő Resource elem a META-INF/context.xml fájlból:

<Resource name="jdbc/exampleDB" auth="Container" type="javax.sql.DataSource" description="Example Database"/>

A gyorsjavítás a következő <resource-ref> elemet fogja létrehozni:

<resource-ref> <description> Example Database</description> <res-ref-name>jdbc/exampleDB</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref>

Az erőforrások a Tomcat rendszerben alapértelmezésben megoszthatók. Ha a hatókör nincs beállítva a Resource elemben, akkor megoszthatóként lesz beállítva, amikor a gyorsjavításhoz új erőforrás-hivatkozás kerül létrehozásra. Ha a megfelelő erőforrás-hivatkozás már létezik a WEB-INF/web.xml fájlban, akkor nem kerül sor módosításra.

Ha a webes projekt Java EE 5 vagy magasabb szintű és a WEB-INF/web.xml fájl nem létezik, akkor a WEB-INF/web.xml fájl létrehozásra kerül és a rendszer hozzáadja az új erőforrás-hivatkozás elemeket. A gyorsjavítás hibajelentést küld, ha a webes projekt J2EE 1.4 vagy alacsonyabb szintű.

Be kell állítania az erőforrást a WebSphere konfigurációban is.

A Tomcat kontextus erőforrás meghatározással kapcsolatos további információkért lásd:

• Apache Tomcat konfigurációs referencia - Erőforrás-meghatározások.