Vous pouvez configurer les attributs de déploiement des beans gérés par message pour un bean enterprise, afin de remplacer les attributs de déploiement définis dans le fichier EAR de l'application.
Avant de commencer
Les ports d'écoute sont stabilisés. Pour plus d'informations, lisez l'article sur les fonctions stabilisées. Il est conseillé de ne configurer votre application
que sur un port d'écoute compatible avec les applications bean gérées par message
existantes.
Autrement, vous devez configurer votre application sur des ressources
compatibles JCA 1.5.
Si certains beans gérés par message utilisent le fournisseur de messagerie
IBM MQ (ou un fournisseur JMS tiers compatible) avec des ports d'écoute
et que vous souhaitez utiliser des beans gérés par message EJB 3 avec des ports
d'écoute, ces nouveaux beans peuvent continuer d'utiliser le même fournisseur
de messagerie.
Cette tâche suppose que vous avez un fichier EAR, qui contient une application d'entreprise développée en tant que bean géré par message, lequel peut être déployé dans WebSphere Application Server.
Pourquoi et quand exécuter cette tâche
Vous configurez les attributs de déploiement d'une application bean gérée par messages à
l'aide d'un outil d'assemblage. La procédure détaillée dans cette tâche est valable pour Rational Application
Developer, mais les procédures relatives aux autres outils sont très similaires.
Procédure
- Démarrez l'outil d'assemblage.
- Editez le fichier EAR de l'application. Par exemple,
utilisez l'assistant d'importation Rational Application Developer
pour d'importer le fichier EAR
dans l'outil d'assemblage. Pour démarrer l'assistant d'importation :
- Cliquez sur .
- Cliquez sur Suivant, puis sélectionnez le fichier EAR.
- Cliquez sur Terminer.
- Ouvrez les attributs de déploiement pour l'édition. Dans la vue Hiérarchie Java EE, cliquez avec le bouton droit de la souris sur le module EJB du bean géré par message, puis cliquez sur . Un bloc-notes des propriétés de l'instance du bean géré par messages s'affiche dans la sous-fenêtre des propriétés.
- Spécifiez les attributs de déploiement généraux.
- Dans le panneau des propriétés, sélectionnez l'onglet Bean.
- Dans le panneau principal, configurez l'attribut Type de transaction.
Cet attribut indique si le bean géré par messages gère ses propres transactions ou si le conteneur
gère les transactions pour le compte du bean.
- Bean
- Le bean géré par messages gère ses propres transactions.
- Conteneur
- Le conteneur gère les transactions pour le compte du bean.
- Sous Configuration d'activation, vérifiez les attributs suivants :
Remarque : Pour les beans gérés par message EJB 3, vous pouvez utiliser les annotations EJB 3 pour configurer les propriété de configuration de l'activation. N'utilisez pas les annotations EJB 3 pour modifier ou remplacer les données du descripteur de déploiement de bean. Si une propriété de configuration d'activation est spécifiée aux deux emplacements, la valeur utilisée est celle du descripteur de déploiement.
- acknowledgeMode
- Cet attribut définit la manière dont la session accuse réception des messages qu'elle reçoit.
- Reconnaissance automatique
- La session accuse réception automatiquement des messages.
- Doubles autorisés
- La session accuse réception en différé à la distribution
des messages. Ce paramètre risque de distribuer des messages en double en cas de défaillance de JMS. Par conséquent, il ne doit être utilisé que par les utilisateurs
qui acceptent les messages en double.
- destinationType
- Cet attribut indique si le bean géré par message utilise une file d'attente ou une rubrique comme destination.
- File d'attente
- Le bean géré par message utilise une destination de type file d'attente.
- Rubrique
- Le bean géré par message utilise une destination de type rubrique.
- subscriptionDurability
- Cet attribut indique si un abonnement à une rubrique JMS est durable ou non.
- Durable
- Un abonné
enregistre un abonnement durable avec une identité
unique qui est retenue par JMS.
Les objets abonnés suivants ayant la même identité reprennent
l'abonnement dans l'état où l'abonné précédent l'a laissé. S'il n'existe aucun
abonné actif pour un abonnement durable, JMS conserve les messages d'abonnement
jusqu'à leur réception par l'abonnement ou jusqu'à leur expiration.
- Non durable
- Les abonnements non durables ont la durée de leur objet abonné. Un client voit uniquement les messages publiés dans une
rubrique lorsque l'abonné est actif. Si l'abonné n'est pas actif, le client manque des messages publiés dans cette rubrique.
Un abonné non durable ne peut être utilisé que dans le contexte de transaction
(par exemple, une transaction globale ou un contexte de transaction non indiqué)
qui existait lors de la création de l'abonné.
- messageSelector
- Cet attribut indique le sélecteur de messages JMS à utiliser pour déterminer les messages
que reçoit le bean géré par message. Par exemple :
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.
- Indiquez l'attribut de déploiement des liaisons.
- Sous la section des liaisons WebSphere, définissez
l'attribut suivant :
- Nom du port d'écoute
- Nom du port d'écoute pour ce bean géré par message.
- Enregistrez les modifications dans le descripteur de déploiement :
- Fermez l'éditeur du descripteur de déploiement.
- A l'invite, cliquez sur Oui pour sauvegarder les
modifications apportées au descripteur de déploiement.
- Vérifiez les fichiers archive.
- Dans le menu contextuel du projet, cliquez sur
Déployer pour générer le code de déploiement
d'EJB.
- Facultatif : Testez le module terminé sur une installation WebSphere Application
Server.
Cliquez à l'aide du bouton droit sur un module, cliquez sur Exécuter sur le serveur, puis suivez les instructions qui figurent dans l'assistant proposé.
Restriction : L'option Exécuter sur le serveur fonctionne uniquement sur les systèmes d'exploitation Windows, Linux/Intel et AIX. Vous ne pouvez pas effectuer de déploiement à
distance vers une installation de WebSphere Application
Server sur un système d'exploitation UNIX tel que Solaris.
Important : N'utilisez l'option
Exécuter sur le serveur que dans le cadre d'un test d'unité. Lorsqu'une application est publiée à distance, l'outil d'assemblage remplace le fichier de configuration du serveur pour ce serveur. Ne l'utilisez pas sur des serveurs de production.
Que faire ensuite
Après avoir assemblé votre application, utilisez un outil de gestion des systèmes pour déployer le fichier EAR sur le serveur d'applications destiné à exécuter l'application, à l'aide de la console d'administration, par exemple, comme indiqué dans Déploiement et gestion d'applications.