Formats de messages SOAP standard spécifiés à l'aide de WSDL

Cette rubrique est spécifique à une technologie existante. Les services Web XML et les clients du service Web XML doivent à présent être créés à l'aide de Windows Communication Foundation.

Le Web Services Description Language (WSDL), langage standard de l'industrie qui définit un schéma pour les documents XML qui définissent à leur tour des services Web, offre deux options de mise en forme SOAP principales. Ces deux options sont spécifiées dans les éléments XML, non pas dans l'espace de noms WSDL principal https://schemas.xmlsoap.org/wsdl/, mais dans l'espace de noms https://schemas.xmlsoap.org/wsdl/soap/. Cet espace de noms secondaire associe un service Web au protocole SOAP.

Options de mise en forme SOAP

Les deux options de mise en forme sont :

  • Style : pour l'élément enfant, et éventuellement les petits-enfants, de l'élément Body dans un message SOAP. Ceci est spécifié comme attribut style d'un élément WSDL binding (généralement) ou d'un élément operation.

  • Use : pour les paramètres de méthode de service Web ou une valeur de retour qui apparaissent au niveau inférieur. Ceci est spécifié comme attribut use d'un élément body.

Pour plus d'informations sur la spécification SOAP, consultez le site Web W3C (http://www.w3.org/TR/SOAP). Le site Web W3C () fournit également des détails sur la spécification WSDL.

Valeurs autorisées de l'attribut Style

WSDL prévoit deux valeurs pour l'attribut style qui contrôle la mise en forme générale du corps SOAP :

  • RPC : des paramètres ou une valeur de retour sont placés automatiquement dans un élément parent dont le propre parent est l'élément SOAP Body. Les paramètres ou la valeur de retour apparaissent sans qualification d'espace de noms. Ce schéma est décrit dans la section 7 de la spécification SOAP 1.1. style="rpc" spécifié.

    Pour une demande SOAP, l'élément sous le Body SOAP est nommé d'après un élément operation WSDL, qui correspond à la méthode de service Web. Chaque élément dans cet élément représente un paramètre et est nommé d'après ce paramètre.

    Pour une réponse SOAP, le nom de l'élément sous le Body SOAP est le nom d'opération auquel est ajouté Response. Le nom de l'élément en-dessous, qui représente la valeur de retour, est le nom d'opération mais avec le suffixe Return.

  • Document : le contenu de l'élément SOAP Body est entièrement spécifié dans le WSDL comme éléments XML définis dans une définition de schéma XML. Le schéma XML est spécifié ou importé dans le document WSDL. Le WSDL oublie les paramètres et les valeurs de retour ; il ne gère que les documents XML. Le développeur, ou de préférence l'infrastructure de services Web, s'occupe de la façon dont les paramètres et valeurs de retour se traduisent en éléments et types de schémas XML. style="document" spécifié.

    Les éléments XML de niveau supérieur sont spécifiés comme éléments de parties de message --partie qui sont définis dans un élément message et pointent vers les déclarations d'élément XSD. Normalement, il n'y a pas plus d'une partie, de sorte que le contenu du Body SOAP soit vraiment un document XML, bien que WSDL n'interdise pas en soi plusieurs éléments.

WSDL prévoit deux valeurs pour l'attribut use qui contrôle la mise en forme des paramètres et de la valeur de retour :

  • Encoded : les données sont mises en forme d'après un schéma décrit dans la Section 5 de la spécification SOAP 1.1. Le codage SOAP utilise un sous-ensemble du schéma XML pour lier les documents XML et les données qu'ils représentent. Le codage SOAP emploie également des références pour les éléments qui apparaissent plusieurs fois dans un document. use="encoded" spécifié.

  • Literal : les données sont mises en forme littéralement d'après les définitions de schéma XML spécifiées ou importées dans le document WSDL. use="literal" spécifié.

Voir aussi

Autres ressources

Personnalisation de la mise en forme de messages SOAP