在 WCF 中,用戶端調用服務時,可能抛出的異常有以下三種類型。
1. 通訊異常。諸如網絡錯誤,位址錯誤,伺服器沒有啟動等等。這類異常多是 CommunicationException (或其具體繼承類型)。
2. 狀态異常。比如通路了已經關閉的代理對象,契約錯誤,以及安全設定錯誤等。常見的有 ObjectDisposedException。
3. 服務異常。由伺服器觸發,多是 FaultException。
針對服務異常,不同的執行個體管理方式會有不同的政策。
1. Pre-Call: 服務執行個體被釋放,用戶端抛出 FaultException,用戶端代理對象無法繼續使用。
2. Pre-Session: 服務執行個體被釋放,會話終止。用戶端抛出 FaultException,用戶端代理對象無法繼續使用。
3. Singleton: 服務執行個體依舊運作,會話終止。用戶端抛出 FaultException,用戶端代理對象無法繼續使用。
基于平台中立和技術整合的需要,WCF 以标準 Soap Faults 方式傳遞異常資訊。WCF 提供了 FaultException 和 FaultException<T> 兩個類型來操控 Soap Faults。通過 FaultException<T> 我們可以向用戶端傳遞一個錯誤資訊(FaultReason)以及一個附加的詳細資訊(Detail)。理論上,這個附加資訊是任何可以序列化的對象。
throw new FaultException<int>(123, "abc");
throw new FaultException<Exception>(new Exception("abc"));
如果想傳遞一個附帶中繼資料的自定義詳細資訊,可以使用 FaultContract。
[DataContract]
public class ExceptionData
{
[DataMember]
public string Message;
}
[ServiceContract]
public interface IService
[OperationContract]
[FaultContract(typeof(ExceptionData))]
void Test();
public class Service : IService, IDisposable
public void Test()
{
ExceptionData d = new ExceptionData();
d.Message = "xxxxxx";
throw new FaultException<ExceptionData>(d, "abc");
}
public void Dispose()
Console.WriteLine("Dispose...");
當然,我們也可以直接抛出一個被稱之為 "Unknown Faults" 的 FaultException 異常執行個體。還有另外一種情況,你已經寫好了代碼,有很多……很多……的代碼,要是一個個修改會非常……非常……麻煩,那麼怎麼在不做大的代碼修改情況下傳遞詳細異常資訊給用戶端呢?
方法1: ServiceBehavior(IncludeExceptionDetailInFaults=true)]
[ServiceBehavior(IncludeExceptionDetailInFaults=true)]
throw new Exception("abc");
方法2: ServiceDebugBehavior
這個比方法1要更友善一些,我們除了可以寫代碼外,還可以用配置檔案。
ServiceHost host = new ServiceHost(typeof(Service), new Uri("http://localhost:8080/Service"));
host.AddServiceEndpoint(typeof(IService), new BasicHttpBinding(), "");
ServiceDebugBehavior debug = host.Description.Behaviors.Find<ServiceDebugBehavior>();
debug.IncludeExceptionDetailInFaults = true;
host.Open();
看看這兩種方法抛出的異常是什麼樣的。
未處理 System.ServiceModel.FaultException`1
Message="abc"
Source="mscorlib"
StackTrace:
Server stack trace:
在 ConsoleApplication1.localhost.IService.Test()
在 ConsoleApplication1.localhost.ServiceClient.Test() 位置 D:\...\localhost.cs:行号 60
在 ConsoleApplication1.Program.Main(String[] args) 位置 D:\...\Program.cs:行号 62
不錯,除了 Error Message,還有詳細的 stack trace,友善調試。也正因為這樣,此種方法也不适合在正式項目中使用,作為系統架構設計的一部分,我們應該事先設計好異常處理。
如果服務方法是 IsOneWay=true,因不接收傳回消息,用戶端也就不會觸發異常了。而 Callback 無非是伺服器和用戶端掉換個身份而已,道理相同。
public interface ICallback
void DoCallback();
[ServiceContract(CallbackContract=typeof(ICallback))]
[ServiceBehavior(ConcurrencyMode=ConcurrencyMode.Reentrant)]
try
{
OperationContext.Current.GetCallbackChannel<ICallback>().DoCallback();
}
catch (FaultException e)
Console.WriteLine(e);
本文轉自
高陽 51CTO部落格,原文連結: http://blog.51cto.com/xiaoyinnet/196450,如需轉載請自行聯系原作者