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
- Démarrez la console d'administration.
- Naviguez à
ou
. Le formulaire Services WS-Notification [Collection] s'affiche.
- 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].
- Etape 1 :
Définir les paramètres de nom, de description, de bus d'intégration et d'espace de nom de sujet dynamique.
- 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.
- 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.
- Sélectionnez ou désélectionnez l'option
Enregistrement requis.
- Sélectionnez un bus d'intégration de services dans la liste déroulante.
- Cliquez sur Suivant.
- Etape 2 :
Sélectionner le type de service WS-Notification.
Sélectionnez Version 7.0 comme type de service à
créer.
- 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.
- 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.
- 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.
- 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é.
- Cliquez sur Suivant.
- 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.
- 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.
- 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.
- 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.
- 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
-
- Cliquez sur Suivant. Le nouveau point de service
est ajouté à la liste de points de service pour ce service WS-Notification.
- Facultatif : Pour créer un autre point de service, répétez les sous-étapes
précédentes.
- 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.
- 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.
- Sélectionnez Oui pour créer un espace de nom
de sujet permanent, puis cliquez sur Suivant.
- 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.
- 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.
- 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.
- 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).
- Facultatif : Pour créer un autre espace de nom de sujet permanent, répétez les sous-étapes précédentes.
- 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.
- 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.
- Sauvegardez les modifications de la configuration principale.
- 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.