Spécification d'activation JMS [Paramètres]
Vous devez créer une spécification d'activation JMS si vous souhaitez utiliser un bean géré par message pour communiquer avec le fournisseur de messagerie par défaut via JCA (Java™ EE Connector Architecture) 1.5. JCA offre une connectivité Java entre les serveurs d'applications (WebSphere Application Server, par exemple) et les systèmes d'information d'entreprise. Cela permet de standardiser les fournisseurs JMS d'intégration aux serveurs d'applications Java et de fournir une infrastructure d'échange de données avec les systèmes d'entreprise, où les données sont transférées sous forme de messages.
Toutes les propriétés de configuration des spécifications d'activation, exceptées les propriétés Nom, Nom JNDI, Nom JNDI de destination, Recherche de destination et Alias d'authentification sont remplacées par des propriétés de configuration d'activation nommées de manière appropriée dans le descripteur de déploiement d'un bean géré par message EJB 2.1 ou ultérieur. Pour un bean géré par message EJB 2.0, les propriétés Type de destination, Durabilité de l'abonnement, Mode d'identification et Sélecteur de message sont remplacées par les éléments correspondants dans le descripteur de déploiement. Pour ces deux types de bean, la propriété Nom JNDI de destination ou Recherche de destination peut être remplacée par une valeur spécifiée dans les liaisons du bean géré par message.
Les propriétés de la spécification d'activation influencent la manière dont le fournisseur de messagerie par défaut choisit le moteur de messagerie auquel l'application de bean géré par message se connecte. Par défaut, l'environnement connecte automatiquement les applications à un moteur de messagerie disponible sur le bus. Toutefois, vous pouvez indiquer des informations de configuration supplémentaires pour contrôler le processus de connexion ; par exemple, pour identifier des serveurs d'amorçage spéciaux ou pour limiter la connexion à un sous-groupe de moteurs de messagerie disponibles, ou pour améliorer la disponibilité ou les performances ou assurer le traitement séquentiel des messages reçus. Pour plus d'informations sur les raisons justifiant cette action et la manière de procéder, voir la rubrique Connexion des applications JMS à un moteur de messagerie d'un bus.
Onglet Configuration
L'onglet Configuration contient les propriétés de configuration de cet objet. Ces valeurs de propriétés sont préservées même si l'environnement d'exécution est arrêté puis redémarré. Consultez les descriptions de tâches dans le centre de documentation pour savoir comment appliquer des modifications de configuration à l'environnement d'exécution.
Propriétés générales
Portée
Indique le niveau topologique le plus élevé auquel les serveurs d'applications peuvent utiliser cet objet de ressource.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Fournisseur
Indique un fournisseur JMS qui active la messagerie asynchrone en fonction du service JMS (Java Message Service). Il fournit des fabriques de connexion J2EE afin de créer des connexions pour une file d'attente JMS ou des destinations de sujets spécifiques. Les objets d'administration du fournisseur JMS permettent de gérer les ressources JMS du fournisseur JMS associé.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Chaîne
Nom affiché obligatoire de la ressource.
Information | valeur |
---|---|
Obligatoire | Yes |
Type de données | String (chaîne) |
Nom JNDI
Nom JNDI de la ressource.
Information | valeur |
---|---|
Obligatoire | Yes |
Type de données | String (chaîne) |
Description
Description facultative de la ressource.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Zone de texte |
Type de destination
Information | valeur |
---|---|
Obligatoire | Yes |
Type de données | liste déroulante |
Intervalle |
|
Recherche de destination
Sélectionnez le type de destination dans la propriété Type de destination.
Pour les adaptateurs de ressources prenant en charge JMS, vous devez associer javax.jms.Destinations à une spécification d'activation, de façon à ce que l'adaptateur puisse traiter des messages provenant de la destination JMS. Dans ce cas, l'administrateur configure un objet administré J2C qui implémente l'interface javax.jms.Destination et l'associe dans JNDI.
Vous pouvez configurer un objet administré J2C pour employer une classe ActivationSpec implémentant une méthode setDestination(javax.jms.Destination). Dans ce cas, vous pouvez préciser la recherche de destination (à savoir le nom JNDI pour l'objet administré J2C qui implémente javax.jms.Destination).
Information | valeur |
---|---|
Obligatoire | Yes |
Type de données | String (chaîne) |
Recherche de fabrique de connexions
Nom JNDI de la fabrique de connexions.
Information | valeur |
---|---|
Obligatoire | Yes |
Type de données | String (chaîne) |
Sélecteur de messages
JMSType='car' AND color='blue' AND weight>2500
La chaîne du sélecteur peut faire référence aux zones de l'en-tête du message JMS et aux zones des propriétés du message. Les sélecteurs de messages ne peuvent pas faire référence à des valeurs liées au corps du message.
Une valeur null (chaîne vide) indique qu'il n'existe aucun sélecteur de message pour le consommateur du message.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Nom du bus
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Personnalisé |
Mode de reconnaissance
L'accusé de réception est envoyé quand le message est supprimé.
- Si le système est configuré pour supprimer le message à la fin du bean, le message est envoyé à une nouvelle instance du bean pour être traité.
- Si le système est configuré pour supprimer le message au démarrage du bean, le message est perdu.
Le message est supprimé au démarrage du bean si la qualité de service est définie sur Meilleur effort non persistant. Pour toutes les autres qualités de service, le message est supprimé à la fin de l'exécution du bean.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Cible
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Type de cible
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Importance de la cible
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Chaîne de transport entrant cible
Si le moteur de messagerie sélectionné se trouve sur le même serveur que l'application, une connexion directe en cours de processus est établie et cette propriété de chaîne de transport est ignorée.
- InboundBasicMessaging
- Il s'agit d'un protocole orienté connexion qui utilise une connexion standard TCP/IP (JFAP-TCP/IP). Il prend en charge deux flux transactionnels biphasé (XA distant). Un émetteur ou un destinataire de messages qui fonctionne sur un système client ou serveur peut participer à une transaction globale gérée sur ce système client ou serveur. Les flux XA permettent à une application exécutée sur un serveur d'accéder à un moteur de messagerie sur un deuxième serveur dans la mesure où le premier serveur n'héberge pas de moteur le messagerie approprié. Si les flux XA distants sont utilisés, l'application doit pouvoir accéder à un coordinateur de transactions en local.
- InboundSecureMessaging
- Il s'agit du protocole InboundBasicMessaging encapsulé dans SSL.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Noeuds finaux du fournisseur
Liste comportant trois noeuds finaux séparés par des virgules, avec la syntaxe Nomhôte:Numéroport:Nomchaîne, utilisée pour se connecter à un serveur d'amorçage. Par exemple Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Si le nom d'hôte n'est pas indiqué, localhost est utilisé comme valeur par défaut.
Si le numéro de port n'est pas indiqué, 7276 est utilisé comme valeur par défaut.
Si le protocole n'est pas indiqué, une chaîne prédéfinie comme BootstrapBasicMessaging est utilisée comme valeur par défaut.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Zone de texte |
Taille de lot maximale
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Entierr |
Intervalle | 1 à 2147483647 |
Nombre maximal d'appels MDB simultanés par noeud final
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Entierr |
Intervalle | 1 à 2147483647 |
Arrêter automatiquement les noeuds finaux lors d'échecs répétés des messages
Ces paramètres permettent à un noeud final de s'arrêter automatiquement lorsque le nombre de messages en situation d'échec du point de vue séquentiel atteint une limite spécifiée. Cela permet de faire la distinction entre un ou deux messages qui échouent en raison d'incidents avec les messages eux-mêmes, et un incident de ressource système donnant lieu à des messages en situation d'échec du point de vue séquentiel.
Lorsqu'un noeud final est arrêté automatiquement, son état sur le panneau de la console d'administration est rouge. Il doit être redémarré manuellement en cliquant sur Reprendre.
Une fois le noeud final redémarré, les messages qui échouent provoquant l'arrêt du noeud final sont de nouveau envoyés. S'ils continuent d'échouer, ils sont déplacés vers une destination d'exception, si celle-ci a été configurée.
Activée
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Seuil d'échecs de messages séquentiels
Cette propriété n'est pas activée à moins que la propriété Arrêter automatiquement les noeuds finaux lors d'échecs répétés des messages soit activée.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Entierr |
Fréquence entre deux échecs de message
Définir un délai entre chaque envoi de message défaillant réduit le nombre des messages déplacés inutilement vers une destination d'exception avant l'arrêt du MDB. Pour minimiser le nombre de messages déplacés, entrez un délai supérieur à l'intervalle attendu entre chaque arrivée de message à la destination.
Cette propriété n'est pas activée à moins que la propriété Arrêter automatiquement les noeuds finaux lors d'échecs répétés des messages soit activée.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Entierr |
Intervalle | La durée est en millisecondes. La valeur 0 indique qu'il n'y a pas de délai entre les tentatives. |
Durabilité de l'abonnement
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Nom de l'abonnement
Le nom de cet abonnement doit être unique dans un identificateur de client donné.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Identificateur client
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Page d'accueil des abonnements
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | String (chaîne) |
Transmission de la charge de messages par référence
Les applications qui utilisent la spécification d'activation pour recevoir les messages doivent respecter la règle suivante :
- L'application ne modifie pas l'objet de données obtenu à partir du message d'objet JMS. L'objet des données sont traitées en mode lecture seule.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Les applications renvoyant les messages initialement reçus à l'aide de cette spécification d'activation doivent respecter les règles suivantes :
- L'application peut remplacer l'objet de données dans un message JMS à condition qu'il n'ait pas encore été défini dans le message. L'application ne modifie ou ne remplace pas l'objet de donnés après sa définition dans le message.
- L'application peut remplacer le tableau d'octets dans un message d'octets JMS, mais uniquement en utilisant un seul appel à writeBytes(byte[]) et si le tableau d'octets n'a pas encore été défini dans le message. L'application ne modifie ou ne remplace pas le tableau d'octets après sa définition dans le message.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Lecture anticipée
Les messages affectés à un destinataire sont verrouillés sur le serveur et ne peuvent pas être consommés par d'autres destinataires de cette destination. Les messages affectés à un destinataire, mais qui ne sont pas consommés avant la fermeture du client, sont ensuite déverrouillés sur le serveur, puis prêts à être reçus par d'autres destinataires.
Vous pouvez redéfinir cette propriété pour des destinations JMS en définissant la propriété Lecture anticipée sur la destination JMS.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |
Intervalle |
|
Toujours activer les beans MDB dans tous les serveurs
Cette propriété est utilisée uniquement lorsque l'application à bean géré par message s'exécute sur un serveur membre du bus que l'application cible. Elle n'a pas d'effet lorsque le bean géré par message s'exécute sur un serveur membre du bus cible.
Si l'application de bean géré par message (MDB) s'exécute sur un serveur membre du bus cible, l'activation de cette option permet à l'application de traiter les messages, que le serveur héberge ou non également un moteur de messagerie actif. Si cette option n'est pas activée, les applications à bean géré par messages des serveurs qui ne disposent pas de moteur de messagerie local ne traitent pas les messages.
- Tous les serveurs du cluster peuvent recevoir des messages d'une application de beans gérés par messages pour tirer pleinement parti de la puissance de traitement du cluster.
- Un seul serveur à la fois peut recevoir les messages de l'application de beans gérés par message pour assurer le traitement séquentiel des messages.
Pour plus d'informations, voir la rubrique Connexion d'un bean géré par message dans un cluster.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Booléenne |
Intervalle entre les nouvelles tentatives
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | Entierr |
Intervalle | 1 à 2147483647 |
Alias d'authentification
Un alias d'authentification Java Platform, Enterprise Edition (Java EE) JCA (Connector Architecture) spécifie l'ID utilisateur et le mot de passe qui permettent d'authentifier la création d'une connexion au fournisseur JMS.
Les propriétés personnalisées de nom d'utilisateur et de mot de passe ne doivent pas être définies si la zone d'alias d'authentification est utilisée. Les propriétés d'alias d'authentification définies dans le déploiement de l'application sont prioritaires sur celles définies pour un objet d'administration de la spécification d'activation.
Seul l'alias d'authentification figure dans un fichier de façon chiffrée, même pour la consignation de reprise de transaction. Le service de sécurité sert à protéger le nom d'utilisateur et le mot de passe.
Au démarrage de l'application, lorsque la spécification d'activation est initialisée comme élément de l'activation du point de contact, le serveur se sert de l'alias pour obtenir le nom d'utilisateur et le mot de passe et le définit dans l'instance de la spécification d'activation.
Information | valeur |
---|---|
Obligatoire | Non |
Type de données | liste déroulante |