Partager via

Référence pour ServiceDescription et WSDL

  • Article

Cette rubrique décrit comment Windows Communication Foundation (WCF) mappe des documents WSDL (Web Services Description Language) à des instances ServiceDescription et inversement.

Comment ServiceDescription mappe à WSDL 1.1

Vous pouvez utiliser WCF pour exporter des documents WSDL à partir d’une instance ServiceDescription pour votre service. Des documents WSDL sont automatiquement générés pour votre service lorsque vous publiez des points de terminaison de métadonnées.

Vous pouvez également importer des instances ServiceEndpoint, des instances ContractDescription et des instances Binding à partir de documents WSDL en utilisant le type WsdlImporter.

Les documents WSDL, exportés par WCF, importent toute définition de schéma XML utilisée à partir de documents de schéma XML externes. Un document de schéma XML distinct est exporté pour chaque espace de noms cible utilisé par les types de données dans le service. De même, un document WSDL distinct est exporté pour chaque espace de noms cible utilisé par les contrats de service.

ServiceDescription

Une instance ServiceDescription correspond à un élément wsdl:service. Une instance ServiceDescription contient une collection d’instances ServiceEndpoint qui correspondent chacune à des éléments wsdl:port individuels.

Propriétés Mappage WSDL
Name Valeur wsdl:service/@name du service.
Namespace TargetNamespace de la définition wsdl:service du service.
Endpoints Définitions wsdl:port du service.

ServiceEndpoint

Une instance ServiceEndpoint correspond à un élément wsdl:port. Une instance ServiceEndpoint contient une adresse, une liaison et un contrat.

Les comportements de point de terminaison qui implémentent l'interface IWsdlExportExtension peuvent modifier l'élément wsdl:port du point de terminaison auquel ils sont attachés.

Propriétés Mappage WSDL
Name Valeur wsdl:port/@name du point de terminaison et valeur wsdl:binding/@name de la liaison de point de terminaison.
Address Adresse de la définition wsdl:port du point de terminaison.

Le transport du point de terminaison détermine le format de l'adresse. Par exemple, pour les transports pris en charge par WCF, il peut s’agir d’une adresse SOAP ou d’une référence à un point de terminaison.
Binding Définition wsdl:binding du point de terminaison.

Contrairement aux définitions wsdl:binding, les liaisons dans WCF ne sont pas liées à un contrat quel qu’il soit.
Contract Définition wsdl:portType du point de terminaison.
Behaviors Les comportements de point de terminaison qui implémentent l'interface IWsdlExportExtension peuvent modifier l'élément wsdl:port du point de terminaison.

Liaisons

L'instance de liaison d'une instance ServiceEndpoint correspond à une définition wsdl:binding. Contrairement aux définitions wsdl:binding, qui doivent être associées à une définition wsdl:portType spécifique, les liaisons WCF sont indépendantes de tout contrat.

Une liaison est composée d’une collection d’éléments de liaison. Chaque élément décrit un aspect de la façon dont le point de terminaison communique avec les clients. En outre, une liaison a un MessageVersion qui indique le EnvelopeVersion et le AddressingVersion du point de terminaison.

Propriétés Mappage WSDL
Name Utilisé dans le nom par défaut d'un point de terminaison, qui est le nom de liaison auquel est ajouté le nom du contrat séparé par un trait de soulignement.
Namespace targetNamespace de la définition wsdl:binding.

Lors de l’importation, si une stratégie est jointe au port WSDL, l’espace de noms de liaison importé correspond à l’targetNamespace de la définition wsdl:port.
BindingElementCollection, telle que retournée par la méthode CreateBindingElements() Différentes extensions propres au domaine de la définition wsdl:binding, généralement des assertions de stratégie.
MessageVersion EnvelopeVersion et AddressingVersion du point de terminaison.

Lorsque MessageVersion.None est spécifié, la liaison WSDL ne contient pas de liaison SOAP et le port WSDL n'a pas de contenu WS-Addressing. Ce paramètre est généralement utilisé pour les points de terminaison POX (Plain Old XML).

BindingElement

Les éléments de liaison d'un point de terminaison de liaison correspondent à différentes extensions WSDL dans la définition wsdl:binding, comme des assertions de stratégie.

Le TransportBindingElement de la liaison détermine l’URI (Uniform Resource Identifier) de transport d’une liaison SOAP.

AddressingVersion

AddressingVersion d'une liaison correspond à la version d'adressage utilisée dans la définition wsd:port. WCF prend en charge les adresses SOAP 1.1 et SOAP 1.2, de même que les références de point de terminaison WS-Addressing 08/2004 et WS-Addressing 1.0.

EnvelopeVersion

EnvelopeVersion d'une liaison correspond à la version de SOAP utilisée dans la définition wsdl:binding. WCF prend en charge les liaisons SOAP 1.1 et SOAP 1.2.

Contrats

L'instance ContractDescription d'une instance ServiceEndpoint correspond à un wsdl:portType. Une instance ContractDescription décrit toutes les opérations d'un contrat donné.

Propriétés Mappage WSDL
Name Valeur wsdl:portType/@name du contrat.
Namespace TargetNamespace de la définition wsdl:portType.
SessionMode Valeur wsdl:portType/@msc:usingSession du contrat. Cet attribut est une extension WCF pour WSDL 1.1.
Operations Définitions wsdl:operation du contrat.

Opérations

Une instance OperationDescription correspond à une wsdl:portType/wsdl:operation. Une OperationDescription contient une collection d’instances MessageDescription qui décrivent les messages de l’opération.

Deux comportements d'opération participent largement à la manière dont une OperationDescription est mappé à un document WSDL : DataContractSerializerOperationBehavior et XmlSerializerOperationBehavior.

Propriétés Mappage WSDL
Name Valeur wsdl:portType/wsdl:operation/@name de l’opération.
ProtectionLevel Assertions de protection dans la stratégie de sécurité jointe aux messages wsdl:binding/wsdl:operation de cette opération.
IsInitiating Valeur wsdl:portType/wsdl:operation/@msc:isInitiating de l’opération. Cet attribut est une extension WCF pour WSDL 1.1.
IsTerminating Valeur wsdl:portType/wsdl:operation/@msc:isTerminating de l’opération. Cet attribut est une extension WCF pour WSDL 1.1.
Messages Messages wsdl:portType/wsdl:operation/wsdl:input et wsdl:portType/wsdl:operation/wsdl:output de l’opération.
Faults Définitions wsdl:portType/wsdl:operation/wsdl:fault de l’opération.
Behaviors Les comportements DataContractSerializerOperationBehavior et XmlSerializerOperationBehavior gèrent la liaison d’opération et les messages d’opération.

DataContractSerializerOperationBehavior

Le comportement DataContractSerializerOperationBehavior d’une opération est une implémentation de l’IWsdlExportExtension qui exporte les messages WSDL et la liaison de cette opération. Les types de schémas XML sont exportés à l'aide de l'XsdDataContractExporter. Le comportement DataContractSerializerOperationBehavior détermine également l'utilisation, le style, ainsi que l'exportateur et importateur de schéma à utiliser pour cette opération.

Propriétés Mappage WSDL
DataContractFormatAttribute La propriété Style de cet attribut correspond à la valeur wsdl:binding/wsdl:operation/soap:operation/@style de l’opération.

Le comportement DataContractSerializerOperationBehavior prend uniquement en charge l'utilisation littérale des types de schémas dans WSDL.

XmlSerializerOperationBehavior

Le comportement XmlSerializerOperationBehavior d’une opération est une implémentation de l’IWsdlExportExtension qui exporte les messages WSDL et la liaison de cette opération. Les types de schémas XML sont exportés à l'aide de l'XmlSchemaExporter. Le comportement XmlSerializerOperationBehavior détermine également l'utilisation, le style, ainsi que l'exportateur et importateur de schéma à utiliser pour cette opération.

Propriétés Mappage WSDL
XmlSerializerFormatAttribute La propriété Style de cet attribut correspond à la valeur wsdl:binding/wsdl:operation/soap:operation/@style de l’opération.

La propriété Use de cet attribut correspond à la valeur wsdl:binding/wsdl:operation/soap:operation/* /@use de tous les messages de l’opération.

Messages

Une instance MessageDescription correspond à un wsdl:message qui est référencé par un message wsdl:portType/wsdl:operation/wsdl:input ou wsdl:portType/wsdl:operation/wsdl:output dans une opération. Une MessageDescription possède un corps et des en-têtes.

Propriétés Mappage WSDL
Action Action SOAP ou WS-Addressing du message.

Notez que les opérations qui utilisent la chaîne d'action "*" ne sont pas représentées dans WSDL.
Direction MessageDirection.Input correspond à wsdl:input.

MessageDirection.Output correspond à wsdl:output.
ProtectionLevel Assertions de protection dans la stratégie de sécurité jointe à la définition wsdl:message de ce message.
Body Corps du message.
Headers En-têtes du message.
ContractDescription.Name, OperationContract.Name À l’exportation, utilisé pour dériver la valeur wsdl:message/@name.

Corps du message

Une instance MessageBodyDescription correspond aux définitions wsdl:message/wsdl:part du corps d’un message. Le corps du message peut être encapsulé ou nu.

Propriétés Mappage WSDL
WrapperName Si le style n’est pas RPC, le WrapperName correspond au nom d’élément référencé par le wsdl:message/wsdl:part, avec @name ayant la valeur « paramètres ».
WrapperNamespace Si le style n’est pas RPC, WrapperNamespace correspond à l’espace de noms d’élément du wsdl:message/wsdl:part, avec @name ayant la valeur « paramètres ».
Parts Parties du message pour ce corps du message.
ReturnValue Élément enfant de l’élément wrapper si un élément wrapper existe (style document encapsulé ou style RPC), sinon premier wsdl:message/wsdl:part dans le message.

Parties du message

Une instance MessagePartDescription correspond à un wsdl:message/wsdl:part et au type de schéma XML ou à l’élément vers lequel la partie du message pointe.

Propriétés Mappage WSDL
Name Valeur wsd:message/wsdl:part/@name de la partie du message et nom de l’élément vers lequel la partie du message pointe.
Namespace Espace de noms de l'élément vers lequel la partie de message pointe.
Index Index du wsdl:message/wsdl:part du message.
ProtectionLevel Assertions de protection dans la stratégie de sécurité jointe à la définition wsdl:message de cette partie du message. La stratégie est paramétrée pour pointer vers la partie spécifique du message.
MessageType Type de schéma XML de l'élément vers lequel la partie du message pointe.

En-têtes de message

Une instance MessageHeaderDescription est une partie de message qui correspond également à une liaison soap:header de la partie du message.

Pannes

Une instance FaultDescription correspond à une définition wsdl:portType/wsdl:operation/wsdl:fault et à sa définition wsdl:message associée. La définition wsdl:message est ajoutée au même espace de noms cible que son type de port WSDL associé. La définition wsdl:message possède une seule partie de message nommée « détail » qui pointe vers l'élément du schéma XML qui correspond à la valeur de propriété DefaultType de l'instance FaultDescription.

Propriétés Mappage WSDL
Name Valeur wsdl:portType/wsdl:operation/wsdl:fault@name de l’erreur.
Namespace Espace de noms de l'élément du schéma XML vers lequel la partie « détail » du message d'erreur pointe.
Action Action SOAP ou WS-Addressing de l'erreur.
ProtectionLevel Assertions de protection dans la stratégie de sécurité jointe à la définition wsdl:message de cette erreur.
DetailType Type de schéma XML de l'élément vers lequel la partie « détail » du message pointe.
Name, ContractDescription.Name, OperationDescription.Name, Utilisé pour dériver la valeur wsdl:message/@name du message d’erreur.

Voir aussi