Création d'un service WS-Notification version 7.0

Créez un service WS-Notification et les objets associés qui composent l'infrastructure de la configuration WS-Notification. Utilisez ce type de service pour composer un service WS-Notification JAX-WS avec des qualités de service de services Web via des ensembles de règles ou pour appliquer des descripteurs JAX-WS à votre service WS-Notification. Ce type de service est recommandé pour les nouveaux déploiements. Cette option WS-Notification a été introduite dans WebSphere Application Server depuis Version 7.0.

Avant de commencer

Déterminez la méthode à utiliser pour configurer ces ressources.Vous pouvez créer un point de service WS-Notification version 7.0 à l'aide de la console d'administration, comme décrit dans cette tâche, ou à l'aide de la Commande createWSNService.

Cette tâche suppose que vous disposez d'un bus d'intégration de services configuré avec, au minimum, un membre de bus.

En général, vous configurez un seul service WS-Notification pour un bus d'intégration de services, mais il est possible d'en configurer plusieurs. Pour plus d'informations, voir Objectifs de la création de plusieurs services WS-Notification dans un bus.

La définition d'un service WS-Notification version 7.0 est une tâche différente de l'exposition d'un port NotificationBroker (WSDL) auquel des applications de services Web peuvent se connecter. Pour ce faire, créez un ou plusieurs points de service WS-Notification version 7.0 comme décrit dans cette tâche.

Pourquoi et quand exécuter cette tâche

Un service WS-Notification permet d'exposer certaines ou toutes les ressources de messagerie définies sur un bus d'intégration de services pouvant être utilisées par des applications WS-Notification.

Pour prendre en charge Java™ API for XML-based Web Services (JAX-WS) et la composition WS-ReliableMessaging, vous créez les services WS-Notification comme applications JAX-WS, puis utilisez cette tâche pour créer un service Version 7.0 WS-Notification, un ou plusieurs points de service et un espace de nom de rubrique (facultatif).

Vous pouvez également appliquer des listes de gestionnaires JAX-WS à des points de service WS-Notification (pour la gestion des appels entrants) et des services WS-Notification (pour la gestion des appels sortants).

Lorsque vous créez un service WS-Notification version 7.0, l'assistant crée et déploie une application de fournisseur basée sur JAX-WS. Cette application expose les interfaces de service Web WS-Notification pour chacun des trois rôles de service WS-Notification :
  • Courtier de notifications
  • Gestionnaire d'abonnements
  • Gestionnaire d'enregistrements du diffuseur de publications

Procédure

  1. Démarrez la console d'administration.
  2. Naviguez à Intégration des services -> WS-Notification -> Services ou Intégration des services -> Bus -> nom_bus -> [Services] Services WS-Notification. Le formulaire Services WS-Notification [Collection] s'affiche.
  3. Dans la sous-fenêtre de contenu, cliquez sur Nouveau. L'assistant "Nouveau service WS-Notification" s'affiche. Pour plus d'informations sur les propriétés définies à l'aide de l'assistant, voir Services WS-Notification [Paramètres].
  4. Etape 1 : Définir les paramètres de nom, de description, de bus d'intégration et d'espace de nom de sujet dynamique.
    1. Entrez un nom de votre choix et une description, si vous le souhaitez.

      Le nom fait partie du noeud final sur lequel le service est exposé (l'URL utilisée pour accéder aux points de service WS-Notification définis sous le service). Pour la version 6.1 des services WS-Notification, le nom du service est unique dans un bus. Pour la version 7.0 des services WS-Notification, le nom du service est unique dans la cellule ; ce qui correspond au modèle d'administration utilisé pour les ensembles de règles et de ce fait prend en charge la composition de services WS-Notification version 7.0 avec WS-ReliableMessaging.

    2. Sélectionnez ou désélectionnez l'option Activer les espaces de nom de sujet ?.

      Il s'agit de savoir si ce service permet la création d'espaces de nom de sujet dynamiques lors de l'exécution. Pour plus d'informations, voir Espace de nom de sujet dynamique.

      Cette option permet de bien vérifier les espaces de noms de sujet qui sont utilisés lors de la connexion à un service WS-Notification particulier (par exemple à des fins d'audit ou de sécurité). Si vous décochez cette option, toute application se connectant au service WS-Notification et sollicitant des sujets à un espace de nom de sujet dynamique ne peut plus émettre de publication et reçoit des messages.

      Tous les messages publiés pour un espace de nom de sujet dynamique sont insérés avec le paramètre de fiabilité du message par défaut persistant fiable. Si cette valeur n'est pas acceptable, créez un espace de nom de sujet permanent puis configurez manuellement l'attribut avec la valeur appropriée.

      Remarque : Les espaces de nom de sujet dynamiques utilisés sur un service WS-Notification particulier sont accompagnés d'un espace de sujet du bus d'intégration de services qui est créé automatiquement au moment de la création de l'espace de nom de sujet. La syntaxe des sujets utilisés dans cet espace de sujet est interne à l'implémentation du service WS-Notification.
    3. Sélectionnez ou désélectionnez l'option Enregistrement requis.

    4. Sélectionnez un bus d'intégration de services dans la liste déroulante.
    5. Cliquez sur Suivant.
  5. Etape 2 : Sélectionner le type de service WS-Notification.

    Sélectionnez Version 7.0 comme type de service à créer.

  6. Etape 3 : Définir les paramètres de règle du gestionnaire et du service Web.

    Ces paramètres sont appliqués aux notifications d'événements échangées avec les applications client WS-Notification.

    1. Facultatif : Choisissez une liste de gestionnaires JAX-WS.

      Une liste de gestionnaires détermine les gestionnaires appliqués lors de appels de service Web sortants, par exemple, surveillance de la notification d'un événement sortant (en réponse à une opération d'abonnement) et le contrôle des publieurs basés sur la demande (abonnement, pause et reprise). Pour plus d'informations sur les listes de gestionnaires, voir Configuration de gestionnaires JAX-WS.

    2. Sélectionnez ou désélectionnez l'option WSDL de requête.
      Indique si le service WS-Notification version 7.0 interroge le document WSDL d'autres services Web WS-Notification lors que l'interaction avec eux. Par défaut, cette option est activée. Si vous désélectionnez cette option, vous pouvez améliorer les performances en évitant des requêtes WSDL coûteuses en termes de ressources. Cependant, tenez compte des remarques suivantes lorsque les requêtes WSDL ne sont pas activées :
      • Tentatives WS-Notification de découverte des informations de liaison (découvertes généralement via WSDL) en utilisant d'autres méthodes. WS-Notification utilise la version SOAP associée au point de service WS-Notification sur lequel les abonnements ont été réalisés (par d'autres services Web) ou sur lequel des abonnements gérés ont été créés (par un administrateur).
      • Dans certains cas, WS-Notification peut être incapable d'identifier les informations de liaison. Ceci peut se produire lors du nettoyage des abonnements alors que le point de service associé a été supprimé et que les informations de configuration ne sont plus disponibles. Dans ce cas, WS-Notification émet une "hypothèse" sur les informations de liaison à utiliser pour nettoyer les abonnements.
      • Il existe un scénario dans lequel des informations de liaison incorrectes sont utilisées, à savoir, lorsque l'abonné s'abonne pour utiliser une liaison SOAP, pour le compte d'un consommateur de notifications qui attend les notifications via une liaison SOAP différente.
    3. Entrez un nom d'espace de sujet dynamique.

      Il s'agit du nom de l'espace de sujet du bus utilisé pour héberger l'espace de nom de sujet ad hoc et les espaces de nom de sujet dynamique s'ils sont autorisés. Le nom par défaut, WSN_dynamic_nom_service est proposé.

    4. Cliquez sur Suivant.
  7. Etape 4 : Créer des points de service WS-Notification.

    L'existence d'un point de service WS-Notification sur un membre de bus implique qu'un service Web WS-Notification est exposé à partir de ce membre de bus et entraîne l'exposition des noeuds finaux des services Web du courtier de notification, du gestionnaire des abonnements et du gestionnaire de l'enregistrement des diffuseurs de publications du service WS-Notification, sur le membre de bus auquel le point de service est associé. Les applications WS-Notification utilisent ces points finaux pour communiquer avec le service WS-Notification. Pour plus d'informations, voir Point de service WS-Notification.

    1. Sélectionnez Oui pour créer un point de service WS-Notification, puis cliquez sur Suivant.

      Un service WS-Notification doit avoir au moins un point de service.

    2. Indiquez un nom et une description (facultatif) pour le point de service WS-Notification, puis dans la liste déroulante, sélectionnez le membre de bus sur lequel le point de service doit être configuré. Cliquez ensuite sur Suivant.

      Le nom du point de service fait partie de l'URL utilisée pour accéder au point de service. Sur un système de serveur unique, un seul membre de bus est disponible dans la liste.

    3. Sélectionner les paramètres de transport du nouveau point de service.
      Point de service via le proxy HTTP
      Si le point de service est accessible via un proxy, cochez la case et indiquez la racine de l'adresse URL du noeud final visible en externe des services Web accessibles à l'aide de ce noeud final.
      L'URL du proxy est utilisée pour remplir les zones d'adresse de noeud final WSDL lors de la publication des fichiers WSDL dans un fichier compressé.
      Version SOAP
      Sélectionnez la version de SOAP prise en charge par le point de service. Cela affecte la définition WSDL exposée par le service Web.
    4. Facultatif : Sélectionnez les paramètres de la liste de gestionnaires JAX-WS pour le nouveau point de service.
      Liste des gestionnaires NotificationBroker JAX-WS

      Liste des gestionnaires SubscriptionManager JAX-WS

      Liste des gestionnaires PublisherRegistrationManager JAX-WS

    5. Cliquez sur Suivant. Le nouveau point de service est ajouté à la liste de points de service pour ce service WS-Notification.
    6. Facultatif : Pour créer un autre point de service, répétez les sous-étapes précédentes.
    7. Lorsque vous avez terminé de créer des points de service pour le service WS-Notification, sélectionnez Non pour ne pas créer un autre point de service, puis cliquez sur Suivant.
  8. Facultatif : Etape 5 : Créer des espaces de nom de sujet persistants.

    Pour plus d'informations, voirEspace de nom de sujet permanent. Lorsque vous créez un espace de nom de sujet permanent WS-Notification, vous indiquez l'espace de nom et vous l'associez à l'un des espaces de sujet du bus d'intégration de services configurés dans le bus où le service WS-Notification parent est défini. Vous ne pouvez pas modifier un espace de nom de sujet permanent après sa création : il est uniquement possible d'appliquer ou de supprimer des documents d'espace de nom de sujet.

    1. Sélectionnez Oui pour créer un espace de nom de sujet permanent, puis cliquez sur Suivant.
    2. Entrez un nom pour l'espace de nom de sujet permanent.

      Il s'agit de l'URI par lequel les applications WS-Notification font référence aux sujets hébergés par cet espace de nom.

    3. Associez ce nouvel espace de nom de sujet permanent à l'espace de sujet du bus d'intégration de services que vous souhaitez utiliser pour publier et recevoir des messages.
      Dans la liste déroulante de l'espace de sujet du bus d'intégration de services, exécutez l'une des opérations suivantes :
      • Sélectionnez le nom d'un espace de sujet existant du bus.
      • Sélectionnez l'option Créer un espace de sujet, puis entrez un nom pour le nouvel espace de sujet.
    4. Sélectionnez dans la liste déroulante la fiabilité du bus d'intégration de services (qualité de service) attribuée aux messages qui sont publiés à l'aide de cet espace de nom de sujet.

      Vous pouvez choisir parmi cinq valeurs, chacune représentant un des niveaux de fiabilité des messages du bus d'intégration de services. La valeur par défaut est fiable persistant, qui est utilisée par défaut pour les messages persistants JMS.

    5. Cliquez sur Suivant.

      Le nouvel espace de nom de sujet permanent est ajouté à la liste d'espaces de nom de sujet permanents pour ce service WS-Notification version 7.0, et vous devez indiquer si vous voulez créer un autre espace de nom (par défaut, Oui).

    6. Facultatif : Pour créer un autre espace de nom de sujet permanent, répétez les sous-étapes précédentes.
    7. Une fois créés les espaces de nom de sujet permanent pour ce service WS-Notification version 7.0, sélectionnez Non pour l'option de création d'un autre espace de nom et cliquez sur Suivant.
  9. Etape 6 : Récapitulatif.

    Vérifiez que le récapitulatif des actions effectuées par l'assistant correspond à ce que vous attendiez, puis cliquez sur Terminer.

    Si le traitement aboutit, la liste des services WS-Notification version 7.0 est mise à jour pour inclure le nouveau service WS-Notification version 7.0. Sinon, un message d'erreur s'affiche.
  10. Sauvegardez les modifications de la configuration principale.
  11. Facultatif : Redémarrez le serveur en présence de l'une des conditions suivantes :
    • Un nouveau bus ou un nouveau membre de bus ont été créés lors de cette tâche.
    • Le rechargement de la configuration n'est pas activé pour le bus.

Que faire ensuite

Pour effectuer des tâches de configuration avancées pour ce service WS-Notification (par exemple, pour ajouter des points de service supplémentaires et appliquer des documents d'espace de nom de sujet aux espaces de nom de sujet permanents), voir Modification d'un service WS-Notification version 7.0.

Pour effectuer des tâches de configuration avancée pour le point de service WS-Notification que vous avez créé dans le cadre de cette tâche (par exemple, pour ajouter des abonnés administrés, publier des fichiers WSDL dans un fichier compressé et configurer l'application d'entreprise associée à ce point de service), voir Modification d'un point de service WS-Notification version 7.0.

Pour configurer ce point de service ou ce service WS-Notification avec les qualités des services Web, telles que la fiabilité ou la sécurité, voir Configuration d'un service WS-Notification version 7.0 avec les qualités de service des services Web.


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