Utilizar los descriptores de despliegue Java EE y enlaces de WebSphere para definir referencias de enlaces de recursos

Esta regla marca los elementos Context <ResourceLink> que se encuentran en el archivo META-INF/context.xml que deben migrarse.

Apache Tomcat permite definir los elementos Context <ResourceLink> en las siguientes ubicaciones:

• El archivo META-INF/context.xml
• El archivo de configuración XML de aplicación en el directorio conf de Tomcat
• El elemento <Host> en conf/server.xml

Como la herramienta de migración puede que no tenga acceso al directorio de configuración de Tomcat, la herramienta de migración sólo migra el archivo META-INF/context.xml. La información de ResourceLink definida en las otras ubicaciones puede copiarse en el archivo META-INF/context.xml para su proceso.

Hay un arreglo rápido disponible en el explorador de orígenes. El arreglo rápido utiliza la información de los elementos ResourceLink y crea una referencia de recursos y el nombre JNDI correspondiente de la siguiente manera:

• El arreglo rápido busca en la lista de resource-ref para ver si la entrada que coincide con el nombre ya existe. Si no existe, se crea una.
• El atributo de nombre de ResourceLink se utiliza para res-ref-name en web.xml
• El atributo de tipo de ResourceLink se utiliza para res-type en web.xml
• El atributo global de ResourceLink se utiliza para binding-name en el archivo de enlaces de IBM
• res-auth se establece en Container
• res-sharing-scope se establece en Shareable

Tenga en cuenta que los demás atributos de ResourceLink (fábrica, nombre de usuario y contraseña) no se migran automáticamente. Si la aplicación utiliza esos atributos en un ResourceLink, deberá crear un recurso exclusivo en la configuración de servidor, proporcionar al recurso un nombre JNDI exclusivo y actualizar el archivo de enlaces de IBM con el nuevo nombre JNDI.

Si el proyecto web es Java EE 5 o superior y WEB-INF/web.xml no existe, se crea WEB-INF/web.xml y se añaden los nuevos elemento de referencia de enlace de recursos. Si el proyecto web tiene la versión en J2EE 1.4 o inferior, el arreglo rápido informará de un error.

Por ejemplo, para un META-INF/Context.xml que contiene el siguiente ResourceLink:

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

El arreglo rápido actualizará o creará un nuevo elemento resource-ref en el archivo web.xml similar a este ejemplo:

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

El nombre JNDI se añade al archivo de enlaces de IBM. Hace referencia a la referencia existente definida en web.xml. Si el archivo de enlaces aún no existe, se crea.

Deberá configurar también el recurso en la configuración de WebSphere Application Server.

Para obtener información adicional sobre la definición de recurso de contexto en Tomcat, consulte:

• Referencia de configuración de Apache Tomcat - Enlaces de recurso.