Activation de la prise en charge de Web Services Addressing pour les applications JAX-WS à l'aide des fonctions d'adressage

Pour les applications JAX-WS, vous pouvez activer la prise en charge de WS-Addressing lors du développement d'une application client, en utilisant des fonctions d'adressage dans le code.

Pourquoi et quand exécuter cette tâche

Utilisez l'une des classes de fonction d'adressage suivantes dans votre code de service :
  • AddressingFeature : utilisez cette classe si vous voulez envoyer des messages qui incluent des en-têtes WS-Addressing conformes à la spécification de WS-Addressing 2005/08.
  • SubmissionAddressingFeature : utilisez cette classe si vous voulez envoyer des messages qui incluent des en-têtes WS-Addressing conformes à la spécification de WS-Addressing 2004/08.
Si vous utilisez les deux classes de caractéristiques, la spécification utilisée dépend du type de référence du point d'entrée que vous spécifiez également. Par exemple, si vous spécifiez un objet W3CEndpointReference, la spécification utilisée est la spécification 2005/08. Si vous spécifiez une référence de point d'entrée dont le type est en conflit avec celui indiqué par la classe de caractéristiques, par exemple un objet W3CEndpointReference avec une instance SubmissionAddressingFeature, une erreur est générée. Si vous ne spécifiez pas de référence de point d'entrée, la spécification par défaut est la spécification 2005/08.
Spécifiez jusqu'à trois paramètres facultatifs pour chaque instance de fonction d'adressage :
Tableau 1. Paramètres des fonctions d'adressage. Le tableau répertorie les différents paramètres de fonction d'adressage avec leurs valeurs possibles et une description de chacun d'entre eux.
Nom de paramètre Valeurs possibles Description
enabled

true (valeur par défaut)
false

Indique si la prise en charge de WS-Addressing est activée.
required

true
false (valeur par défaut)

Indique si les en-têtes WS-Addressing sont requis.
responses

Responses.All (default)
Responses.ANONYMOUS
Responses.NON_ANONYMOUS

Indique si un modèle d'échange de messages synchrone ou asynchrone doit être utilisé. Spécifiez Responses.ANONYMOUS pour envoyer les messages dans un modèle d'échange de messages synchrone ; utilisez Responses.NON_ANONYMOUS pour envoyer les messages dans un modèle d'échange de messages asynchrone.
Remarque : Ce paramètre n'est pas pris en charge pour la classe SubmissionAddressingFeature.
Remarque : Vous pouvez utiliser les classes de caractéristiques d'adressage uniquement avec une liaison SOAP (1.1 ou 1.2) sur HTTP. Si vous utilisez la classe avec une autre liaison, comme XML sur HTTP, une exception est générée sur les clients et sur les serveurs que le service Web ne parvient pas à déployer.

Procédure

Créez une instance de l'une des classes de fonction d'adressage, avec les paramètres requis. Par exemple, pour spécifier que WS-Addressing est activé et requis et que la spécification 2005/08 et le masque d'échange de message asynchrone sont utilisés, utilisez le code suivant :
AddressingFeature feat = new AddressingFeature(true, true, AddressingFeature.Responses.NON_ANONYMOUS);
Pour spécifier que WS-Addressing est désactivé pour la spécification 2004/08, utilisez le code suivant :
SubmissionAddressingFeature feat = new SubmissionAddressingFeature(false);

Résultats

Si vous spécifiez que WS-Addressing est activé, le client inclut des en-têtes WS-Addressing dans les messages SOAP. Les en-têtes sont conformes à la spécification WS-Addressing indiquée par le type de classe de caractéristiques utilisé. Si le serveur n'utilise pas d'annotation, ou utilise des ensembles de règles pour activer WS-Addressing, le serveur accepte les deux spécifications 2005/08 et 2004/08.

Si vous spécifiez que WS-Addressing est requis et que le client reçoit un message qui n'inclut pas d'en-têtes WS-Addressing, le client renvoie une erreur.

Si vous indiquez l'attribut de réponses, le masque d'échange de message correspondant est utilisé.


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_wsa_dep_jaxws_feat
Nom du fichier : twbs_wsa_dep_jaxws_feat.html