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

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

Az Apache Tomcat a következő helyeken engedi meg a Context <ResourceLink> 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 ResourceLink 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 ResourceLink elemekben található információkat és létrehoz egy erőforrás-hivatkozást és a megfelelő JNDI nevet, az alábbiak szerint:

• A gyorsjavítás megnézi a resource-ref listában, hogy van-e a névvel egyező bejegyzés. Ha nincs, akkor létrehozásra kerül.
• A ResourceLink név attribútumot használják a res-ref-name elemhez a web.xml fájlban
• A ResourceLink típus attribútumot használják a res-type elemhez a web.xml fájlban
• A ResourceLink globális attribútumot használják a binding-name elemhez az IBM kötésfájlban
• A res-auth beállított értéke Container
• A res-sharing-scope beállított értéke Shareable

Ne feledje, hogy a többi ResourceLink attribútum (gyártó, felhasználónév és jelszó) nem kerül automatikusan átállításra. Ha alkalmazás ResourceLink elemben használja ezeket az attribútumokat, akkor egyedi erőforrást kell a kiszolgálókonfigurációban létrehoznia, egyedi JNDI bevet kell adnia az erőforrásnak, és frissítenie kell az IBM kötésfájlt az új JNDI névvel.3

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 referencia elemeket. A gyorsjavítás hibajelentést küld, ha a webes projekt J2EE 1.4 vagy alacsonyabb szintű.

Tegyük fel például, hogy a META-INF/Context.xml a következő ResourceLink elemet tartalmazza:

<ResourceLink global="jdbc/SampleWebGlobal" name="jdbc/SampleWeb" type="javax.sql.DataSource"/>

A gyorsjavítás az alábbi példához hasonlóan frissíti a resource-ref elemet vagy újat hoz létre a web.xml fájlban:

<resource-ref id="ResourceRef_1313785392722"> <res-ref-name>jdbc/SampleWeb</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref>

A JNDI név hozzáadásra kerül az IBM kötésfájlhoz. A név a web.xml fájlban meghatározott meglévő hivatkozásra mutat. Ha a kötésfájl még nem létezik, akkor a rendszer létrehozza azt.

Be kell állítania az erőforrást a WebSphere Application Server 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-hivatkozások.