Configuration d'attributs de déploiement pour un bean géré par message sur un port d'écoute

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

  1. Démarrez l'outil d'assemblage.
  2. 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 :
    1. Cliquez sur Fichier > Importer > fichier EAR.
    2. Cliquez sur Suivant, puis sélectionnez le fichier EAR.
    3. Cliquez sur Terminer.
  3. 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 Ouvrir avec > Editeur du descripteur de déploiement. 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.
  4. Spécifiez les attributs de déploiement généraux.
    1. Dans le panneau des propriétés, sélectionnez l'onglet Bean.
    2. 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.
  5. 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.

  6. Indiquez l'attribut de déploiement des liaisons.
    1. 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.
  7. Enregistrez les modifications dans le descripteur de déploiement :
    1. Fermez l'éditeur du descripteur de déploiement.
    2. A l'invite, cliquez sur Oui pour sauvegarder les modifications apportées au descripteur de déploiement.
  8. Vérifiez les fichiers archive.
  9. Dans le menu contextuel du projet, cliquez sur Déployer pour générer le code de déploiement d'EJB.
  10. 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.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmb_depa2
Nom du fichier : tmb_depa2.html