Spécification d'une adresse de point de terminaison

Toute communication avec un service Windows Communication Foundation (WCF) a lieu par l'intermédiaire de ses points de terminaison. Chaque ServiceEndpoint contient un Address, un Bindinget un Contract. Le contrat spécifie quelles opérations sont disponibles. La liaison spécifie comment communiquer avec le service et l'adresse spécifie où rechercher le service. Chaque point de terminaison doit avoir une adresse unique. L'adresse de point de terminaison est représentée par la classe EndpointAddress, qui contient un URI (Uniform Resource Identifier) représentant l'adresse du service, un Identity représentant l'identité de sécurité du service et une collection de Headersfacultative. Les en-têtes facultatifs fournissent des informations d'adressage plus détaillées pour identifier ou interagir avec le point de terminaison. Par exemple, les en-tête peuvent indiquer comment traiter un message entrant, où le point de terminaison doit envoyer un message de réponse ou quelle instance d'un service utiliser pour traiter un message entrant d'un utilisateur particulier lorsque plusieurs instances sont disponibles.

Définition d'une adresse de point de terminaison

Dans WCF, un EndpointAddress modèle une référence de point de terminaison (EPR) comme défini dans le standard WS-Addressing.

L'URI d'adresse de la plupart des transports se compose de quatre parties. Par exemple, cet URI, "http://www.fabrikam.com: 322/mathservice.svc/secureEndpoint" est constitué des quatre parties suivantes :

• Schéma : http:
• Ordinateur : www.fabrikam.com
• (facultatif) Port : 322
• Chemin d'accès : /mathservice.svc/secureEndpoint

Une partie du modèle ERP établit que chaque référence de point de terminaison peut contenir des paramètres de référence qui ajoutent des informations d'identification supplémentaires. Dans WCF, ces paramètres de référence sont modélisés sous forme d'instances de la classe AddressHeader.

L'adresse du point de terminaison pour un service peut être spécifiée de manière impérative en utilisant le code ou de façon déclarative par la configuration. La définition des points de terminaison dans le code est habituellement peu pratique car les liaisons et les adresses pour un service déployé sont en général différentes de celles utilisées au cours du développement du service. En général, il est plus pratique de définir des points de terminaison de service à l'aide de la configuration plutôt que du code. Le fait de conserver les informations de liaison et d'adressage hors du code leur permet de changer sans devoir recompiler ou de redéployer l'application.

Il y a deux façons de spécifier des adresses de point de terminaison pour un service dans WCF. Vous pouvez spécifier une adresse absolue pour chaque point de terminaison associé au service ou vous pouvez fournir une adresse de base pour le ServiceHost d'un service puis spécifier une adresse pour chaque point de terminaison associé à ce service défini comme relatif à cette adresse de base. Vous pouvez utiliser chacune de ces procédures pour spécifier les adresses de point de terminaison pour un service dans la configuration ou le code. Si vous ne spécifiez pas d'adresse relative, le service utilise l'adresse de base. Vous pouvez également avoir plusieurs adresses de base pour un service, mais une seule adresse de base pour chaque transport est autorisée pour chaque service. Si vous avez plusieurs points de terminaison, chacun configuré avec une liaison différente, leurs adresses doivent être uniques. Les points de terminaison qui utilisent la même liaison mais des contrats différents peuvent utiliser la même adresse.

Lorsque vous hébergez avec les services IIS, vous ne gérez pas l'instance ServiceHost vous-même. L'adresse de base est toujours l'adresse spécifiée dans le fichier .svc pour le service lors de l'hébergement dans IIS. Par conséquent, vous devez toujours utiliser des adresses de point de terminaison relatives pour les points de terminaison de service hébergés dans IIS. Fournir une adresse de point de terminaison qualifiée complète peut entraîner des erreurs lors du déploiement du service. Pour plus d'informations, consultez Déploiement d'un service WCF hébergé dans Internet Information Services.

Définition des adresses de point de terminaison dans la configuration

Pour définir un point de terminaison dans un fichier de configuration, utilisez l'élément <endpoint>.

Lorsque la méthode Open est appelée (c'est-à-dire, lorsque l'application d'hébergement essaie de démarrer le service), le système recherche un élément <service> avec un attribut de nom qui spécifie "UE.Samples.HelloWorld." Si l'élément <service> est trouvé, le système charge la classe spécifiée et crée des points de terminaison à l'aide des définitions de point de terminaison fournies dans le fichier de configuration. Ce mécanisme vous permet de charger et de démarrer un service avec deux lignes de code tout en laissant la liaison et les informations d'adressage hors de votre code. L'avantage de cette approche est que ces modifications peuvent être apportées sans devoir recompiler ou redéployer l'application.

Les en-tête facultatifs sont déclarés dans un <headers> element. Les éléments suivants sont un exemple des éléments utilisé pour spécifier des points de terminaison pour un service dans un fichier de configuration qui fait la distinction entre deux en-tête : clients "Gold" de http://tempuri1.org/ et clients "Standard" de http://tempuri2.org/. Le client appelant ce service doit avoir le <headers> element approprié dans son fichier de configuration.

Les en-tête peuvent également être définis sur les messages individuels au lieu de tous les messages sur un point de terminaison (comme montré précédemment). Pour cela, vous devez utiliser OperationContextScope pour créer un nouveau contexte dans une application cliente afin d'ajouter un en-tête personnalisé au message sortant, comme illustré dans l'exemple suivant.

Adresse de point de terminaison dans les métadonnées

Une adresse de point de terminaison est représentée dans WSDL (Web Services Description Language) comme un élément EndpointReference (EPR) WS-Addressing dans l'élément wsdl:port du point de terminaison correspondant. L'EPR contient l'adresse du point de terminaison ainsi que toutes les propriétés d'adresse. Notez que l'EPR à l'intérieur de wsdl:port remplace soap:Address comme dans l'exemple suivant.

Définition d'adresses de point de terminaison dans le code

Une adresse de point de terminaison peut être créée dans le code avec la classe EndpointAddress. L'URI spécifié pour l'adresse de point de terminaison peut être un chemin d'accès qualifié complet ou un chemin d'accès qui est relatif à l'adresse de base du service. L'exemple de code suivant illustre la création d'une nouvelle instance de la classe EndpointAddress et son ajout à l'instance ServiceHost qui héberge le service.

L'exemple suivant montre comment spécifier l'adresse de point de terminaison complète dans le code.

L'exemple suivant montre comment ajouter une adresse relative ("MyService") à l'adresse de base de l'hôte de service.

Remarque :

Les propriétés de ServiceDescription dans l'application de service ne doivent pas être modifiées à l'issue de la méthode OnOpening sur ServiceHostBase. Certains membres, tels que la propriété Credentials et les méthodes AddServiceEndpoint sur ServiceHostBase et ServiceHost, lèvent une exception s'ils sont modifiés au-delà de ce point. D'autres membres peuvent être modifiés, mais le résultat n'est pas défini. De la même façon, sur le client, les valeurs ServiceEndpoint ne doivent pas être modifiées après l'appel à OnOpening sur ChannelFactory. La propriété Credentials lève une exception si elle est modifiée au-delà de ce point. Les autres valeurs de description du client peuvent être modifiées sans erreur, mais le résultat n'est pas défini. Aussi bien pour le service que pour le client, il est recommandé de modifier la description avant d'appeler Open.

Voir aussi

Référence

EndpointAddress

Concepts

Identité du service et authentification
Vue d'ensemble de la création de points de terminaison

Autres ressources

Hébergement