6.5 ABP表现层 - 异常处理

6.5.1 简介

该文档只是针对ASP.NET MVC 以及Web API。如果你对ASP.NET Core也感兴趣，请参考ASP.NET Core文档。

在 web 应用程序中，异常通常是在 MVC Controller actions 和 Web API Controller actions 中被处理的。当异常发生时，应用程序用户被以某种方式告知该错误和该错误产生的可选原因（就是列举出产生该异常的多种原因，产生错误的原因可能是列举出的一种也可能是多种。）

如果一个常规的HTTP请求产生错误，那么一个错误页面会展示。如果AJAX请求产生错误，服务器端会发送错误消息到客户端，然后客户端处理并显示该错误给用户。

在所有的Web请求中处理异常是一个单调乏味并且重复性的工作。然而在ABP中，你几乎不需为任何异常的指定明确的异常处理，ABP会自动的记录这些异常并且以适当的格式做出响应返回到客户端。也就是说，在客户端处理这些响应并且将错误详细显示给客户。

6.5.2 开启错误处理

为了开启错误处理，customErrors 必须设置如下：

  1. <customErrors mode="On" />

也可以设置 ‘RemoteOnly’ 如果你不想在本地处理这些错误。请注意，这只是针对ASP.NET MVC控制器，对于Web API控制器则是没必要的。

如果你已在全局过滤器中已经处理了异常，那么异常可能会被隐藏，并且ABP异常可能也不会按你预期的那样工作。所以，如果你想那样做的话，请小心操作。

6.5.3 非Ajax请求

如果不是Ajax 请求，那么将会显示一个错误页面。

1. 显示异常(Showing exceptions)

MVC Controller action抛出了一个异常，如下所示：

  1. public ActionResult Index()
  2. {
  3.     throw new Exception("A sample exception message...");
  4. }

当然，这个异常能够被指定调用的action中的另外的方法抛出。ABP处理这个异常，记录异常信息并且显示’Error.cshtml’ 视图。你能够自定义这个视图来显示该错误。example 错误视图（这个视图是ABP中缺省错误视图模板）。

异常处理 - 图1

ABP 隐藏了异常的详细信息，而是向用户展示了一个标准的（本地化的，友好化的）错误信息。除非你明确指定抛出一个UserFriendlyException 异常。

2. 用户异常友好化（UserFriendlyException）

UserFriendlyException是一个特殊的异常类型，被用来直接的显示给用户。请看下面示例：

  1. public ActionResult Index()
  2. {
  3.     throw new UserFriendlyException("Ooppps! There is a problem!", "You are trying to see a product that is deleted...");
  4. }

ABP记录这个异常并且不隐藏这次的异常信息：

异常处理 - 图2

所以，如果你想显示一个特殊的错误信息给用户，你只需要抛出一个UserFriendlyException（或者一个派生自该异常类的类型，也就是说继承这个异常类的子类）。

3. 错误模型(Error model)

ABP传递一个ErrorViewModel 对象给Error视图：

  1. public class ErrorViewModel
  2. {
  3.     public AbpErrorInfo ErrorInfo { get; set; }
  4.     public Exception Exception { get; set; }
  5. }

ErrorInfo 包含了能够显示给客户的详细的异常信息。Exception 对象就是那个被抛出的异常。你能够核实异常并且附加自定义信息来显示，如果你想这样做的话。例如：我们能够核实该异常是否是一个AbpValidationException。

异常处理 - 图3

6.5.4 AJAX请求

如果请求是一个AJAX请求，ABP会返回一个JSON对象到客户端。ASP.NET MVC Controllers 和 ASP.NET Web API Controllers 也是这么处理的。以JSON方式返回一个异常信息，请看下面示例：

  1. {
  2.   "targetUrl": null,
  3.   "result": null,
  4.   "success": false,
  5.   "error": {
  6.     "message": "An internal error occured during your request!",
  7.     "details": "..."
  8.   },
  9.   "unAuthorizedRequest": false
  10. }

success: false 表示有一个错误发生。error对象提供了 错误信息和错误的详细描述。

当你在客户端用ABP的基础设施来做一个AJAX请求时，它会用message API自动的处理这个JSON对象并且显示错误信息给用户。更多信息请参照AJAX API 和dynamic web api layer。

6.5.5 异常事件

当ABP处理任意异常时，它会触发 AbpHandledExceptionData 事件，并且会发出通知如果你注册了处理该事件的类。如下所示：

  1. public class MyExceptionHandler : IEventHandler<AbpHandledExceptionData>, ITransientDependency
  2. {
  3.     public void HandleEvent(AbpHandledExceptionData eventData)
  4.     {
  5.         //TODO: Check eventData.Exception!
  6.     }
  7. }

如果你将该示例代码放入你的应用程序中(通常是你的web项目)，ABP 会调用 HandleEvent 方法来处理所有的异常。所以，你可以查看异常对象的详细异常信息。