Pour chaque bean géré par message défini dans un fichier ejb-jar.xml ou une annotation @MessageDriven dans l'unité de composition, vous pouvez spécifier les paramètres nécessaires à la liaison d'un programme d'écoute de bean de message au bean géré par message.
En liant un programme d'écoute à un bean géré par message, vous configurez l'association du bean géré par message à la destination JMS à partir de laquelle le bean géré par message reçoit les messages.
Ce panneau affiche une ligne d'informations pour chaque bean géré par message. Les trois dernières colonnes, Nom JNDI de la spécification d'activation, Nom JNDI de la destination et Alias d'authentification, indiquez les informations de liaison.
Si un paramètre de liaison est défini dans un fichier de configuration XML ou dans une annotation @MessageDriven, celui-ci s'affiche dans la colonne correspondante, sinon la colonne est vide. Si nécessaire, vous pouvez modifier des paramètres de liaison existants et en spécifier de nouveaux en entrant des valeurs dans les colonnes appropriées.
Pour afficher ce panneau dans la console d'administration, cliquez sur l'un des chemins suivants :
Remarque : L'étape de l'assistant Liaison des programmes d'écoute pour les beans gérés par message et la propriété Programmes d'écoute pour les beans gérés par message ne sont visibles que si l'application OSGi contient au moins un bundle EJB comportant au moins un bean géré par message.
Propriétés générales
- Nom symbolique du bundle
- Nom non localisable de ce bundle.
- Version du bundle
- La version de ce bundle.
Le nom symbolique, ainsi que la version, identifie un bundle de manière unique.
- URI
- URI de l'emplacement où est défini le bean géré par message. Le tableau suivant décrit la syntaxe de l'URI en fonction de l'emplacement de la définition de bean géré par message :
| Emplacement de la définition du bean géré par message |
Syntaxe de l'URI |
Exemples |
|---|
| Fichier ejb-jar.xml |
Chemin d'accès au fichier suivi du nom du bean géré par message. |
META-INF/ejb-jar.xml/CustomerDetails ou WEB-INF/ejb-jar.xml/CustomerDetails |
| Annotation @MessageDriven dans un bean enterprise |
Chemin d'accès au fichier ejb-jar.xml qui contient la définition du bean géré par message dans lequel l'annotation @MessageDriven est déclarée, suivi du nom du bean géré par message. |
META-INF/ejb-jar.xml/CustomerDetails ou WEB-INF/ejb-jar.xml/CustomerDetails |
- Nom JNDI de la spécification d'activation
- Nom JNDI de la spécification d'activation que vous voulez associer au bean géré par message. La spécification d'activation fournit la configuration permettant au bean géré par message de recevoir des messages d'une destination JMS.
- Nom JNDI de la destination
- Nom JNDI de la destination JMS depuis laquelle le bean géré par message reçoit des messages. Indiquez une valeur uniquement si vous souhaitez remplacer la destination JMS configurée dans la spécification d'activation.
- Alias d'authentification ActivationSpec
- Si la spécification d'activation est sécurisée, indiquez l'alias d'authentification associé qui définit l'ID utilisateur et le mot de passe. Indiquez une valeur uniquement si vous souhaitez remplacer l'alias d'authentification configuré dans la spécification d'activation.
Application de plusieurs mappages
Vous pouvez appliquer un paramètre de liaison à deux ou plusieurs beans gérés par message en une seule opération. Effectuez les étapes suivantes :
- Cochez les cases dans la colonne Sélection en regard des beans gérés par message auxquels vous souhaitez appliquer le paramètre de liaison.
- Développez Appliquer plusieurs mappages.
- Sélectionnez le paramètre Nom JNDI de la spécification d'activation, Nom JNDI de la destination ou Alias d'authentification ActivationSpec que vous souhaitez appliquer aux beans gérés par message et cliquez sur le bouton Appliquer correspondant.
Le paramètre de liaison est appliqué aux beans gérés par message sélectionnés.
Les liens marqués (en ligne) requièrent un accès à Internet. Chaque lien permet de lancer une recherche dans la rubrique du centre de documentation en ligne. Lorsque les résultats s'affichent, sélectionnez la rubrique correspondant le mieux à votre configuration.