Activation de la prise en charge de l'adressage des services Web (WS-Addressing) pour les applications JAX-RPC
La prise ne charge de l'adressage des services Web (WS-Addressing) fournit des mécanismes permettant d'adresser des services Web et de fournir des informations d'adressage dans les messages. Pour activer la prise en charge de WS-Addressing pour des applications JAX-RPC, configurez le fichier WSDL (Web Services Description Language) pour un service qui s'exécute surWebSphere Application Server ou utilisez l'API ou l'interface SEI WS-Addressing pour ajouter des propriétés WS-Addressing à un client WebSphere Application Server.
Pourquoi et quand exécuter cette tâche
Effectuez cette tâche pour activer la prise en charge de WS-Addressing, soit en tant que fournisseur de services, soit en tant que client d'un service fourni par un tiers. Cette tâche explique également comment désactiver la prise en charge de WS-Addressing, ce qui peut améliorer les performances des applications qui n'utilisent pas WS-Addressing ni un protocole associé à la prise en charge de WS-Addressing.
Si vous créez un service Web, vous pouvez activer la prise en charge de WS-Addressing au cours du développement, en incluant l'élément d'extensibilité UsingAddressing à l'élément de liaison (binding) WSDL du service. Cet élément contient un attribut required dont la valeur est soit false (les informations WS-Addressing sont acceptée mais non obligatoires dans les messages entrants), soit or true (les informations WS-Addressing sont obligatoires dans les messages entrants). La valeur par défaut est false. Les messages provenant de clients WebSphere Application Server incluent toujours les informations WS-Addressing si votre fichier WSDL de service contient l'élément UsingAddressing, quelle que soit la valeur de l'attribut required.
Si vous créez une application client pour utiliser un service d'un autre fournisseur, il se peut que vous n'ayez pas accès au fichier WSDL du service ou que le service utilise une version de WSDL qui ne prend pas en charge l'élément UsingAddressing (si le service n'est pas exécuté sur une version actuelle du produit). Toutefois, vous pouvez activer la prise en charge de WS-Addressing lors de l'exécution en définissant les propriétés WS-Addressing sur l'objet Stub ou Call JAX-RPC que vous utilisez pour communiquer avec le service.
Dans le fichier WSDL du service, UsingAddressing required = "false" | Dans le fichier WSDL du service, | Le fichier WSDL du service ne définit pas UsingAddressing. | |
---|---|---|---|
Un client envoie un message contenant les informations WS-Addressing | Les informations WS-Addressing sont traitées par le produit. | Les informations WS-Addressing sont traitées par le produit. | Les informations WS-Addressing sont traitées par le produit. |
Un client autre que WebSphere Application Server envoie un message ne contenant pas d'information WS-Addressing | Le message est accepté. | Le service renvoie une erreur. | Le message est accepté. |
Un client WebSphere Application Server envoie un message, sans définir les propriétés d'adressage | Le message contient automatiquement les informations WS-Addressing obligatoires définies dans la spécification WS-Addressing. Les informations sont traitées par le produit. | Le message contient automatiquement les informations WS-Addressing obligatoires définies dans la spécification WS-Addressing. Les informations sont traitées par le produit. | Les informations WS-Addressing ne sont pas ajoutées. Le message est accepté. |
Procédure
Résultats
Les propriétés WS-Addressing sont maintenant incluses à l'en-tête du message SOAP et elles sont traitées par le serveur à la réception du message.