談 WCF Data Contract (一)：資料合約核心概念與對應機制

前言：SOA 中的合約分層

服務導向架構 (SOA) 將業務分解為自治服務，服務間透過合約交互。合約分兩層：

• 服務合約：描述作業介面、訊息交換模式 (Request-Response、One-Way、Duplex 等)。
• 資料合約：描述訊息承載的資料結構，以廠商中立方式 (XML/XSD) 表達。

WCF 的核心任務：將 .NET CLR 型別 (介面/類別) 轉換為中立合約，反之亦然。

WCF 合約程式設計模型

資料合約轉換範例

CLR 型別 (服務端)

[DataContract(Namespace = "https://artech.datacontractversioning")]
public class Order
{
    [DataMember(Order = 0)] public Guid OrderID { get; set; }
    [DataMember(Order = 1)] public DateTime OrderDate { get; set; }
    [DataMember(Order = 2)] public Guid SupplierID { get; set; }
}

中立 XSD (服務公開)

<xs:schema targetNamespace="https://artech.datacontractversioning" ...>
  <xs:complexType name="Order">
    <xs:sequence>
      <xs:element name="OrderID" type="ser:guid" minOccurs="0"/>
      <xs:element name="OrderDate" type="xs:dateTime" minOccurs="0"/>
      <xs:element name="SupplierID" type="ser:guid" minOccurs="0"/>
    </xs:sequence>
  </xs:complexType>
  <xs:element name="Order" nillable="true" type="tns:Order"/>
</xs:schema>

用戶端 Proxy 類別 (自動產生)

[DataContract(Name = "Order", Namespace = "https://artech.datacontractversioning")]
public partial class Order : IExtensibleDataObject, INotifyPropertyChanged
{
    [DataMember(Order = 0)] public Guid OrderID { get; set; }
    [DataMember(Order = 1)] public DateTime OrderDate { get; set; }
    [DataMember(Order = 2)] public Guid SupplierID { get; set; }
    public ExtensionDataObject ExtensionData { get; set; }
    // PropertyChanged 實作...
}

資料合約的雙重功能

1. 曝光功能：將 CLR 型別轉換為中立合約 (服務端)。
2. 適配功能：將現有 CLR 型別對應至既定中立合約 (用戶端)。

兩者本質等價：透過屬性參數 (Name、Namespace、Order、IsRequired、EmitDefaultValue) 控制對應關係。

對應機制實例：CustomOrder 適配 Order 合約

用戶端原有型別

public class CustomOrder
{
    public Guid OrderNo { get; set; }
    public Guid SupplierNo { get; set; }
    public DateTime OrderDate { get; set; }
}

差異分析

透過屬性完成適配

[DataContract(Name = "Order", Namespace = "https://artech.datacontractversioning")]
public class CustomOrder
{
    [DataMember(Order = 0, Name = "OrderID")] public Guid OrderNo { get; set; }
    [DataMember(Order = 2, Name = "SupplierID")] public Guid SupplierNo { get; set; }
    [DataMember(Order = 1)] public DateTime OrderDate { get; set; }
    [DataMember(Order = 3)] public string ShippingAddress { get; set; }
}

關鍵屬性：

• DataContract.Name、Namespace：對應 XSD complexType name、targetNamespace
• DataMember.Name：對應 XSD element name
• DataMember.Order：對應 XSD sequence 順序

核心屬性速查表

開發模式選擇

• 共用組件模式：WCF-WCF 專案，共用定義合約的組件，最直接、效能最佳。
• Proxy 產生模式：異構用戶端，透過 Add Service Reference / Svcutil.exe 產生 Proxy。
• 手工適配模式：用戶端已有領域模型，需對應既有服務合約，彈性最高。

結語

資料合約是 WCF 連結 .NET 型別系統與 XML 結構描述的橋樑。掌握屬性對應機制，能靈活處理版本演進、異構整合與領域模型映射。後續文章將深入探討泛型、集合、版本控制等進階主題。