Použít deskriptory implementace Java EE a vazby WebSphere k definování odkazů na prostředky

Toto pravidlo značí prvky Context <ResourceLink> nalezené v souboru META-INF/context.xml, jež vyžadují migraci.

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

• Soubor META-INF/context.xml
• Konfigurační soubor XML aplikace v adresáři Tomcat conf
• Prvek <Host> v souboru conf/server.xml

Vzhledem k tomu, že nástroj migrace nemusí mít přístup ke konfiguračnímu adresáři Tomcat, migruje nástroj migrace pouze soubor META-INF/context.xml. Informace o prvku ResourceLink definované v jiných umístěních lze pro jeho zpracování zkopírovat do souboru META-INF/context.xml.

Ve zdrojovém skeneru je k dispozici rychlá oprava. Rychlá oprava obsahuje informace z prvků ResourceLink a vytvoří odkaz na prostředek a odpovídající název rozhraní JNDI následujícím způsobem:

• Rychlá oprava prohledá seznam značek resource-ref, abyste viděli, zda položka odpovídající názvu již existuje. Není-li tomu tak, vytvoří se.
• Atribut názvu ResourceLink se používá pro značku res-ref-name v souboru web.xml
• Atribut typu ResourceLink se používá pro značku res-type v souboru web.xml
• Globální atribut ResourceLink se používá pro značku binding-name ve vázacím souboru IBM
• Atribut res-auth je nastaven na Container
• Atribut res-sharing-scope je nastaven na Shareable

Všimněte si, že další atributy ResourceLink (továrna, jméno uživatele a heslo) se automaticky nemigrují. Pokud vaše aplikace používá tyto atributy v ResourceLink, pak budete muset vytvořit jedinečný prostředek v konfiguraci serveru, poskytnout prostředek s jedinečným názvem rozhraní JNDI a aktualizovat vázací soubor IBM s novým názvem rozhraní JNDI.

Pokud je webový projekt Java EE 5 nebo vyšší a soubor WEB-INF/web.xml neexistuje, je vytvořen soubor WEB-INF/web.xml a jsou přidány nové prvky odkazu na prostředek. Je-li webový projekt nastaven na J2EE 1.4 nebo nižší, rychlá oprava ohlásí chybu.

Příklad: daný soubor META-INF/Context.xml obsahující prvek ResourceLink:

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

Rychlá oprava aktualizuje nebo vytvoří novou značku resource-ref v souboru web.xml podobném tomuto příkladu:

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

Název rozhraní JNDI je přidán do vázacího souboru IBM. Odkazuje na existující odkaz definovaný v souboru web.xml. Pokud vázací soubor dosud neexistuje, bude vytvořen.

Dále budete muset nakonfigurovat prostředek v konfiguraci produktu WebSphere Application Server.

Další informace o definici prostředku kontextu na serveru Tomcat viz:

• Odkaz na konfiguraci Apache Tomcat - Odkazy na prostředek.