wsdl - Web Services Description Language

WSDL (Web Services Description Language) est un langage xml pour décrire les Web-Services et comment y accéder.

Structure d'un wsdl

Un wsdl décrit un Web-Service avec ces principales bailises:

La structure principale d'un wsdl ressemble à cela (liste non exhaustive): <definitions> <types> definition des types........ </types> <message> definition des messages .... </message> <portType> definition des ports (opérations et messages)....... </portType> <binding> Les protocoles de communication utilisés par le web-service </binding> <service> Une adresse physique où accéder au service. </service> </definitions>

WSDL "portType"

L'élément < portType > est l'élément le plus important

Il décrit un web-service , les opérations qui peuvent être accomplies, et les messages échangés.

L'élément < portType > peut être comparé à une fonction d'une librairie dans un langage traditionnel.

Messages WSDL

L'élément < message > définit les données d'une opération.

Chaque message peut être formé d'une ou plusieurs partie. Les parties peuvent être comparés aux paramètres d'une fonction dans un langage de programmation traditionnel.

Operation Types

Les type de "Request-response" est l'opération la plus courrante. Mais wsdl définit d'autres types d'opération ("One-way", "Solicit-response","Notification")

Outil / editeur

Il est quasiment impossible d'écrire un wsdl à la main.(Sans erreurs!)

J'utilise l'éditeur wsdl d'eclipse (voir le projet STP, ils proposent un plugin avec l'ensemble de leurs outils), qui est gratuit et qui marche bien.

Cet outil permet à la fois d'éditer un fichier wsdl, mais aussi, de comprendre sa structure et de quoi il est composé: C'est une bonne idée d'éditer un wsdl existant, et de le regarder avec cet outil.

wsdl_1

Ressources

http://www.w3.org/TR/wsdl"