Configuration des règles de transport JMS (Java Message Service)

Vous pouvez définir la configuration d'une règle de transport JMS (Java™ Message Service) si vous utilisez SOAP sur JMS avec vos applications JAX-WS (Java API for XML-Based Web Services).

Avant de commencer

Vous pouvez configurer certains paramètres pour les règles des ensembles de règles personnalisés. Les ensembles de règles par défaut fournis ne sont pas modifiables. Vous devez créer une copie de l'ensemble de règles par défaut ou un ensemble de règles totalement nouveau afin de spécifier ses règles.

Pourquoi et quand exécuter cette tâche

Lors de l'utilisation du transport SOAP sur JMS avec des applications JAX-WS, vous pouvez personnaliser le transport en configurant la règle de transport JMS. Le transport SOAP sur JMS fournit une alternative au protocole HTTPS pour le transport des requêtes SOAP et des messages de réponse entre clients et serveurs. Pour plus d'informations sur ce protocole de transport, voir la documentation relative à l'utilisation de SOAP sur JMS pour le transport des services Web.

Vous pouvez configurer une règle uniquement par l'intermédiaire d'un ensemble de règles. Par conséquent, un ensemble de règles contenant la règle de transport JMS doit exister avant de pouvoir configurer celle-ci. Pour personnaliser un ensemble de règles contenant la règle de transport JMS, vous devez d'abord créer un ensemble de règles et lui ajouter la règle de transport JMS.

Le panneau des paramètres de la règle de transport JMS permet de personnaliser les valeurs des propriétés de la règle de transport JMS, comme la valeur du délai d'expiration de requête. Vos valeurs personnalisées pour la règle de transport JMS s'appliquent à présent à votre ensemble de règles qui contient cette règle de transport JMS personnalisée. Vous pouvez associer l'ensemble de règles contenant votre règle de transport JMS personnalisée à votre application, ses services, ses noeuds finaux ou ses opérations. Cette modification a un impact sur l'ensemble des applications JAX-WS auxquelles cet ensemble de règles est associé. Pour savoir comment associer des ensembles de règles à des applications, consultez la documentation relative à la gestion des ensembles de règles pour les fournisseurs de services et les clients de service au niveau de l'application.

Procédure

  1. Créez un ensemble de règles contenant la règle de transport JMS.
    1. Créez un ensemble de règles personnalisé. Dans la console d'administration, cliquez sur Services > Ensembles de règles > Ensembles de règles de l'application. Dans ce panneau, vous pouvez créer un ensemble de règles, importer une copie d'un ensemble de règles à partir du référentiel par défaut ou importer un ensemble de règles existant à partir de l'emplacement spécifié.
    2. Ajoutez la règle de transport JMS à l'ensemble de règles. Dans la console d'administration, cliquez sur Services > Ensembles de règles > Ensembles de règles de l'application > nom_ensemble_règles. Dans l'ensemble de règles, cliquez sur Transport JMS. La fenêtre Transport JMS affiche les options de configuration des paramètres JMS pour la règle de transport.
    3. Spécifiez les propriétés de connexion JMS pour les demandes de transport JMS. Les zones suivantes configurent les fonctions JMS pour ce transport :
      Délai d'expiration de la requête
      Indique si une valeur de délai d'expiration de requête doit être activée. Cette valeur correspond à la durée pendant laquelle un client attend une réponse avant d'envoyer la demande au serveur. Les valeurs possibles sont comprises entre 0 et 2147483647.
      Autoriser une messagerie transactionnelle pour des opérations unidirectionnelles et asynchrones.
      Indique l'autorisation d'un client à utiliser des transactions dans les demandes unidirectionnelles ou bidirectionnelles asynchrones. Cochez cette case pour activer une messagerie transactionnelle.
      Lorsque cette option est sélectionnée, l'environnement d'exécution du client échange la demande SOAP et les messages de réponse avec le serveur sur le transport JMS de manière transactionnelle si le client opère sous une transaction. Ce processus indique que la transaction du client est utilisée pour envoyer le message de demande SOAP à la file d'attente ou à la rubrique de destination et que le serveur reçoit le message de demande uniquement après que le client ait validé la transaction. De même, le serveur reçoit le message de demande sous le contrôle d'une transaction gérée par conteneur et le cas échéant, renvoie le message de réponse au client à l'aide de la même transaction. Le client reçoit alors le message de réponse uniquement après que la transaction du serveur ait été validée.
      Si cette option n'est pas sélectionnée, les environnement d'exécution du client et du serveur effectuent des opérations de messagerie de manière non transactionnelle du fait que les transactions sont temporairement interrompues pour la demande JMS. Les transactions sont réactivées une fois la demande achevée.
      Configurations prises en charge Configurations prises en charge: Les opérations de messagerie transactionnelle ne sont pas prises en charge pour les opérations synchrones bidirectionnelles du fait qu'elles entraînent un blocage.sptcfg
  2. Personnalisez les liaisons du fournisseur de transport JMS.
    1. Accédez aux liaisons du fournisseur de transport JMS. Dans la console d'administration, cliquez sur Services > Ensembles de règles > Liaisons générales de l'ensemble de règles du fournisseur > nom_liaison_ensemble_règles_fournisseur > Transport JMS.

      La fenêtre des liaisons du fournisseur de transport JMS affiche les options permettant de définir l'authentification de base pour les réponses de service asynchrones et les propriétés personnalisées pour la configuration des liaisons du fournisseur de services JMS.

    2. Spécifiez les propriétés de l'authentification de base pour les réponses de service asynchrones.

      Vous pouvez utiliser les liaisons de règle du fournisseur de transport JMS pour configurer un service utilisant le transport JMS afin de renvoyer des messages de réponse asynchrones au client. L'environnement d'exécution du serveur d'applications utilise le nom d'utilisateur et le mot de passe que vous configurez lors de la connexion au fournisseur de messagerie JMS et cette configuration permet au service d'envoyer un message de réponse asynchrone au client de manière sécurisée.

      Les zones suivantes déterminent les exigences pour l'authentification des réponses émanant du serveur :

      Nom d'utilisateur
      Spécifie le nom d'utilisateur pour les réponses de service asynchrone du fournisseur de services.
      Mot de passe
      Spécifie une marque de réservation pour le mot de passe pour les réponses de service asynchrones du fournisseur de services. Vous pouvez entrer ou modifier le mot de passe dans cette zone. Le mot de passe en cours est masqué.
      Confirmation du mot de passe
      Spécifie une marque de réservation pour le mot de passe du proxy de réponses de service asynchrones du fournisseur de services qui doit correspondre à celui de la zone Mot de passe. Le mot de passe en cours est masqué.
  3. Personnalisez les liaisons du client de transport JMS.
    1. Accédez aux liaisons du client de transport JMS. Dans la console d'administration, cliquez sur Services > Ensembles de règles > Liaisons générales de l'ensemble de règles du client > nom_liaison_ensemble_règles_client > Transport JMS.

      La fenêtre des liaisons du fournisseur de transport JMS affiche les options permettant de définir l'authentification de base pour les demandes de service sortantes et les propriétés personnalisées pour la configuration des liaisons du client JMS.

    2. Spécifiez les propriétés de l'authentification de base pour les demandes de service sortantes.

      Vous pouvez utiliser les liaisons de règle du client de transport JMS pour configurer un client utilisant le transport JMS afin d'envoyer un message de demande au serveur. L'environnement d'exécution du client utilise le nom d'utilisateur et le mot de passe que vous configurez lors de la connexion au fournisseur de messagerie JMS. Cette configuration permet au client d'envoyer le message de demande au serveur de manière sécurisée.

      Les zones suivantes déterminent les exigences d'authentification pour les demandes du serveur :

      Nom d'utilisateur
      Indique le nom d'utilisateur utilisé par l'environnement d'exécution du client lors de la connexion au fournisseur de messagerie JMS pour envoyer une demande sortante à la rubrique ou file d'attente de destination. Entrez un nom d'utilisateur dans cette zone.
      Mot de passe
      Spécifie une marque de réservation pour le mot de passe utilisé par l'environnement d'exécution du client lors de la connexion au fournisseur de messagerie JMS pour envoyer une demande sortante à la rubrique ou file d'attente de destination. Vous pouvez entrer ou modifier le mot de passe dans cette zone. Le mot de passe en cours est masqué.
      Confirmation du mot de passe
      Spécifie une marque de réservation pour le mot de passe utilisé par l'environnement d'exécution du client lors de la connexion au fournisseur de messagerie JMS pour envoyer une demande sortante à la rubrique ou file d'attente de destination. Entrez à nouveau le mot de passe dans cette zone. Ce mot de passe doit correspondre à celui qui figure dans la zone Mot de passe. Le mot de passe en cours est masqué.
  4. Affectez à la propriété personnalisées JVM com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse la valeur true.

    Voir la rubrique Propriétés personnalisées de la machine virtuelle Java pour savoir comment définir cette propriété.

  5. Enregistrez les modifications.

Résultats

Une fois la règle du transport JMS personnalisée, l'ensemble de règles lié l'utilise pour configurer le comportement d'exécution du transport SOAP sur JMS.

Exemple

Vous pouvez associer des ensembles de règles à une application, ses services, ses noeuds finaux ou ses opérations. Dans cet exemple de scénario, supposons que vous disposez de deux clients de service JAX-WS différents pour votre application, mais que vous souhaitez utiliser des valeurs de délai d'expiration de requête de transport JMS différentes pour chaque client de service. Pour modifier les valeurs de délai d'expiration de requête JMS, vous pouvez éditer les valeurs de la règle de transport JMS contenue dans l'ensemble de règles lié à votre application ou dans le cas présent, votre client de service. Cette modification affecte toutes les applications auxquelles l'ensemble de règles contenant la règle de transport JMS personnalisée est associé.

Cet exemple décrit les étapes pour la configuration des différentes valeurs de délai d'expiration de requête pour des clients de service déployés sur le même serveur d'applications. Cet exemple inclut les hypothèses suivantes :
  • Deux clients de service JAX-WS, ServiceClient1 et ServiceClient2, sont déployés sur le serveur d'applications.
  • La règle de transport JMS n'a pas été associée au préalable à ces applications.
  1. Créez deux ensembles de règles et ajoutez leur la règle de transport JMS. Par exemple : JMSServiceClient1Policy et JMSServiceClient2Policy
    1. Cliquez sur Services > Ensembles de règles > Ensembles de règles de l'application > Nouveau .
    2. Entrez le nom du nouvel ensemble de règles de l'application, JMSServiceClient1Policy.
    3. Dans la collection Règles, cliquez sur Ajouter > Transport JMS.
    4. Cliquez sur Appliquer et Sauvegarder pour sauvegarder vos modifications apportées à la configuration principale.
    5. Répétez ces étapes pour créer JMSServiceClient2Policy.
  2. Personnalisez les paramètres de la règle de transport JMS pour les ensembles de règles JMSServiceClient1Policy et JMSServiceClient2Policy nouvellement créés. Par exemple, définissez la valeur du délai d'expiration de requête à 180 secondes pour la règle de transport JMS contenue dans JMSServiceClient1Policy. LA règle de transport JMS contenue dans JMSServiceClient2Policy indique 300 secondes comme valeur de délai d'expiration de requête.
    1. Cliquez sur Services > Ensembles de règles > Ensembles de règles de l'application > JMSServiceClient1Policy .
    2. Dans la collection Règles, cliquez sur Transport JMS.
    3. Dans le panneau de configuration de la règle de transport JMS, spécifiez 180 secondes pour la valeur du délai d'expiration de requête.
    4. Cliquez sur Appliquer et Sauvegarder pour sauvegarder vos modifications apportées à la configuration principale.
    5. Cliquez sur Services > Ensembles de règles > Ensembles de règles de l'application > JMSServiceClient2Policy .
    6. Dans la collection Règles, cliquez sur Transport JMS.
    7. Dans le panneau de configuration de la règle de transport JMS, spécifiez 300 secondes pour la valeur du délai d'expiration de requête.
    8. Cliquez sur Appliquer et Sauvegarder pour sauvegarder vos modifications apportées à la configuration principale.
  3. Associez la règle de transport JMS personnalisée, JMSServiceClient1Policy, à votre application, ServiceClient1. DE même, associez la règle de transport JMS personnalisée, JMSServiceClient2Policy, à ServiceClient2.
    1. Cliquez sur Services > Clients de service > ServiceClient1.
    2. A partir de la collection d'associations d'ensemble de règles, sélectionnez le service, ServiceClient1.
    3. Cliquez sur Lier un ensemble de règles du client, puis sur JMSServiceClient1Policy.
    4. Cliquez sur Enregistrer pour sauvegarder les modifications de la configuration principale.
    5. Cliquez sur Services > Clients de service > ServiceClient2.
    6. A partir de la collection d'associations d'ensemble de règles, sélectionnez le service, ServiceClient1.
    7. Cliquez sur Lier un ensemble de règles du client, puis sur JMSServiceClient2Policy.
    8. Cliquez sur Enregistrer pour sauvegarder les modifications de la configuration principale.

Il en résulte que JMSServiceClient1Policy est désormais associé à l'application ServiceClient1 et que les sessions JMS utilisent une valeur de délai d'expiration de requête de 180 secondes. La règle JMSServiceClient2Policy est associée à l'application ServiceClient2 et les sessions JMS utilisent un délai d'expiration de requête de 300 secondes.

Que faire ensuite

Vous pouvez personnaliser les autres règles pouvant être nécessaires pour votre application.


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=twbs_wsspsptjms
Nom du fichier : twbs_wsspsptjms.html