Especificación de activación JMS [Valores]
Mediante Java™ EE Connector Architecture (JCA) 1.5. se puede crear una especificación de activación de JMS si desea utilizar un bean controlado por mensajes para comunicarse con el proveedor de mensajes predeterminado. JCA proporciona conectividad Java entre los servidores de aplicaciones como, por ejemplo, WebSphere Application Server, y sistemas de información de empresa. Proporciona un método estandarizado de integrar los proveedores JMS con los servidores de aplicaciones Java EE y proporciona una infraestructura para intercambiar datos con los sistemas empresariales, donde los datos se transfieren en forma de mensajes.
Todas las propiedades de configuración de especificación de activación excepto Nombre, Nombre JNDI, Nombre JNDI del destino o Búsqueda de destino y Alias de autenticación se alteran temporalmente mediante las propiedades de configuración de activación adecuadas en el descriptor de despliegue de un bean controlado por mensajes EJB 2.1 o posterior asociado. Para un bean controlado por mensajes EJB 2.0, las propiedades Tipo de destino, Duración de suscripción, Modalidad de reconocimiento y Selector de mensajes quedan alteradas temporalmente por los elementos correspondientes del descriptor de despliegue. Para cualquiera de los tipos de bean, la propiedad Nombre JNDI de destino o Búsqueda de destino se puede alterar temporalmente por un valor especificado en los enlaces del bean controlado por mensaje.
Las propiedades de la especificación de activación influyen en cómo el proveedor de mensajería predeterminado elige el motor de mensajería al que se conecta la aplicación de beans controlados por mensajes. De forma predeterminada, el entorno conecta automáticamente aplicaciones a un motor de mensajería disponible en el bus. Sin embargo, puede especificar información detallada de configuración adicional para influir en el proceso de conexión. Por ejemplo, para identificar los servidores de rutina de carga especiales o para limitar la conexión con un subgrupo de motores de mensajería disponibles, o mejorar la disponibilidad o el rendimiento o para garantizar el proceso secuencias de los mensajes recibidos. Para obtener más información sobre porqué y cómo hacerlo, consulte el tema Cómo se conectan las aplicaciones JMS a un motor de mensajería de un bus.
Separador Configuración
La pestaña Configuración muestra las propiedades de configuración para este objeto. Estos valores de propiedad se conservan incluso si se detiene el entorno de ejecución y luego se reinicia. Consulte las descripciones de tareas del Information Center para obtener información sobre cómo aplicar cambios de configuración al entorno de ejecución.
Propiedades generales
Ámbito
Especifica el nivel de topología más alto en el que los servidores de aplicaciones pueden utilizar este objeto de recurso.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Proveedor
Especifica un proveedor de JMS, que permite mensajería asíncrona basada en JMS (Java Message Service). Proporciona fábricas de conexiones de J2EE para crear conexiones para destinos de cola JMS o de tema específicos. Se utilizan objetos administrativos del proveedor JMS para gestionar recursos JMS para el proveedor JMS asociado.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Name
El nombre de visualización necesario del recurso.
Información | Valor |
---|---|
Required | Sí |
Tipo de datos | Serie |
Nombre JNDI
Nombre JNDI del recurso.
Información | Valor |
---|---|
Required | Sí |
Tipo de datos | Serie |
Descripción
Descripción opcional del recurso.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Área de texto |
Tipo de destino
Información | Valor |
---|---|
Required | Sí |
Tipo de datos | lista desplegable |
Rango |
|
Búsqueda de destino
Seleccione el tipo de destino en la propiedad Tipo de destino.
Para adaptadores de recursos que admiten JMS tiene que asociar javax.jms.Destinations a una especificación de activación, de modo que el adaptador de recursos pueda atender los mensajes del destino JMS. En este caso, el administrador configura un objeto administrado J2C que implementa la interfaz javax.jms.Destination y la enlaza a la JNDI.
Puede configurar objetos administrados J2C para utilizar una clase ActivationSpec que implementa un método setDestination(javax.jms.Destination). En este caso, puede especificar la Búsqueda de destino (es decir, el nombre de JNDI para el objeto administrado J2C que implementa el javax.jms.Destination).
Información | Valor |
---|---|
Required | Sí |
Tipo de datos | Serie |
Búsqueda de fábrica de conexiones
Nombre JNDI de la fábrica de conexiones.
Información | Valor |
---|---|
Required | Sí |
Tipo de datos | Serie |
Selector de mensajes
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.
Un valor nulo (una serie vacía) indica que hay un selector de mensajes para el consumidor de mensajes.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Nombre de bus
Información | Valor |
---|---|
Required | No |
Tipo de datos | Personalizado |
Modalidad de reconocimiento
El reconocimiento se envía cuando se suprime el mensaje.
- Si el sistema está configurado para suprimir el mensaje cuando el bean se completa, el mensaje se asigna a una nueva instancia del bean, de modo que tiene otra oportunidad para ser procesado.
- Si el sistema está configurado para suprimir el mensaje cuando se inicia el bean, el mensaje se pierde.
El mensaje se suprime cuando se inicia el bean, si la calidad del servicio se establece en Mejor esfuerzo no persistente. Para todas las demás calidades de servicio, el mensaje se suprime cuando se completa el bean.
Información | Valor |
---|---|
Required | No |
Tipo de datos | lista desplegable |
Rango |
|
Destino
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Tipo de destino
Información | Valor |
---|---|
Required | No |
Tipo de datos | lista desplegable |
Rango |
|
Importancia del destino
Información | Valor |
---|---|
Required | No |
Tipo de datos | lista desplegable |
Rango |
|
Cadena de transporte de entrada de destino
Si el motor de mensajería seleccionado está en el mismo servidor que la aplicación, se realiza una conexión directamente desde el proceso y se ignora esta propiedad de cadena de transporte.
- InboundBasicMessaging
- Se trata de un protocolo orientado a conexión que utiliza una conexión TCP/IP estándar (JFAP-TCP/IP). Incluye soporte para flujos transaccionales en dos fases (XA remoto), para que un generador o consumidor de mensajes que se ejecute en un sistema cliente o servidor, pueda participar en una transacción global gestionada sobre dicho sistema cliente o servidor. El uso específico de flujos XA es dar soporte de acceso a una aplicación que se ejecuta en un servidor en un motor de mensajería de otro servidor, quizás porque el primer servidor no tiene un motor de mensajería adecuado. Si se utilizan flujos XA remotos, debe estar disponible un coordinador de transacciones de forma local para la aplicación.
- InboundSecureMessaging
- Es el protocolo InboundBasicMessaging envuelto en SSL.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Puntos finales de proveedor
Lista separada por comas de tripletes de puntos finales, con la sintaxis nombreHost:númeroPuerto:nombreCadena, utilizada para conectarse a un servidor de rutina de carga. Por ejemplo, Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Si no se especifica el nombre de host, se utiliza localhost como valor predeterminado.
Si se especifica el número de puerto, se utiliza 7276 como valor predeterminado.
Si no se especifica el protocolo, como valor predeterminado se utilizará una cadena predefinida como BootstrapBasicMessaging.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Área de texto |
Tamaño máximo de lote
Información | Valor |
---|---|
Required | No |
Tipo de datos | Entero |
Rango | 1 a 2147483647 |
Número máximo de invocaciones de MDB simultáneas por punto final
Información | Valor |
---|---|
Required | No |
Tipo de datos | Entero |
Rango | 1 a 2147483647 |
Detener automáticamente los puntos finales al repetirse una anomalía de mensaje
Estos parámetros permiten la detención automática de un punto final cuando el número de mensajes que fallan de forma secuencial alcanza el límite que se especifique. Esto ayuda a distinguir entre uno o dos mensajes que fallan debido a problemas con los propios mensajes, y un problema del recurso del sistema que genera muchos mensajes que fallan de forma secuencial.
Cuando un punto final se detiene automáticamente, el Estado en el panel de la consola de administración es rojo. Se debe reiniciar manualmente pulsando Reanudar.
Después de reiniciar un punto final, se reintentan los mensajes erróneos que causaron la detención del punto final. Si siguen fallando, se trasladan a un destino de excepción, si se ha configurado alguno.
Habilitar
Información | Valor |
---|---|
Required | No |
Tipo de datos | Booleano |
Umbral de mensaje fallido secuencial
Esta propiedad no está habilitada a menos que la propiedad Detener automáticamente los puntos finales al repetirse una anomalía de mensaje esté habilitada.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Entero |
Retardo entre reintentos de mensaje fallido
Establecer un retardo entre los reintentos de un mensaje que falla reduce el número de mensajes que se mueven innecesariamente al destino de excepción antes de que se detenga el MDB. Para minimizar el número de mensajes que se mueven, haga que este retardo sea mayor que el intervalo de tiempo esperado entre los mensajes que llegan al destino.
Esta propiedad no está habilitada a menos que la propiedad Detener automáticamente los puntos finales al repetirse una anomalía de mensaje esté habilitada.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Entero |
Rango | El tiempo en milisegundos. El valor 0 indica que no hay ningún retraso entre reintentos. |
Duración de suscripción
Información | Valor |
---|---|
Required | No |
Tipo de datos | lista desplegable |
Rango |
|
Nombre de suscripción
Este nombre de suscripción debe ser exclusivo en un identificador de cliente concreto.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Identificador de cliente
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Inicio de suscripción
Información | Valor |
---|---|
Required | No |
Tipo de datos | Serie |
Pasar carga útil de mensajes por referencia
Las aplicaciones que utilizan esta especificación de activación para recibir mensajes deben seguir la siguiente regla:
- La aplicación no modifica el objeto de datos obtenido de un mensaje de objeto JMS. El objeto de datos se trata como de sólo lectura.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Booleano |
Las aplicaciones que reenvían mensajes que se recibieron originalmente utilizando esta especificación de activación deben seguir las siguientes reglas:
- La aplicación puede sustituir el objeto de datos en un mensaje de objeto JMS, siempre que el objeto de datos todavía no se haya establecido en el mensaje. La aplicación no modifica, ni sustituye el objeto de datos después de que se haya establecido en el mensaje.
- La aplicación puede sustituir la matriz de bytes en un mensaje de bytes JMS, pero sólo mediante el uso de una sola llamada a writeBytes(byte[]) y siempre que la matriz de bytes todavía no se haya establecido en el mensaje. La aplicación no modifica ni sustituye la matriz de bytes después de que se haya establecido en el mensaje.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Booleano |
Lectura anticipada
Los mensajes asignados a un consumidor se bloquean en el servidor y ninguno de los consumidores de ese destino pueden consumirlos. Los mensajes asignados a un consumidor, pero no consumidos antes de que se cierre el consumidor, se desbloquean posteriormente en el servidor y quedan disponibles para poder ser recibidos por otros consumidores.
Puede alterar temporalmente esta propiedad para destinos de JMS individuales estableciendo la propiedad Lectura hacia adelante en el destino de JMS.
Información | Valor |
---|---|
Required | No |
Tipo de datos | lista desplegable |
Rango |
|
Activar siempre los MDB en todos los servidores
Esta propiedad sólo se utiliza cuando la aplicación MDB se ejecuta en un servidor que sea miembro del bus que la aplicación tiene como destino. No tiene ningún efecto cuando el MDB se ejecuta en un servidor que no es miembro del bus de destino.
Si la aplicación MDB se ejecuta en un servidor que es miembro del bus de destino, si se habilita esta opción se permite a la aplicación MDB procesar mensajes tanto si el servidor también aloja un motor de mensajería en ejecución como si no. Si esta opción no se habilita, las aplicaciones MDB que se encuentran en servidores que no tengan un ME local en ejecución no procesarán mensajes.
- Todos los servidores del clúster pueden recibir mensajes de la aplicación MDB para aprovechar al máximo la potencia de proceso del clúster.
- Para asegurar el proceso secuencial de los mensajes, sólo un servidor a la vez puede recibir mensajes de la aplicación MDB.
Para obtener más información consulte el tema Cómo se conecta un bean controlado por mensajes en un clúster.
Información | Valor |
---|---|
Required | No |
Tipo de datos | Booleano |
Intervalo de reintento
Información | Valor |
---|---|
Required | No |
Tipo de datos | Entero |
Rango | 1 a 2147483647 |
Alias de autenticación
Un alias de autenticación de Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) especifica el ID de usuario y la contraseña utilizados para autenticar la creación de una nueva conexión con el proveedor de JMS.
Los campos de las propiedades personalizadas de nombre de usuario y contraseña deben dejarse sin especificar si se utiliza el campo del alias de autenticación. Las propiedades del alias de autenticación establecidas como parte del despliegue de aplicaciones tienen prioridad sobre las propiedades establecidas en el objeto administrativo de especificación de activación.
Sólo el alias de autenticación se escribe siempre a archivo sin cifrar, aún cuando sea para el registro cronológico de recuperación de transacciones. El servicio de seguridad se utiliza para proteger el nombre de usuario real y la contraseña.
Durante el inicio de la aplicación, cuando se inicializa la especificación de activación como parte de la activación del punto final, el servidor utiliza el alias de autenticación para recuperar el nombre de usuario real y la contraseña de seguridad, luego lo establece en la instancia de especificación de activación.
Información | Valor |
---|---|
Required | No |
Tipo de datos | lista desplegable |