Utilizza i descrittori di distribuzione Java EE e i bind WebSphere per definire i riferimenti di collegamento alla risorsa

Questa regola contrassegna gli elementi Context <ResourceLink> trovati nel file META-INF/context.xml che devono essere migrati.

Apache Tomcat consente di definire gli elementi Context <ResourceLink> in questi percorsi:

• il file META-INF/context.xml
• Il file di configurazione XML dell'applicazione nella directory Tomcat conf
• L'elemento <Host> in conf/server.xml

Poiché lo strumento di migrazione potrebbe non disporre dell'accesso alla directory di configurazione Tomcat, esegue la migrazione solo di Context <Environment> nel file META-INF/context.xml. Le informazioni ResourceLink definite in altri percorsi possono essere copiate nel file META-INF/context.xml in modo da poterle elaborare.

È disponibile una correzione rapida nello scanner di origine. La correzione rapida ottiene le informazioni dagli elementi ResourceLink e crea un riferimento risorsa e un corrispondente nome JNDI come segue:

• La correzione rapida ricerca l'elenco di riferimenti risorsa per verificare se esiste già la voce corrispondente al nome. Altrimenti, ne crea una.
• L'attributo nome ResourceLink viene utilizzato per res-ref-name in web.xml
• L'attributo tipo ResourceLink viene utilizzato per res-type in web.xml
• L'attributo globale ResourceLink viene utilizzato per binding-name nel file di bind IBM
• res-auth è impostato su Container
• res-sharing-scope è impostato su Shareable

Considerare che gli altri attributi ResourceLink (factory, username and password) non vengono migrati automaticamente. Se l'applicazione utilizza questi attributi in un ResourceLink, sarà necessario creare una risorsa univoca nella configurazione del server, assegnare un nome JNDI univoco alla risorsa ed aggiornare il file di bind IBM con il nuovo nome JNDI.

Se il progetto web è Java EE 5 o successivo e WEB-INF/web.xml non esiste, viene creato un WEB-INF/web.xml e vengono aggiunti i nuovi elementi di riferimento del collegamento alla risorsa. Se il progetto web è J2EE 1.4 o precedente, la correzione rapida genererà un errore.

Ad esempio, considerato un META-INF/Context.xml contenenete il following ResourceLink:

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

La correzione rapida aggiornerà o creerà un nuovo resource-ref nel file web.xml simile all'esempio di seguito riportato:

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

Il nome JNDI viene aggiunto al file di bind IBM. Fa riferimento al riferimento esistente definito in web.xml. Se il file di bind non esiste già, viene creato.

Sarà necessario anche configurare la risorsa nella configurazione di WebSphere Application Server.

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

• Apache Tomcat Configuration Reference - Resource Links.