共用方式為


設計與實作服務

本節將說明如何定義和實作 WCF 合約。服務合約會指定端點與外界溝通的內容。更具體來說,這是關於一組會組織到基本訊息交換模式 (MEP) 之特定訊息的聲明,而這些交換模式包括要求/回覆、單向和雙工。如果服務合約為一組邏輯相關的訊息交換,則服務作業就是單一的訊息交換。例如,Hello 作業一定會明確地接收一個訊息 (這樣呼叫端才能宣告歡迎畫面),但卻不一定會傳回訊息 (需視作業的禮節而定)。

如需合約以及其他核心 Windows Communication Foundation (WCF) 概念的詳細資訊,請參閱Windows Communication Foundation 的主要概念。本主題將著重於讓您瞭解服務合約。如需如何建置可使用服務合約連線到服務之用戶端的詳細資訊,請參閱 WCF 用戶端概觀

概觀

本主題會提供在設計和實作 WCF 服務時的高層級概念方向。副標題則提供設計和實作之細節的詳細資訊。在設計及實作您的 WCF 應用程式之前,建議您先:

  • 瞭解服務合約是什麼、如何使用它,以及如何建立它。
  • 瞭解合約會聲明執行階段組態或裝載環境不一定會支援的最低需求。

服務合約

服務合約就是承諾下列事項的聲明:

  • 單一服務中作業的分組。
  • 依據所交換訊息的作業簽章。
  • 這些訊息的資料型別。
  • 作業的位置。
  • 用於支援與服務的成功通訊的特定通訊協定和序列化格式。

例如,某個採購單合約可能會有 CreateOrder 作業,而該作業已接受訂單資訊類型輸入,並且已傳回成功或失敗資訊,其中包括訂單識別碼。該合約可能也有 GetOrderStatus 作業,而該作業已接受訂單識別碼,並且已傳回訂單狀態資訊。這類服務合約會指定:

  1. 採購單合約由 CreateOrderGetOrderStatus 作業組成。
  2. 這些作業擁有指定的輸入訊息和輸出訊息。
  3. 這些訊息可以包含的資料。
  4. 成功處理訊息時所需要之通訊基礎結構的分類聲明。例如,這些詳細資訊包含在建立成功通訊時是否需要安全性及安全性的格式為何。

為了將此類資訊傳遞給多數其他平台 (包括非 Microsoft 的平台) 上的其他應用程式,XML 服務合約會以標準 XML 格式公開表示,例如 Web服務描述語言 (WSDL,本頁面可能為英文) 以及 XML 結構描述 (XSD,本頁面可能為英文) 等格式。大多數平台的開發人員都可以使用這項公開的合約資訊來建立可以和服務進行通訊的應用程式,除了因為他們瞭解規格語言,更因為這些語言已設計成可透過描述服務所支援的公開形式、格式和通訊協定來達到互通性。如需 WCF 如何處理此類資訊的詳細資訊,請參閱中繼資料

合約能夠以多種方式表示,但 WSDL 和 XSD 卻是能夠以可存取方式來描述服務的絕佳語言,這兩種語言很難直接使用,而且只能建立服務描述,而不能建立服務合約實作。因此,WCF 應用程式會使用 Managed 屬性、介面和類別來定義服務結構並實作該服務。

結果所產生且定義為 Managed 型別的合約,可以在用戶端或其他服務實作器 (特別在其他平台上) 需要時轉換 (或稱「匯出」(Exported)) 為中繼資料 (WSDL 和 XSD)。其結果便是產生一個簡單扼要的程式設計模型,而這個模型可以使用公開中繼資料描述給任何用戶端應用程式。基礎 SOAP 訊息的詳細資訊、傳輸和安全性相關資訊等資料可以留給 WCF,這個應用程式會在必要時自動在服務合約類型系統和 XML 類型系統之間來回執行轉換。

如需設計合約的詳細資訊,請參閱設計服務合約。如需實作合約的詳細資訊,請參閱實作服務合約

最新的訊息

如果您已經習慣遠端程序呼叫 (RPC) 樣式的方法簽章,那麼使用 Managed 的介面、類別和方法來建立服務作業模型將更為簡單,此時傳遞參數至方法及接收傳回值是物件或其他類型程式碼之要求功能的一般形式。例如,使用 Managed 語言 (例如 Visual Basic 和 C++ COM) 的程式設計人員可以在建立 WCF 服務合約時應用他們對於 RPC 樣式方法 (不論使用物件或介面) 的知識,而不會遇到 RPC 樣式分散式物件系統的固有問題。服務方向除了提供鬆散耦合、訊息導向之程式設計的優點,同時保留簡易且熟悉的 RPC 程式設計經驗。

有許多程式設計人員更熟悉使用訊息導向的應用程式設計介面,例如 Microsoft MSMQ 之類的訊息佇列、.NET Framework 中的 System.Messaging 命名空間 (Namespace),或在 HTTP 要求中傳送非結構化的 XML,以上只是略舉部分例子。如需在訊息層級進行程式設計的詳細資訊,請參閱使用訊息合約服務通道層級的程式設計與 POX 應用程式的互通性

瞭解需求的階層架構

服務合約可將作業分組、指定訊息交換模式、訊息類型,以及這些訊息所包含的資料型別,並指出實作必須擁有以支援合約的執行階段行為類別 (例如,合約可能會要求加密及簽署訊息)。服務合約本身並不會清楚地指定如何達到這些需求,而只會指定必須達到這些需求。加密類型或簽署訊息的方式取決於實作以及相容性服務的組態。

請注意,合約需要服務合約實作和執行階段組態中的某些項目才能新增行為。必須符合才能公開服務提供使用的一組需求,是採用前一組需求來做為建置基礎。如果合約有提出實作需求,則實作可能會需要更多的組態和繫結才能夠讓服務執行。最後,主應用程式 (Host Application) 也必須支援服務組態和繫結所新增的任何需求。

在設計、實作、設定和裝載 Windows Communication Foundation (WCF) 服務應用程式時,必須特別注意這項新增的需求程序。例如,合約可以指定必須支援某個工作階段。若是如此,您就必須將繫結設定成可支援該合約需求,否則服務實作將無法運作。或者,如果您的服務需要 Windows 整合式驗證而且已裝載於網際網路資訊服務 (IIS),則服務所在的 Web 應用程式必須啟用 Windows 整合式驗證並關閉匿名支援。如需不同服務之主應用程式類型之功能和影響的詳細資訊,請參閱裝載服務

請參閱

概念

設計服務合約
實作服務合約