[ASP.NET WebApi2]統一回傳訊息格式比較完整的處理方法 (3) 全域的Exception處理
在上一篇文章「統一回傳訊息格式比較完整的處理方法 (2) Action中Exception處理」中,我們增加了一個繼承自ExceptionFilterAttribute的類別讓在Action中的方法產生例外時可以用統一的格式回傳。
不過根據這篇文章的說明,當Exception發生在以下情況出現Exception時是不會被ExceptionFilterAttribute處理的:
- Controll constructors
- Message handlers
- Routing
- Response content serialization
為了讓這些情況的Exception都可以正常被處理,我們需要在新增一個繼承自ExceptionHandler的類別,不過此時可以發現,之前曾經寫過的ExceptionFilterAttribute中已經有一段將Exception和自訂的ApiException轉成ApiResponse的程式,在這裡也會需要用到,因此將這段程式碼拉出來成為一個工具類別方便不同來源使用
public class ExceptionUtils
{
public static ApiResponse ToApiResponse(Exception exception)
{
var errorApiResponseResult = new ApiResponse();
if (exception is ApiException)
{
var apiException = exception as ApiException;
errorApiResponseResult.StatusCode = apiException.StatusCode;
errorApiResponseResult.Error = new
{
ErrorId = apiException.ErrorId,
Message = apiException.Message
};
}
else
{
errorApiResponseResult.StatusCode = HttpStatusCode.BadRequest;
errorApiResponseResult.Error = new
{
ErrorId = "",
Message = exception.Message
};
}
return errorApiResponseResult;
}
}
然後將之前的ApiExceptionResponseAttribute裡面的這一行
// 將錯誤訊息轉成要回傳的ApiResponseResult
var errorApiResponseResult = exceptionToApiResponse(actionExecutedContext.Exception);
修改成
// 將錯誤訊息轉成要回傳的ApiResponseResult
var errorApiResponseResult = ExceptionUtils.ConvertToApiResponse(actionExecutedContext.Exception);
接著就來加入自訂的ExceptionHandler囉
public class GlobalApiExceptionHandler : ExceptionHandler
{
internal class GlobalExceptionResponseActoinResult : IHttpActionResult
{
public HttpRequestMessage Request { get; set; }
public Exception Exception { get; set; }
public Task ExecuteAsync(CancellationToken cancellationToken)
{
var apiResponseResult = ExceptionUtils.ConvertToApiResponse(Exception);
var response = new HttpResponseMessage(apiResponseResult.StatusCode)
{
Content = new ObjectContent(apiResponseResult.GetType(), apiResponseResult, new JsonMediaTypeFormatter()),
RequestMessage = Request,
};
return Task.FromResult(response);
}
}
///
/// 在衍生類別中覆寫時,同步處理例外狀況。
///
///例外狀況處理常式內容。
public override void Handle(ExceptionHandlerContext context)
{
context.Result = new GlobalExceptionResponseActoinResult
{
Request = context.ExceptionContext.Request,
Exception = context.Exception
};
}
}
接下來記得一樣要在WebApiConfig.cs中加入
config.Services.Replace(typeof(IExceptionHandler), new GlobalApiExceptionHandler());
就算是大功告成啦!
如果您覺得我的文章有幫助,歡迎免費成為 LikeCoin 會員,幫我的文章拍手 5 次表示支持!