Puede configurar los atributos de despliegue de bean controlados por
mensajes de una aplicación de empresa compatible con JCA (Java™ EE Connector
Architecture) 1.5 para alterar temporalmente los atributos de despliegue
definidos dentro del archivo EAR de la aplicación.
Antes de empezar
En esta tarea se presupone que dispone de un archivo EAR, que
contiene una aplicación de empresa, desarrollada como un bean controlado por
mensajes, que se puede desplegar en
WebSphere
Application Server.
Nota: Puede continuar
configurando beans controlados por
mensajes con un puerto de escucha.
Esto se recomienda a efectos de compatibilidad con las aplicaciones existentes de beans controlados por mensajes. No obstante, los puertos de escucha se han estabilizado, y debe planificar la migración de todos los beans controlados por mensajes para utilizar recursos compatibles con JCA 1.5 o 1.6.
Acerca de esta tarea
Puede configurar los atributos de despliegue de una aplicación de bean controlado por mensaje mediante la herramienta de ensamblaje. En esta tarea se describe en detalle el procedimiento con
Rational
Application Developer, pero otras herramientas tienen un procedimiento similar.
Procedimiento
- Inicie la herramienta de ensamblaje.
- Edite el archivo EAR de la aplicación. Por ejemplo, utilice el asistente de importación de
Rational Application Developer para importar
el archivo EAR en la herramienta de ensamblaje. Para iniciar el asistente de importación:
- Pulse .
- Pulse Siguiente y seleccione el archivo EAR.
- Pulse Finalizar.
- Abra los atributos de despliegue y edítelos. En la vista jerárquica de Java EE,
pulse con el botón derecho del ratón en el módulo EJB correspondiente al bean controlado
por mensaje y, a continuación, pulse . En el panel de propiedades aparecerá un cuaderno de diálogo de propiedades del
bean controlado por mensajes.
- Revíselo y, si es necesario, cambie los atributos de despliegue.
- En el panel de la propiedad, seleccione el separador Bean.
- En Configuración de activación, revise los atributos.
Nota: Para beans controlados por mensajes EJB 3, puede utilizar una anotación EJB 3
para configurar las propiedades de configuración de la activación. No utilice
la anotación EJB 3 para cambiar o sustituir lo que se especifica en el
descriptor de despliegue del bean. Si una propiedad de configuración de la
activación se especifica en ambos lados, se utiliza el valor indicado en el
descriptor de despliegue.
- acknowledgeMode
- Este atributo determina la forma en que la sesión reconoce los mensajes que recibe.
- Reconocimiento automático
- La sesión reconoce automáticamente la entrega de cada mensaje.
- Reconocimiento correcto de duplicados
- La sesión reconoce vagamente la entrega de mensajes. Es probable que este valor produzca como resultado la entrega de algunos mensajes duplicados si JMS falla, por lo que sólo deben utilizarlo
las aplicaciones de consumidor que toleren mensajes duplicados.
- destinationType
- Este atributo determina si el bean de mensaje utiliza un destino de cola o de tema.
- Cola
- El bean controlado por mensajes utiliza un destino de cola.
- Tema
- El bean controlado por mensajes utiliza un destino de tema.
- subscriptionDurability
- Este atributo determina si una suscripción de tema JMS es duradera o no.
- Duradera
- Un suscriptor registra una suscripción duradera
con una identidad exclusiva que JMS conserva. Los objetos de suscriptores
posteriores con la misma identidad reanudan la suscripción en el estado en
que la dejó el suscriptor anterior. Si no hay un suscriptor activo para una
suscripción duradera, JMS conserva los mensajes de la suscripción hasta que la
suscripción los recibe o hasta que caducan.
- No duradera
- Las suscripciones no duraderas duran el tiempo que dure el objeto del suscriptor. Esto significa que un cliente ve
mensajes publicados sobre un tema sólo cuando su suscriptor esté
activo. Si el suscriptor no está activo, el cliente no verá los mensajes
publicados sobre ese tema.
Sólo se puede utilizar el suscriptor no duradero en el mismo contexto
transaccional (por ejemplo, una transacción global o un contexto de transacción no especificado) que existía
cuando se ha creado el suscriptor.
- messageSelector
- Este atributo determina el selector de mensajes JMS que se utiliza para seleccionar qué mensajes recibe el bean de mensaje. Por ejemplo:
JMSType='car' AND color='blue' AND weight>2500
La serie del selector puede hacer referencia a campos de la cabecera del mensaje JMS y a campos de las propiedades del mensaje. Los selectores de mensajes no pueden hacer referencia a valores del cuerpo del
mensaje.
- Especifique los atributos generales de enlace.
Bajo Enlaces de WebSphere, seleccione la opción Adaptador JCA y especifique los atributos de despliegue de enlaces:
- Nombre JNDI de ActivationSpec
- Este atributo especifica el nombre JNDI de la especificación de activación que se utilice para desplegar este bean controlado por mensajes. Este nombre debe coincidir con el nombre de una
especificación de activación que se define en WebSphere Application Server.
- Alias de autorización de ActivationSpec
- Este atributo especifica el nombre de un alias de autenticación utilizado para la autenticación de conexiones con el adaptador de recursos JCA. Un alias de autenticación especifica el ID de usuario y la contraseña que
se utiliza para autenticar la creación de una nueva conexión con el adaptador
de recursos de JCA.
- Nombre JNDI de destino
- Este atributo especifica el nombre JNDI que utiliza el bean
controlado por mensajes para buscar el destino JMS en el espacio de nombres JNDI.
- Guarde los cambios en el descriptor de despliegue:
- Cierre el editor de descriptor de despliegue.
- Cuando se le solicite, pulse Yes para indicar que desea guardar los
cambios en el descriptor de despliegue.
- Verifique los archivos archivadores.
- Desde el menú emergente del proyecto, pulse
Desplegar para generar el código de despliegue de EJB.
- Opcional: Pruebe el módulo completado en las instalaciones de
WebSphere Application Server.
Pulse con el botón derecho en un módulo, pulse Ejecutar en servidor
y siga las instrucciones del asistente mostrado.
Restricción: Ejecutar en servidor funciona sólo en sistemas operativos
Windows, Linux/Intel y AIX. No puede desplegar de forma remota en una instalación de WebSphere Application Server en sistemas operativos UNIX, como por ejemplo Solaris.
Importante: Utilice Ejecutar en servidor únicamente
para fines de prueba. Cuando se publica de forma remota una aplicación,
la herramienta de ensamblado graba encima del archivo de configuración de servidor correspondiente
a ese servidor. No lo utilice en servidores de producción.
Qué hacer a continuación
Después de ensamblar la aplicación, utilice una herramienta de gestión de sistemas para
desplegar el archivo EAR en el servidor de aplicaciones que ejecutará la aplicación; por ejemplo, utilice la
consola administrativa tal como se describe en Despliegue y gestión
de aplicaciones.