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

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

Apache Tomcat umožňuje definování prvků Context <Resource> 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 prostředku 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ů Resource a podle potřeby vytvoří odkaz na prostředek nebo odkaz na prostředí prostředku a odpovídající název rozhraní JNDI. Server Tomcat doporučuje, ale nevyžaduje, aby odpovídající odkaz na prostředek pro prvek Resource byl definován v souboru WEB-INF/web.xml. Rychlá oprava prohledá seznam prvků resource-ref a resource-env-ref, abyste viděli, zda položka odpovídající názvu již existuje. Není-li tomu tak, vytvoří se. Pokud má prvek Resource atribut auth, vytvoří se resource-ref. Pokud prvek Resource nemá atribut auth, vytvoří se resource-env-ref. V obou případech se hodnota name používá také jako název rozhraní JNDI a je definována v rámci vazeb.

Pro následující prvek Resource ze souboru META-INF/context.xml:

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

Rychlá oprava vytvoří tento odpovídající prvek <resource-ref>:

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

Standardně jsou prostředky sdílitelné na serveru Tomcat. Není-li rozsah nastaven v prvku Resource, je nastaven sdílitelný při vytvoření nového odkazu na prostředek pro rychlou opravu. Pokud v souboru WEB-INF/web.xml již existuje odpovídající odkaz na prostředek, nebudou provedeny žádné změny.

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.

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

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

• Odkaz na konfiguraci Apache Tomcat - Definice prostředku.