Données
Qu’est-ce que WSDL ?
WSDL (Web Services Description Language) est un format XML qui décrit l’interface d’un service web et son mode d’accès. Il relie opérations et messages abstraits aux liaisons de protocole et de format de message, aux points d’accès et aux informations du service. Un fichier WSDL n’est ni l’implémentation du service ni les données échangées.
Quand choisir ce format
- Examiner une intégration existante fondée sur WSDL
- Générer du code client depuis une description avec des outils compatibles
Quand éviter ce format
- Remplacer les données réelles de requête ou de réponse, ou l’implémentation du service
- Utiliser un autre outil sans vérifier la version WSDL et les extensions de liaison
Usages courants
- Décrire les opérations, messages et points d’accès d’un service web
- Partager le contrat de service et les détails de protocoles comme SOAP
Caractéristiques
- Décrit les opérations et la structure des messages
- Sépare l’interface des liaisons de protocole et de format de message
- Indique les adresses d’accès via les points d’accès et les services
Avantages et inconvénients
Avantages
- Permet aux clients et fournisseurs de partager le contrat et les modalités d’accès
- Des outils compatibles peuvent générer du code client ou des informations de validation
Inconvénients
- Il faut comprendre les espaces de noms XML et les ressources importées
- WSDL 1.1 et 2.0 ont des structures et noms d’éléments différents
- Les liaisons et extensions ne sont pas toujours compatibles entre outils
Ouvrir et convertir
Comment ouvrir
Ouvrez-le dans un éditeur ou un IDE compatible XML. Pour le comprendre, suivez les WSDL et XSD importés, le target namespace, interface ou portType, les liaisons et les points d’accès du service.
Comment convertir
Pour passer entre WSDL 1.1, WSDL 2.0 ou OpenAPI, faites correspondre opérations, messages d’entrée et de sortie, faults, liaisons SOAP/HTTP, espaces de noms et points d’accès. Testez des requêtes et réponses représentatives avec les outils client au lieu de vous fier uniquement à la sortie générée.
Précautions
- WSDL décrit un service, mais ne garantit ni la disponibilité actuelle ni la sécurité d’un point d’accès indiqué.
- Des schémas importés ou extensions de liaison manquants peuvent empêcher l’analyse ou la génération de code.
- WSDL 1.1 est une note du W3C, tandis que WSDL 2.0 est une recommandation du W3C. Vérifiez la version attendue par le système cible.
Questions fréquentes
WSDL est-il une donnée XML ?
Un WSDL est un document XML, mais il décrit une interface et son accès ; il ne transporte pas les requêtes et réponses réelles.
Que peut-on générer depuis WSDL ?
Des outils compatibles peuvent générer du code client ou des informations de validation à partir de ses définitions. La prise en charge varie selon l’outil.