Configuración de los atributos de despliegue para beans controlados por mensajes en puertos de escucha

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

  1. Inicie la herramienta de ensamblaje.
  2. 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:
    1. Pulse Archivo > Importar > Archivo EAR.
    2. Pulse Siguiente y seleccione el archivo EAR.
    3. Pulse Finalizar.
  3. 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 Abrir con > Editor del descriptor de despliegue. En el panel de propiedades aparecerá un cuaderno de diálogo de propiedades del bean controlado por mensajes.
  4. Especifique los atributos generales de despliegue.
    1. En el panel de la propiedad, seleccione el separador Bean.
    2. 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.
  5. 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.

  6. Especifique el atributo de despliegue de enlaces.
    1. 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.
  7. Guarde los cambios en el descriptor de despliegue:
    1. Cierre el editor de descriptor de despliegue.
    2. Cuando se le solicite, pulse Yes para indicar que desea guardar los cambios en el descriptor de despliegue.
  8. Verifique los archivos archivadores.
  9. Desde el menú emergente del proyecto, pulse Desplegar para generar el código de despliegue de EJB.
  10. 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.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmb_depa2
File name: tmb_depa2.html