Koncové body: adresy, vazby a kontrakty

Veškerá komunikace se službou Windows Communication Foundation (WCF) probíhá prostřednictvím koncových bodů služby. Koncové body poskytují klientům přístup k funkcím nabízeným službou WCF.

Každý koncový bod se skládá ze čtyř vlastností:

  • Adresa, která označuje, kde se koncový bod nachází.

  • Vazba, která určuje, jak může klient komunikovat s koncovým bodem.

  • Kontrakt, který identifikuje dostupné operace.

  • Sada chování, která určují podrobnosti místní implementace koncového bodu.

Toto téma popisuje tuto strukturu koncového bodu a vysvětluje, jak je reprezentována v objektovém modelu WCF.

Struktura koncového bodu

Každý koncový bod se skládá z následujících:

  • Adresa: Adresa jednoznačně identifikuje koncový bod a informuje potenciální uživatele služby, kde se nachází. Je reprezentován v objektovém modelu EndpointAddress WCF třídou. Třída EndpointAddress obsahuje:

    • Vlastnost Uri , která představuje adresu služby.

    • Vlastnost Identity , která představuje identitu zabezpečení služby a kolekci volitelných záhlaví zpráv. Volitelné hlavičky zprávy slouží k poskytnutí dalších a podrobnějších informací o adresování k identifikaci koncového bodu nebo interakci s ním.

    Další informace najdete v tématu Zadání adresy koncového bodu.

  • Vazba: Vazba určuje, jak komunikovat s koncovým bodem. Sem patří:

    • Přenosový protokol, který se má použít (například TCP nebo HTTP).

    • Kódování, které se má použít pro zprávy (například text nebo binární soubor).

    • Nezbytné požadavky na zabezpečení (například zabezpečení zpráv SSL nebo SOAP).

    Další informace najdete v tématu Přehled vazeb WCF. Vazba je reprezentována v objektovém modelu WCF abstraktní základní třídou Binding. Ve většině scénářů můžou uživatelé používat jednu ze systémových vazeb. Další informace naleznete v tématu Systémové vazby.

  • Kontrakty: Kontrakt popisuje, jaké funkce koncový bod zveřejňuje klientovi. Smlouva určuje:

    • Jaké operace může klient volat.

    • Forma zprávy.

    • Typ vstupních parametrů nebo dat potřebných k volání operace.

    • Jaký typ zpracování nebo odpovědi může klient očekávat.

    Další informace o definování kontraktu naleznete v tématu Návrh kontraktů služeb.

  • Chování: Chování koncového bodu můžete použít k přizpůsobení místního chování koncového bodu služby. Chování koncových bodů toho dosáhnete tím, že se účastní procesu vytváření modulu runtime WCF. Příkladem chování koncového bodu je ListenUri vlastnost, která umožňuje zadat jinou adresu naslouchání než adresa SOAP nebo WSDL (Web Services Description Language). Další informace naleznete v tématu ClientViaBehavior.

Definování koncových bodů

Koncový bod pro službu můžete zadat buď imperativním použitím kódu, nebo deklarativní prostřednictvím konfigurace. Další informace najdete v tématu Postupy: Vytvoření koncového bodu služby v konfiguraci a postupy: Vytvoření koncového bodu služby v kódu.

V tomto oddílu

Tato část vysvětluje účel vazeb, koncových bodů a adres; ukazuje, jak nakonfigurovat vazbu a koncový bod; a ukazuje, jak používat ClientVia chování a ListenUri vlastnost.

Adresy
Popisuje, jak se koncové body řeší ve WCF.

Vazby
Popisuje, jak se vazby používají k určení podrobností přenosu, kódování a protokolu požadovaných pro komunikaci klientů a služeb.

Kontrakty
Popisuje, jak kontrakty definují metody služby.

Postupy: Vytvoření koncového bodu služby v konfiguraci
Popisuje, jak vytvořit koncový bod služby v konfiguraci.

Postupy: Vytvoření koncového bodu služby v kódu
Popisuje, jak vytvořit koncový bod služby v kódu.

Postupy: Ověření zkompilovaného kódu služby pomocí nástroje Svcutil.exe
Popisuje, jak rozpoznat chyby v implementacích a konfiguracích služeb bez hostování služby pomocí nástroje ServiceModel Metadata Utility (Svcutil.exe).

Viz také