Una referencia a recursos admite el acceso de las aplicaciones a recursos
(como proveedores de orígenes de datos, URL o correo) con un nombre lógico en lugar del
nombre real en el entorno del módulo ejecutable. Esta posibilidad elimina la necesidad de
alterar el código de la aplicación cuando cambia las configuraciones de tiempo de
ejecución de los recursos.
Antes de empezar
Este tema le guía por la actualización de las referencias de recursos de una aplicación de empresa que se ha ensamblado anteriormente. El tema Ensamblaje de aplicaciones describe detalladamente el procedimiento de
ensamblaje.
Acerca de esta tarea
Las referencias a recursos se declaran
en el descriptor de despliegue mediante el proveedor de aplicaciones. En algún punto
del proceso de despliegue de la aplicación, deberá enlazar la referencia a recursos
con el nombre real del recurso en el entorno de tiempo de ejecución. Cuando se crea una fábrica de conexiones o un origen de datos en el servidor de aplicaciones, este proporciona un nombre JNDI para que un componente pueda acceder a dicha fábrica de conexiones u origen de datos. El servidor de aplicaciones utiliza un nombre indirecto con el prefijo java:comp/env. Por ejemplo:
- Cuando cree un origen de datos, el nombre JNDI por omisión se establece en jdbc/nombre_origen_datos.
- Cuando se crea una fábrica de conexiones, el nombre por omisión es eis/j2c_nombre_fábrica_conexiones.
Si altera temporalmente estos valores especificando su propio nombre, mantenga el prefijo java:comp/env. Un nombre JNDI indirecto permite que la infraestructura de gestión de conexiones acceda a cualquier dato de la referencia de recurso asociada con la aplicación. Así se pueden gestionar mejor los recursos basados en los valores para autenticación, nivel de aislamiento, ámbito de compartición y control de resolución.
En este tema describe cómo se actualizan las referencias de recursos de una
aplicación de empresa utilizando una herramienta de ensamblaje. Después de definir la referencia de recurso, puede realizar una búsqueda JNDI indirecta utilizando el contexto java:comp/env.
Procedimiento
- Inicie la herramienta de ensamblaje.
- Si todavía no lo ha hecho, configure la herramienta de ensamblaje para trabajar en módulos Java EE (Java Platform, Enterprise Edition).
- Importe la aplicación de empresa (archivo EAR) que desea modificar al proyecto EJB.
- Visualice las referencias a recursos del tipo de módulo:
- Si un enterprise bean utiliza la referencia a recursos:
- Expanda el nombre del archivo EAR.
- Expanda Módulos EJB.
- Expanda el módulo EJB que desee.
- Expanda la sección del tipo adecuado de enterprise bean (Beans de sesión o Beans de entidad).
- Expanda el enterprise bean.
- Si un servlet utiliza la referencia a recursos:
- Expanda el nombre del archivo EAR.
- Expanda Módulos Web.
- Expanda el módulo web que desee.
- Si un cliente de aplicaciones utiliza la referencia a recursos:
- Expanda el nombre del archivo EAR.
- Expanda Clientes de aplicaciones.
- Expanda el módulo de cliente de aplicaciones que desee.
- Pulse con el botón derecho del ratón en el módulo cuyas referencias de recursos
desea cambiar y pulse Abrir con > Editor de descriptor de despliegue.
- Para servlets y clientes de aplicaciones, pulse Add (Añadir). Para módulos EJB,
seleccione el bean en particular y pulse Add (Añadir).
- Seleccione la opción de referencia a recurso y pulse Next (Siguiente).
- Especifique los valores para la referencia de recurso y pulse Finalizar.
- Opcional: Seleccione la pestaña References (Referencias), bajo WebSphere Extensions, seleccione un nivel de aislamiento. Si decide prescindir de este paso, el nivel de aislamiento se establece por
omisión en TRANSACTION_NONE.
- Opcional: En WebSphere Bindings especifique un nombre de JNDI. Si elige prescindir de este paso, puede establecer (o alterar temporalmente) el
enlace cuando se despliegue la aplicación.
- Cierre Deployment Descriptor Editor y guarde los cambios.
Resultados
Los archivos del módulo actualizado se muestran en la vista Explorador de proyectos.
Qué hacer a continuación
Verifique el contenido de la aplicación de empresa actualizada en la
vista Explorador de proyectos. A continuación, despliegue
la aplicación de empresa.
Puede generar código de despliegue EJB y desplegar un módulo EJB en un servidor de destino en un paso. En la vista Explorador de proyectos, pulse con el botón derecho del ratón en el proyecto EJB y pulse Desplegar. Consulte también el tema Despliegue de módulos EJB.