SpringMVC 異常處理

Using HTTP Status Codes

在咱們自定義的異常上使用ResponseStatus註解。當咱們的Controller拋出異常，而且沒有被處理的時候，他將返回HTTP STATUS 爲指定值的 HTTP RESPONSE，好比：

@ResponseStatus(value=HttpStatus.NOT_FOUND, reason="No such Order")  // 404
    public class OrderNotFoundException extends RuntimeException {
        // ...
    }

咱們的Controller爲：

@RequestMapping(value="/orders/{id}", method=GET)
    public String showOrder(@PathVariable("id") long id, Model model) {
        Order order = orderRepository.findOrderById(id);
        if (order == null) throw new OrderNotFoundException(id);
        model.addAttribute(order);
        return "orderDetail";
    }

這時候會返回404，轉到404頁面而不是錯誤頁面

Controller Based Exception Handling

在一個Controller中，經過增長使用註解@ExceptionHandler的方法來處理@RequestMapping方法拋出的異常，注意這種只在單個Controller中有效。這麼作能夠：

1. 發生異常後，改變Response status，通常而言，發生異常返回HTTP STATUS 500.咱們能夠變爲其餘。
2. 發生錯誤後轉到錯誤頁面
3. 能夠爲不一樣異常定義不一樣處理（如不一樣的錯誤頁面，不一樣的Response status）

舉例說明

@Controller
public class ExceptionHandlingController {

  // 咱們標註了@RequestMapping的方法
  ...
  
  //處理異常的方法。
  
  // 把咱們定義的異常轉換爲特定的Http status code
  @ResponseStatus(value=HttpStatus.CONFLICT, reason="Data integrity violation")  // 409
  @ExceptionHandler(DataIntegrityViolationException.class)
  public void conflict() {
    // Nothing to do
  }
  

  // 捕獲到SQLException，DataAccessException異常以後，轉到特定的頁面。
  @ExceptionHandler({SQLException.class,DataAccessException.class})
  public String databaseError() {
    //僅僅轉到錯誤頁面，咱們在頁面上得不到這個Exception的值，要獲得值，咱們能夠經過下面的方法獲得
    return "databaseError";
  }

  // 經過ModelAndView返回頁面，以及往頁面傳相應的值
  @ExceptionHandler(Exception.class)
  public ModelAndView handleError(HttpServletRequest req, Exception exception) {
    logger.error("Request: " + req.getRequestURL() + " raised " + exception);

    ModelAndView mav = new ModelAndView();
    mav.addObject("exception", exception);
    mav.addObject("url", req.getRequestURL());
    mav.setViewName("error");
    return mav;
  }
}

Global Exception Handling

在類上使用 @ControllerAdvice註解，可使得咱們處理整個程序中拋出的異常。而後在類中的方法上使用@ExceptionHandler來定義處理不一樣的異常。
舉例:

class GlobalControllerExceptionHandler {
    @ResponseStatus(HttpStatus.CONFLICT)  // 409
    @ExceptionHandler(DataIntegrityViolationException.class)
    public void handleConflict() {
        // Nothing to do
    }
    
   //轉到特定頁面 。。。。。
}

若是咱們要處理程序中全部的異常能夠這麼作：

@ControllerAdvice
class GlobalDefaultExceptionHandler {
    public static final String DEFAULT_ERROR_VIEW = "error";

    @ExceptionHandler(value = Exception.class)
    public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {
        // If the exception is annotated with @ResponseStatus rethrow it and let
        // the framework handle it - like the OrderNotFoundException example
        // at the start of this post.
        // AnnotationUtils is a Spring Framework utility class.
        if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null) {
            throw e;
        }
        // Otherwise setup and send the user to a default error-view.
        ModelAndView mav = new ModelAndView();
        mav.addObject("exception", e);
        mav.addObject("url", req.getRequestURL());
        mav.setViewName(DEFAULT_ERROR_VIEW);
        return mav;
    }
}

Going Deeper

實現HandlerExceptionResolver接口，SpringMvc可使用他來處理Controller中拋出的異常

public interface HandlerExceptionResolver {
    ModelAndView resolveException(HttpServletRequest request, 
            HttpServletResponse response, Object handler, Exception ex);
}

SpringMvc使用三種默認的HandlerExceptionResolver來處理咱們的異常

1. ExceptionHandlerExceptionResolver：處理匹配@ExceptionHandler定義的異常。
2. ResponseStatusExceptionResolver： 處理添加@ResponseStatus註解的異常
3. DefaultHandlerExceptionResolver：把Spring定義的一些標準異常，轉換爲HTTP STATUS CODE.

Spring內置的SimpleMappingExceptionResolver實現了HandlerExceptionResolver接口，也是咱們常常使用的，XML配置以下：

<bean id="simpleMappingExceptionResolver"
          class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
        <property name="exceptionMappings">
            <map>
                <!-- key爲異常類型，value爲要轉到的頁面 -->
                <entry key="DatabaseException" value="databaseError"/>
                <entry key="InvalidCreditCardException" value="creditCardError"/>
            </map>
        </property>
        <!-- 默認的異常頁面 -->
        <property name="defaultErrorView" value="error"/>
        <!-- 在頁面咱們能夠經過ex拿到異常信息 -->
        <property name="exceptionAttribute" value="ex"/>
        
        <!-- Name of logger to use to log exceptions. Unset by default, so logging disabled -->
         <!-- log異常信息，默認不設置-不記錄異常信息 -->
        <property name="warnLogCategory" value="example.MvcLogger"/>
    </bean>