WCF 從理論到實踐 (3)：契約全解析——服務、資料、錯誤、訊息四大合約

文章導讀

本文系統闡述 WCF 四大契約類型（服務、資料、錯誤、訊息）的定義、用途、聲明式程式設計模式、跨平台獨立性、與 ASMX Web Service 的異同。適合 WCF 初學者建立契約核心觀念。

核心知識點

• 四大契約類型定義與屬性對應表
• 聲明式程式設計：屬性標註即完成契約定義
• 契約跨平台獨立性：只約束規則，不綁定技術棧
• 與 ASMX Web Service 異同：介面導向、版本共存優勢

一、WCF 四大契約總覽

二、契約定義實戰範例

1. 服務契約

[ServiceContract]
public interface IUserService {
    [OperationContract]
    UserDto GetUser(int id);

    [OperationContract]
    [FaultContract(typeof(UserNotFoundFault))]
    UserDto GetUserWithFault(int id);
}

2. 資料契約

[DataContract]
public class UserDto {
    [DataMember] public int Id { get; set; }
    [DataMember] public string Name { get; set; }
    [DataMember] public string Email { get; set; }
    // 無 DataMember 的欄位不會序列化
    public string InternalNote { get; set; }
}

3. 錯誤契約

[DataContract]
public class UserNotFoundFault {
    [DataMember] public int UserId { get; set; }
    [DataMember] public string Message { get; set; }
    [DataMember] public DateTime Timestamp { get; set; }
}

// 服務端拋出
throw new FaultException<UserNotFoundFault>(
    new UserNotFoundFault { UserId = id, Message = "用戶不存在", Timestamp = DateTime.Now },
    new FaultReason("查無此用戶")
);

4. 訊息契約

[MessageContract]
public class CustomRequest {
    [MessageHeader] public string CorrelationId { get; set; }
    [MessageHeader] public string SecurityToken { get; set; }
    [MessageBodyMember] public UserDto Payload { get; set; }
}

三、契約的跨平台獨立性

WCF 契約獨立於平台、語言、作業系統：

• 本質是 XSD/WSDL/WS-Policy 等開放標準
• 只約束「通訊雙方必須遵守的規則」
• 不關心雙方實現技術 (C#/Java/Go) 或 OS (Windows/Linux)
• 這是 WCF 作為 SOA 基礎設施的生命力所在

四、契約與 ASMX Web Service 異同深度對比

五、參考資源

• Artech: WCF 契約詳解
• 資料契約實戰
• 錯誤契約實戰
• 訊息契約實戰

總結

1. 契約是 WCF 通訊雙方的「法律條文」，四大類各司其職
2. 聲明式屬性讓契約定義極簡單：標註即生效
3. 跨平台獨立性源於開放標準，不綁定實現技術
4. 介面導向設計是 WCF 相對 ASMX 最大進化，支援多版本並行、解耦實現
5. 掌握四大契約，即掌握 WCF 服務設計的靈魂