Application du respect des liaisons WSDL dans les services Web JAX-WS
JAX-WS (Java™ API for XML-Based Web Services) version 2.1 a introduit le concept de fonctions comme un moyen de piloter par programme des fonctions et comportements spécifiques. RespectBindingFeature est l'une des fonctions standard prises en charge. La fonction RespectBindingFeature peut être utilisée pour contrôler si une implémentation JAX-WS est requise pour respecter le contenu d'une liaison WSDL (Web Services Description Language) associée à un noeud final.
Pourquoi et quand exécuter cette tâche
Tandis que les documents WSDL sont couramment utilisés au cours du processus de développement, l'obligation effective de respecter les spécifications des document WSDL dans l'environnement d'exécution n'avait pas été clairement définie dans les versions des spécifications JAX-WS antérieures à la version 2.1. La spécification JAX-WS version 2.1 a ajouté la fonction RespectBindingFeature pour clarifier l'impact de l'élément wsdl:binding dans un environnement d'exécution JAX-WS.
L'activation de la fonction RespectBindingFeature oblige l'environnement d'exécution JAX-WS à vérifier que wsdl:binding contient un noeud final, pour garantir que la liaison des paramètres de l'interface SEI et des valeurs renvoyées est respectée au moment de l'exécution. Par ailleurs, cette fonction vérifie que toutes les extensions requises de wsdl:binding sont comprises et utilisées par l'environnement d'exécution, ou qu'elles ont été désactivées de façon explicite par l'application. L'application JAX-WS peut désactiver une extension spécifique de wsdl:binding disposant d'une interface WebServiceFeature définie, en utilisant l'annotation associée à cette fonction, à l'aide d'une API acceptant l'interface javax.xml.ws.WebServiceFeature, ou en configurant les descripteurs de déploiement.
Lorsque la fonction RespectBindingFeature n'est pas activée, ce qui est le cas par défaut, l'environnement d'exécution choisit la partie de l'élément wsdl:binding à appliquer.
Procédure
Résultats
En implémentant la fonction RespectBindingFeature, vous avez obligé votre application JAX-WS à respecter le contenu d'une liaison WSDL associée à un noeud final.