Configuration d'attributs de déploiement pour un bean géré par message sur des ressources compatibles JCA 1.5

Vous pouvez configurer les attributs de déploiement des beans gérés par messages pour une application d'entreprise compatible avec l'architecture Java™ EE Connector (JCA) 1.5 afin de remplacer les attributs de déploiement définies dans le fichier EAR de l'application.

Avant de commencer

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.

Remarque : Vous pouvez poursuivre la configuration de beans gérés par message sur un port d'écoute. Cela peut être utile, par exemple, pour la compatibilité avec des applications de bean géré par message existantes. Toutefois, les ports d'écoute sont stabilisés et vous devez prévoir de faire migrer tous vos beans gérés par message pour utiliser des ressources compatibles avec JCA 1.5 ou 1.6.

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. Passez en revue et, au besoin, modifiez les attributs de déploiement.
    1. Dans le panneau des propriétés, sélectionnez l'onglet Bean.
    2. Sous Configuration d'activation, vérifiez les attributs.
      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.

    3. Spécifiez les attributs de déploiement des liaisons.

      Sous Liaisons WebSphere, sélectionnez l'option Adaptateur JCA et spécifiez les attributs de déploiement des liaisons :

      Nom JNDI de la spécification d'activation
      Cet attribut définit le nom JNDI de la spécification d'activation utilisée pour déployer le bean géré par messages. Ce nom doit correspondre au nom d'une spécification d'activation que vous définissez dans WebSphere Application Server.
      Alias d'autorisation de la spécification d'activation
      Cet attribut définit le nom d'un alias d'authentification utilisé pour l'authentification des connexions auprès de l'adaptateur de ressource JCA. Un alias d'authentification indique l'ID utilisateur et le mot de passe utilisés pour authentifier la création d'une connexion auprès de l'adaptateur de ressources JCA.
      Nom JNDI de destination
      Cet attribut définit le nom JNDI utilisé par le bean géré par messages pour rechercher la destination JMS dans l'espace de nom JNDI.
  5. 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.
  6. Vérifiez les fichiers archive.
  7. Dans le menu contextuel du projet, cliquez sur Déployer pour générer le code de déploiement d'EJB.
  8. 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_depa3
Nom du fichier : tmb_depa3.html