實戰 Web Service 開發精要：序列化限制、實體設計與 Silverlight 協同架構

Web Service (ASMX/WCF) 仍是企業級系統集成主力。本文總結實體類設計禁忌、序列化陷阱、以及 Silverlight 客戶端協同的分層架構實踐。

架構分層

• Jasen.SilverlightService：Silverlight 客戶端專案
• Jasen.SilverlightService.Core：共享契約/實體/演算法庫（職責鏈模式實現路徑演算法）
• Jasen.SilverlightService.Web：Web Service 發布站點

實體類設計鐵律

實體類範例：ServerInfo

[DataContract]
public class ServerInfo {
    [DataMember] public string Title { get; set; }
    [DataMember] public string Content { get; set; }
    [DataMember] public bool IsPublished { get; set; }

    // 唯讀欄位：僅序列化輸出，不接受客戶端輸入
    [DataMember] public string SmallTitle { get; } = "small title";
    [DataMember] public bool IsSucceed { get; } = true;
}

服務合約與實現

[ServiceContract]
public interface IDataService {
    [OperationContract]
    ServerInfo GetData(string param); // 參數、返回皆為具體型別
}

[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]
public class DataService : IDataService {
    public ServerInfo GetData(string param) {
        // 調用 Core 庫職責鏈演算法
        var result = AlgorithmChain.Execute(param);
        return new ServerInfo { Title = result.Title, Content = result.Detail };
    }
}

Silverlight 客戶端調用

var client = new DataServiceClient();
client.GetDataCompleted += (s, e) => {
    if (e.Error == null) {
        var info = e.Result;
        // 繫結 UI：info.Title, info.Content
    }
};
client.GetDataAsync("paramValue");

常見坑位與對策

• 循環引用：實體雙向導航屬性 → 設 [DataContract(IsReference=true)] 或 DTO 扁平化。
• 大數據傳輸：啟用 MTOM 編碼 <binding messageEncoding="Mtom">，分塊傳輸。
• 異常屏蔽：WCF 預設不傳輸堆疊追蹤 → 實作 IErrorHandler 返回友善 FaultException。
• 跨域調用：Silverlight 需 clientaccesspolicy.xml 或 crossdomain.xml 部署於網站根目錄。