Prise en charge WS-Addressing (Adressage des services Web)

La prise en charge WS-Adressing dans ce produit fournit l'environnement pour les services Web qui utilisent les spécifications W3C (World Web Consortium) WS-Addressing. Cette famille de spécifications fournit des mécanismes indépendants du transport destinés à traiter les services Web et à faciliter un adressage de bout en bout.

Il n'est pas nécessaire de connaître le fonctionnement de la prise en charge WS-Addressing sous-jacente car WebSphere Application Server s'assure le cas échéant, que vos applications de services web sont compatibles avec WS-Addressing. Lisez cette rubrique uniquement si vous devez utiliser directement la prise en charge WS-Addressing. Par exemple, dans les cas suivants :
  • Un développeur de service Web qui doit utiliser les API WS-Addressing pour créer des références de noeud final dans une application, puis les utiliser pour cibler des instances de ressource de service Web.
  • Un programmeur système qui doit utiliser les interfaces de programmation système (SPI) WS-Addressing propriétaires IBM pour effectuer des opérations WS-Addressing plus avancées, telles que la spécification de propriétés d'adressage de messages sur des messages de service Web.
  • Un administrateur qui configure des ensembles de règles pour des applications JAX-WS.

La prise en charge WS-Addressing pour les développeurs est constituée de deux ensembles de règles d'interfaces de programmation : les interfaces standard JAX-WS et la mise en oeuvre propriété d'IBM de la spécification WS-Addressing.

Caractéristiques de la prise en charge WS-Addressing JAX-WS

Ce produit fournit la prise en charge pour les API WS-Addressing JAX-WS que vous pouvez utiliser pour effectuer des fonctions d'adressage de base, comme la création d'une référence de noeud final, l'activation de la prise en charge WS-Addressing et la spécification des URI d'action associées aux opérations WSDL du service Web. Utilisez ces API si vous voulez effectuer des opérations WS-Addressing simples et créer des applications JAX-WS portables.

Les API WS-Addressing JAX-WS offre les fonctions suivantes pour le développement d'applications WS-Addressing centrales :
  • Représentations Java™ des références de noeud final WS-Addressing.
    • Vous pouvez créer des instances de référence de noeud final Java pour le noeud final d'application ou d'autres noeuds finaux dans la même application pendant l'exécution. Il n'est pas nécessaire de spécifier l'URI de la référence de noeud final.
    • Vous pouvez créer des instances de référence de noeud final Java pour les noeuds finaux dans d'autres applications en spécifiant l'URI de la référence du noeud final.
    • Sur les services, vous pouvez utiliser des annotations pour spécifier si le support WS-Addressing est activé, s'il est requis et schéma d'échange de messages utiliser (synchrone, asynchrone ou les deux).
    • Sur les clients, vous pouvez utiliser des fonctions pour spécifier si la prise en charge WS-Addressing est activée et si elle est requise.
    • Vous pouvez configurer des objets proxy ou Dispatch à l'aide des références de noeud final.
  • Prise en charge Java pour les références de noeud final qui représentent les instances de la ressource de services Web (WS-Resource).
    • Vous pouvez associer des paramètres de référence à une référence de point de contact lors de sa création, afin de la mettre en corrélation avec une instance de ressource particulière.
    • Dans les services Web ciblés, vous pouvez extraire les paramètres de référence d'un message entrant, de façon à ce que le service Web puisse réacheminer le message vers l'instance WS-Resource adéquate.
Les fonctions suivantes ont été introduites dans la spécification JAX-WS 2.2, prise en charge par WebSphere Application Server depuis la version 8 :
  • Vous pouvez indiquer des informations de liaisons supplémentaires dans les métadonnées d'une référence de noeud final, comme partie intégrante de la spécification JAX-WS 2.2. Cette fonctionnalité a été ajoutée à WebSphere Application Server Version 7. Toutefois, comme elle ne faisait pas partie de la spécification JAX-WS 2.1, il est possible que vous rencontriez des problèmes d'incompatibilité lorsque vous utilisez des serveurs non WebSphere Application Server ne prenant pas en charge les métadonnées supplémentaires dans des références de noeud final. JAX-WS 2.2 prend en charge les métadonnées WSDL dans les références de noeud final, ainsi les applications seront compatibles avec d'autres implémentations de cette spécification. Pour plus d'informations, voir la rubrique "Présentation de l'adressage des services Web (WS-Addressing)".
  • Vous pouvez activer et configurer WS-Addressing sur un client ou un service en ajoutant des assertions WS-Policy dans le document WSDL. WebSphere Application Server traite ensuite les informations relatives à WS-Addressing contenues dans l'aspect WS-Policy d'un document WSDL et les utilise dans la configuration de cette application. Pour plus d'informations, voir la rubrique "Activation de la prise en charge de Web Services Addressing pour les applications JAX-WS à l'aide de WS-Policy".
  • Vous pouvez préciser si un modèle d'échange de messages synchrone ou asynchrone est exigé par une application de service Web à l'aide de l'annotation d'adressage ou de AddressingFeature. Utilisez le paramètre responses sur les annotations d'adressage ou la classe AddressingFeature dans le code. Pour plus d'informations, voir les rubriques "Activation de la prise en charge de Web Services Addressing pour les applications JAX-WS à l'aide d'annotations d'adressage" et "Activation de la prise en charge de Web Services Addressing pour les applications JAX-WS à l'aide des fonctions d'adressage".
  • Vous pouvez configurer WS-Addressing à l'aide de descripteurs de déploiement. Ajoutez un élément <addressing> et des éléments enfant supplémentaires au fichier descripteur de déploiement pour l'application. Pour plus d'informations, voir la rubrique "Activation de la prise en charge de Web Services Addressing pour les applications JAX-WS à l'aide de descripteurs de déploiement".
  • Vous pouvez générer du code à partir d'un document WSDL et WebSphere Application Server insère automatiquement les annotations @Action et @FaultAction dans le code Java généré. Pour plus d'informations, voir la rubrique "Annotations de l'adressage des services Web".

Fonctions de la prise en charge de WS-Addressing propriété d'IBM

Ce produit fournit une mise en oeuvre propriété d'IBM de la spécification WS-Addressing que vous pouvez utiliser avec des applications JAX-RPC, ainsi que des applications JAX-WS, pour effectuer des fonctions plus avancées comme la création de références de noeud final qui représentent des objets hautement disponibles ou la définition directe des propriétés d'adressage de message dans l'en-tête SOAP. Utilisez ces interfaces API et SPI si vous voulez créer des applications JAX-RPC qui utilisent l'adressage ou si vous voulez effectuer des opérations plus avancées qui ne sont pas possibles avec les API JAX-WS.

L'API propriété d'IBM fournit les fonctions de base suivantes :
  • Vous pouvez facilement créer des instances de référence de noeud final Java pour représenter un noeud final dans le serveur en fonction de l'environnement de déploiement de l'application. Il n'est pas nécessaire de spécifier l'URI de la référence de noeud final. De plus, les références de noeud final peuvent représenter des objets hautement disponibles ou à charge de travail pondérée.
  • Vous pouvez configurer les objets de contexte de demande JAX-WS BindingProvider client ou les objets Stub ou Call JAX-RPC, à l'aide d'une référence de noeud final WS-Addressing. Les futurs appels sur ces objets sont destinés au noeud final représenté par la référence de noeud final. En outre, les appels se conforment automatiquement à la spécification WS-Addressing (espace de nom) associée à cette référence de point de contact.
Les interfaces SPI WS-Addressing propriétaires IBM fournissent le support de développement d'un système WS-Addressing étendu à l'aide des fonctionnalités suivantes :
  • Raisonnement et manipulation des références de point de contact au delà de la disponibilité au niveau de programmation d'application.
    • Vous pouvez manipuler le contenu de la référence de point de contact, comme indiqué par la spécification WS-Addressing.
    • Vous pouvez associer un espace de nom WS-Addressing, et par conséquent un comportement de spécification, à une référence de point de contact.
  • Représentations Java des propriétés d'adressage de messages WS-Addressing.
    • Vous pouvez spécifier des propriétés d'adressage de messages WS-Addressing pour les messages de service Web sortants. Dans le service Web ciblé, vous pouvez extraire les propriétés d'adressage de message des messages de service Web entrants.
    • Vous pouvez spécifier l'espace de nom WS-Addressing d'un message WS-Addressing sortant, même si l'espace de nom est dérivé automatiquement dans la plupart des cas, en fonction de la référence de point de contact cible. Dans un service Web ciblé, vous pouvez acquérir l'espace de nom WS-Addressing d'un message entrant.

Prise en charge de l'interopérabilité et des spécifications WS-Addressing

Par défaut, ce produit prend en charge les spécifications de liaison W3C WS-Addressing 1.0 centrales et SOAP, identifiées par l'espace de nom http://www.w3.org/2005/08/addressing. Sauf indication contraire, la sémantique WS-Addressing décrite dans cette documentation se rapporte à ces spécifications.

Pour l'interopérabilité, les autres niveaux de la spécification WS-Addressing sont pris en charge dans cette version du produit, et plus particulièrement la soumission W3C WS-Addressing à l'espace de nom http://schemas.xmlsoap.org/ws/2004/08/addressing.

Pour les applications JAX-WS, ce produit prend en charge la spécification des métadonnées WS-Addressing identifiée par l'espace de nom http://www.w3.org/2007/05/addressing/metadata. Cette spécification remplace la spécification de liaison WSDL (Web Services Description Language) WS-Addressing identifiée par l'espace de nom http://www.w3.org/2006/05/addressing/wsdl.

En outre, ce produit prend en charge les fonctions suivantes à partir de la spécification de liaison WSDL WS-Addressing :
  • L'élément d'extensibilité wsaw:UsingAddressing sur l'élément de liaison WSDL uniquement. Les espaces de nom pris en charge pour cet élément sont les espaces de nom http://www.w3.org/2006/05/addressing/wsdl et http://www.w3.org/2006/02/addressing/wsdl (obsolète).
  • L'élément d'extensibilité wsaw:Action. Les espaces de nom pris en charge pour cet élément sont les espaces de nom http://www.w3.org/2006/05/addressing/wsdl, http://www.w3.org/2006/02/addressing/wsdl (obsolète) et http://schemas.xmlsoap.org/ws/2004/08/addressing.

Icône indiquant le type de rubrique Rubrique de concept



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