Puede configurar los atributos de despliegue de beans controlados
por mensajes de enterprise beans para alterar temporalmente los atributos de
despliegue definidos dentro del archivo EAR de la aplicación.
Antes de empezar
Los puertos de escucha se han estabilizado. Para obtener más información,
consulte el artículo sobre las funciones estabilizadas.
Sólo debería desplegar la aplicación con
u n puerto de escucha por motivos de compatibilidad con aplicaciones existentes
de beans controlados por mensajes. Debe
configurar la aplicación con recursos
compatibles con JCA 1.5.
Si tiene beans controlados por
mensajes existentes que utilizan el proveedor de mensajería de IBM MQ (o un proveedor de JMS de otra
empresa que sea compatible) con puertos de escucha y, en su lugar, quiere utilizar los beans controlados por mensajes de EJB 3 con puertos de escucha,
estos beans nuevos pueden seguir utilizando el mismo proveedor de mensajería.
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.
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.
- Especifique los atributos generales de despliegue.
- En el panel de la propiedad, seleccione el separador Bean.
- En el panel principal, configure el atributo Tipo de transacción.
Este atributo determina si el bean controlado por mensajes gestiona sus propias transacciones o si el contenedor gestiona las transacciones en nombre del bean.
- Bean
- El bean controlado por mensajes gestiona sus propias transacciones.
- Contenedor
- El contenedor gestiona transacciones en nombre del bean.
- En Configuración de activación, revise los atributos siguientes:
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 el atributo de despliegue de enlaces.
- En Enlaces de WebSphere, especifique el atributo siguiente:
- Nombre de puerto de escucha
- Escriba el nombre del puerto de escucha de este bean controlado por mensajes.
- 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.