Utilizza i descrittori di distribuzione Java EE de i bind WebSphere per definire i riferimenti risorsa

Questa regola contrassegna Context <Resource> elementi trovati nel file META-INF/context.xml che potrebbero richiedere la migrazione.

Apache Tomcat consente Context <Resource> elementi da definire in queste posizioni:

Poiché lo strumento di migrazione potrebbe non avere accesso alla directory di configurazione Tomcat, lo strumento di migrazione migra solo il file META-INF/context.xml. Le informazioni sulla risorsa definite in altri percorsi possono essere copiate nel file META-INF/context.xml per poterle elaborare.

Una correzione automatica prenderà le informazioni dal file Resource e crea un riferimento alla risorsa o un riferimento a un ambiente di risorse, a seconda delle necessità, e un nome JNDI corrispondente. Tomcat raccomanda, ma non richiede, che il corrispondente riferimento alla risorsa per la risorsa Resource essere definito nell'elemento WEB-INF/web.xml. La correzione automatica cercherà nell'elenco di resource-ref e resource-env-ref elementi per vedere se la voce corrispondente al nome esiste già. Altrimenti, ne crea una. Se il Resource ha un elemento auth un attributo resource-ref viene creato. Se il Resource non ha un elemento auth un attributo resource-env-ref è creato. In entrambi i casi, il name valore è usato anche come nome JNDI ed è definito nei binding.

Ad esempio, dato il seguente Resource elemento dal file META-INF/context.xml dal file:
<Risorsa name="jdbc/exampleDB"
auth="Container"
type="javax.sql.DataSource"
description="Database di esempio" />


La correzione automatica creerà questo corrispondente <resource-ref> elemento:
<resource-ref>
<description>
Esempio di database</description>
<res-ref-name>jdbc/exampleDB</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Contenitore</res-auth>
<res-sharing-scope>Condivisibile</res-sharing-scope>
</resource-ref>

Per impostazione predefinita, le risorse sono disponibili in Tomcat. Se l'ambito non è impostato sull'elemento Resource elemento, viene impostato su condivisibile quando viene creato un nuovo riferimento alla risorsa per la la correzione automatica. Se già esiste un riferimento risorsa in WEB-INF/web.xml, non vengono effettuate modifiche.

Se il progetto web è Java EE 5 o successivo e non esiste WEB-INF/web.xml, viene creato WEB-INF/web.xml e vengono aggiunti i nuovi elementi riferimento risorsa. Se il progetto web è a J2EE 1.4 o inferiore, la correzione automatica segnalerà un errore.

Sarà necessario anche configurare la risorsa nella configurazione WebSphere.

Per ulteriori informazioni sulla definizione risorsa di contesto in Tomcat consultare: