SpringMVC全局異常處理 【SpringMVC學習07】SpringMVC中的統一異常處理 Spring MVC異常統一處理的三種方式

【SpringMVC學習07】SpringMVC中的統一異常處理

咱們知道,系統中異常包括:編譯時異常和運行時異常RuntimeException,前者經過捕獲異常從而獲取異常信息,後者主要經過規範代碼開發、測試經過手段減小運行時異常的發生。在開發中,不論是dao層、service層仍是controller層,都有可能拋出異常,在springmvc中,能將全部類型的異常處理從各處理過程解耦出來,既保證了相關處理過程的功能較單一,也實現了異常信息的統一處理和維護。這篇博文主要總結一下SpringMVC中如何統一處理異常。html

1. 異常處理思路

  首先來看一下在springmvc中,異常處理的思路(我已盡力畫好看點了,不要噴我~): 
springmvc異常處理 
  如上圖所示,系統的dao、service、controller出現異常都經過throws Exception向上拋出,最後由springmvc前端控制器交由異常處理器進行異常處理。springmvc提供全局異常處理器(一個系統只有一個異常處理器)進行統一異常處理。明白了springmvc中的異常處理機制,下面就開始分析springmvc中的異常處理。前端

2. springmvc中自帶的簡單異常處理器

  springmvc中自帶了一個異常處理器叫SimpleMappingExceptionResolver,該處理器實現了HandlerExceptionResolver 接口,全局異常處理器都須要實現該接口。咱們要使用這個自帶的異常處理器,首先得在springmvc.xml文件中配置該處理器:java

 

複製代碼
<!-- springmvc提供的簡單異常處理器 -->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
     <!-- 定義默認的異常處理頁面 -->
    <property name="defaultErrorView" value="/WEB-INF/jsp/error.jsp"/>
    <!-- 定義異常處理頁面用來獲取異常信息的變量名,也可不定義,默認名爲exception --> 
    <property name="exceptionAttribute" value="ex"/>
    <!-- 定義須要特殊處理的異常,這是重要點 --> 
    <property name="exceptionMappings">
        <props>
            <prop key="ssm.exception.CustomException">/WEB-INF/jsp/custom_error.jsp</prop>
        </props>
        <!-- 還能夠定義其餘的自定義異常 -->
    </property>
</bean>
複製代碼

 

從上面的配置來看,最重要的是要配置特殊處理的異常,這些異常通常都是咱們自定義的,根據實際狀況來自定義的異常,而後也會跳轉到不一樣的錯誤顯示頁面顯示不一樣的錯誤信息。這裏就用一個自定義異常CustomException來講明問題,定義以下:web

複製代碼
//定義一個簡單的異常類
public class CustomException extends Exception {

    //異常信息
    public String message;

    public CustomException(String message) {
        super(message);
        this.message = message;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

}
複製代碼

接下來就是寫測試程序了,仍是使用查詢的例子,以下: 
異常 
  而後咱們在前臺輸入url來測試:http://localhost:8080/SpringMVC_Study/editItems.action?id=11,故意傳一個id爲11,個人數據庫中沒有id爲11的項,因此確定查不到,反正讓它查不到便可。這樣它就會拋出自定義的異常,而後被上面配置的全局異常處理器捕獲並執行,跳轉到咱們指定的頁面,而後顯示一下該商品不存在便可。因此這個流程是很清晰的。 
  從上面的過程可知,使用SimpleMappingExceptionResolver進行異常處理,具備集成簡單、有良好的擴展性(能夠任意增長自定義的異常和異常顯示頁面)、對已有代碼沒有入侵性等優勢,但該方法僅能獲取到異常信息,若在出現異常時,對須要獲取除異常之外的數據的狀況不適用。spring

 

3. 自定義全局異常處理器

 

  全局異常處理器處理思路:數據庫

 

  1. 解析出異常類型
  2. 若是該異常類型是系統自定義的異常,直接取出異常信息,在錯誤頁面展現
  3. 若是該異常類型不是系統自定義的異常,構造一個自定義的異常類型(信息爲「未知錯誤」)

springmvc提供一個HandlerExceptionResolver接口,自定義全局異常處理器必需要實現這個接口,以下:express

 

複製代碼
public class CustomExceptionResolver implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request,
            HttpServletResponse response, Object handler, Exception ex) {

        ex.printStackTrace();
        CustomException customException = null;

        //若是拋出的是系統自定義的異常則直接轉換
        if(ex instanceof CustomException) {
            customException = (CustomException) ex;
        } else {
            //若是拋出的不是系統自定義的異常則從新構造一個未知錯誤異常
            //這裏我就也有CustomException省事了,實際中應該要再定義一個新的異常
            customException = new CustomException("系統未知錯誤");
        }

        //向前臺返回錯誤信息
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("message", customException.getMessage());
        modelAndView.setViewName("/WEB-INF/jsp/error.jsp");

        return modelAndView;
    }
}
複製代碼

 

全局異常處理器中的邏輯很清楚,我就再也不多說了,而後就是在springmvc.xml中配置這個自定義的異常處理器:json

<!-- 自定義的全局異常處理器 
只要實現HandlerExceptionResolver接口就是全局異常處理器-->
<bean class="ssm.exception.CustomExceptionResolver"></bean> 

而後就可使用上面那個測試用例再次測試了。能夠看出在自定義的異常處理器中能獲取致使出現異常的對象,有利於提供更詳細的異常處理信息。通常用這種自定義的全局異常處理器比較多。mvc

4. @ExceptionHandler註解實現異常處理

  還有一種是使用註解的方法,我大概說一下思路,由於這種方法對代碼的入侵性比較大,我不太喜歡用這種方法。 
  首先寫個BaseController類,並在類中使用@ExceptionHandler註解聲明異常處理的方法,如:app

 

複製代碼
public class BaseController { 
    @ExceptionHandler  
    public String exp(HttpServletRequest request, Exception ex) { 
    //異常處理
    //......
    }
}
複製代碼

 

而後將全部須要異常處理的Controller都繼承這個BaseController,雖然從執行來看,不須要配置什麼東西,可是代碼有侵入性,須要異常處理的Controller都要繼承它才行。 
  關於springmvc的異常處理,就總結這麼多吧。 

 

早年同學始相知,三載瞬逝情卻萌。年少不知愁滋味,猶讀紅豆生南國。別離方知相思苦,心田紅豆根以生。
 

Spring MVC異常統一處理的三種方式

 

正文

Spring 統一異常處理有 3 種方式,分別爲:

  1. 使用 @ ExceptionHandler 註解
  2. 實現 HandlerExceptionResolver 接口
  3. 使用 @controlleradvice 註解

使用 @ ExceptionHandler 註解

使用該註解有一個很差的地方就是:進行異常處理的方法必須與出錯的方法在同一個Controller裏面。使用以下:

複製代碼
 1 @Controller      
 2 public class GlobalController {               
 3 
 4    /**    
 5      * 用於處理異常的    
 6      * @return    
 7      */      
 8     @ExceptionHandler({MyException.class})       
 9     public String exception(MyException e) {       
10         System.out.println(e.getMessage());       
11         e.printStackTrace();       
12         return "exception";       
13     }       
14 
15     @RequestMapping("test")       
16     public void test() {       
17         throw new MyException("出錯了!");       
18     }                    
19 }     
複製代碼

能夠看到,這種方式最大的缺陷就是不能全局控制異常。每一個類都要寫一遍。

實現 HandlerExceptionResolver 接口

這種方式能夠進行全局的異常控制。例如:

複製代碼
 1 @Component  
 2 public class ExceptionTest implements HandlerExceptionResolver{  
 3 
 4     /**  
 5      * TODO 簡單描述該方法的實現功能(可選).  
 6      * @see org.springframework.web.servlet.HandlerExceptionResolver#resolveException(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.lang.Object, java.lang.Exception)  
 7      */   
 8     public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler,  
 9             Exception ex) {  
10         System.out.println("This is exception handler method!");  
11         return null;  
12     }  
13 }   
複製代碼

使用 @ControllerAdvice+ @ ExceptionHandler 註解

上文說到 @ ExceptionHandler 須要進行異常處理的方法必須與出錯的方法在同一個Controller裏面。那麼當代碼加入了 @ControllerAdvice,則不須要必須在同一個 controller 中了。這也是 Spring 3.2 帶來的新特性。從名字上能夠看出大致意思是控制器加強。 也就是說,@controlleradvice + @ ExceptionHandler 也能夠實現全局的異常捕捉。

請確保此WebExceptionHandle 類能被掃描到並裝載進 Spring 容器中。

複製代碼
 1 @ControllerAdvice
 2 @ResponseBody
 3 public class WebExceptionHandle {
 4     private static Logger logger = LoggerFactory.getLogger(WebExceptionHandle.class);
 5     /**
 6      * 400 - Bad Request
 7      */
 8     @ResponseStatus(HttpStatus.BAD_REQUEST)
 9     @ExceptionHandler(HttpMessageNotReadableException.class)
10     public ServiceResponse handleHttpMessageNotReadableException(HttpMessageNotReadableException e) {
11         logger.error("參數解析失敗", e);
12         return ServiceResponseHandle.failed("could_not_read_json");
13     }
14     
15     /**
16      * 405 - Method Not Allowed
17      */
18     @ResponseStatus(HttpStatus.METHOD_NOT_ALLOWED)
19     @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
20     public ServiceResponse handleHttpRequestMethodNotSupportedException(HttpRequestMethodNotSupportedException e) {
21         logger.error("不支持當前請求方法", e);
22         return ServiceResponseHandle.failed("request_method_not_supported");
23     }
24 
25     /**
26      * 415 - Unsupported Media Type
27      */
28     @ResponseStatus(HttpStatus.UNSUPPORTED_MEDIA_TYPE)
29     @ExceptionHandler(HttpMediaTypeNotSupportedException.class)
30     public ServiceResponse handleHttpMediaTypeNotSupportedException(Exception e) {
31         logger.error("不支持當前媒體類型", e);
32         return ServiceResponseHandle.failed("content_type_not_supported");
33     }
34 
35     /**
36      * 500 - Internal Server Error
37      */
38     @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
39     @ExceptionHandler(Exception.class)
40     public ServiceResponse handleException(Exception e) {
41         if (e instanceof BusinessException){
42             return ServiceResponseHandle.failed("BUSINESS_ERROR", e.getMessage());
43         }
44         
45         logger.error("服務運行異常", e);
46         e.printStackTrace();
47         return ServiceResponseHandle.failed("server_error");
48     }
49 } 
複製代碼

若是 @ExceptionHandler 註解中未聲明要處理的異常類型,則默認爲參數列表中的異常類型。因此還能夠寫成這樣:

複製代碼
@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler()
    @ResponseBody
    String handleException(Exception e){
        return "Exception Deal! " + e.getMessage();
    }
}
複製代碼

 

參數對象就是 Controller 層拋出的異常對象!

 

繼承 ResponseEntityExceptionHandler 類來實現針對 Rest 接口 的全局異常捕獲,而且能夠返回自定義格式:

複製代碼
 1 @Slf4j
 2 @ControllerAdvice
 3 public class ExceptionHandlerBean  extends ResponseEntityExceptionHandler {
 4 
 5     /**
 6      * 數據找不到異常
 7      * @param ex
 8      * @param request
 9      * @return
10      * @throws IOException
11      */
12     @ExceptionHandler({DataNotFoundException.class})
13     public ResponseEntity<Object> handleDataNotFoundException(RuntimeException ex, WebRequest request) throws IOException {
14         return getResponseEntity(ex,request,ReturnStatusCode.DataNotFoundException);
15     }
16 
17     /**
18      * 根據各類異常構建 ResponseEntity 實體. 服務於以上各類異常
19      * @param ex
20      * @param request
21      * @param specificException
22      * @return
23      */
24     private ResponseEntity<Object> getResponseEntity(RuntimeException ex, WebRequest request, ReturnStatusCode specificException) {
25 
26         ReturnTemplate returnTemplate = new ReturnTemplate();
27         returnTemplate.setStatusCode(specificException);
28         returnTemplate.setErrorMsg(ex.getMessage());
29 
30         return handleExceptionInternal(ex, returnTemplate,
31                 new HttpHeaders(), HttpStatus.OK, request);
32     }
33 
34 } 
複製代碼

以上就是 Spring 處理程序統一異常的三種方式。

 

@ControllerAdvice + @ExceptionHandler 全局處理 Controller 層異常

 

零、前言
對於與數據庫相關的 Spring MVC 項目,咱們一般會把 事務 配置在 Service層,當數據庫操做失敗時讓 Service 層拋出運行時異常,Spring 事物管理器就會進行回滾。

 

如此一來,咱們的 Controller 層就不得不進行 try-catch Service 層的異常,不然會返回一些不友好的錯誤信息到客戶端。可是,Controller 層每一個方法體都寫一些模板化的 try-catch 的代碼,很難看也難維護,特別是還須要對 Service 層的不一樣異常進行不一樣處理的時候。例如如下 Controller 方法代碼(很是難看且冗餘):

 

/**
* 手動處理 Service 層異常和數據校驗異常的示例
* @param dog
* @param errors
* @return
*/
@PostMapping(value = "")
AppResponse add(@Validated(Add.class) @RequestBody Dog dog, Errors errors){
AppResponse resp = new AppResponse();
try {
// 數據校驗
BSUtil.controllerValidate(errors);

 

// 執行業務
Dog newDog = dogService.save(dog);

 

// 返回數據
resp.setData(newDog);

 

}catch (BusinessException e){
LOGGER.error(e.getMessage(), e);
resp.setFail(e.getMessage());
}catch (Exception e){
LOGGER.error(e.getMessage(), e);
resp.setFail("操做失敗!");
}
return resp;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
本文講解使用 @ControllerAdvice + @ExceptionHandler 進行全局的 Controller 層異常處理,只要設計得當,就不再用在 Controller 層進行 try-catch 了!並且,@Validated 校驗器註解的異常,也能夠一塊兒處理,無需手動判斷綁定校驗結果 BindingResult/Errors 了!

 

1、優缺點
優勢:將 Controller 層的異常和數據校驗的異常進行統一處理,減小模板代碼,減小編碼量,提高擴展性和可維護性。
缺點:只能處理 Controller 層未捕獲(往外拋)的異常,對於 Interceptor(攔截器)層的異常,Spring 框架層的異常,就無能爲力了。
2、基本使用示例
2.1 @ControllerAdvice 註解定義全局異常處理類
@ControllerAdvice
public class GlobalExceptionHandler {
}
1
2
3
請確保此 GlobalExceptionHandler 類能被掃描到並裝載進 Spring 容器中。

 

2.2 @ExceptionHandler 註解聲明異常處理方法
@ControllerAdvice
public class GlobalExceptionHandler {

 

@ExceptionHandler(Exception.class)
@ResponseBody
String handleException(){
return "Exception Deal!";
}
}
1
2
3
4
5
6
7
8
9
方法 handleException() 就會處理全部 Controller 層拋出的 Exception 及其子類的異常,這是最基本的用法了。

 

被 @ExceptionHandler 註解的方法的參數列表裏,還能夠聲明不少種類型的參數,詳見文檔。其原型以下:

 

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ExceptionHandler {

 

/**
* Exceptions handled by the annotated method. If empty, will default to any
* exceptions listed in the method argument list.
*/
Class<? extends Throwable>[] value() default {};

 

}
1
2
3
4
5
6
7
8
9
10
11
12
若是 @ExceptionHandler 註解中未聲明要處理的異常類型,則默認爲參數列表中的異常類型。因此上面的寫法,還能夠寫成這樣:

 

@ControllerAdvice
public class GlobalExceptionHandler {

 

@ExceptionHandler()
@ResponseBody
String handleException(Exception e){
return "Exception Deal! " + e.getMessage();
}
}
1
2
3
4
5
6
7
8
9
參數對象就是 Controller 層拋出的異常對象!

 

3、處理 Service 層上拋的業務異常
有時咱們會在複雜的帶有數據庫事務的業務中,當出現不和預期的數據時,直接拋出封裝後的業務級運行時異常,進行數據庫事務回滾,並但願該異常信息能被返回顯示給用戶。

 

3.1 代碼示例
封裝的業務異常類:

 

public class BusinessException extends RuntimeException {

 

public BusinessException(String message){
super(message);
}
}
1
2
3
4
5
6
Service 實現類:

 

@Service
public class DogService {

 

@Transactional
public Dog update(Dog dog){

 

// some database options

 

// 模擬狗狗新名字與其餘狗狗的名字衝突
BSUtil.isTrue(false, "狗狗名字已經被使用了...");

 

// update database dog info

 

return dog;
}

 

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
其中輔助工具類 BSUtil

 

public static void isTrue(boolean expression, String error){
if(!expression) {
throw new BusinessException(error);
}
}
1
2
3
4
5
那麼,咱們應該在 GlobalExceptionHandler 類中聲明該業務異常類,並進行相應的處理,而後返回給用戶。更貼近真實項目的代碼,應該長這樣子:

 

/**
* Created by kinginblue on 2017/4/10.
* @ControllerAdvice + @ExceptionHandler 實現全局的 Controller 層的異常處理
*/
@ControllerAdvice
public class GlobalExceptionHandler {

 

private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);

 

/**
* 處理全部不可知的異常
* @param e
* @return
*/
@ExceptionHandler(Exception.class)
@ResponseBody
AppResponse handleException(Exception e){
LOGGER.error(e.getMessage(), e);

 

AppResponse response = new AppResponse();
response.setFail("操做失敗!");
return response;
}

 

/**
* 處理全部業務異常
* @param e
* @return
*/
@ExceptionHandler(BusinessException.class)
@ResponseBody
AppResponse handleBusinessException(BusinessException e){
LOGGER.error(e.getMessage(), e);

 

AppResponse response = new AppResponse();
response.setFail(e.getMessage());
return response;
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
Controller 層的代碼,就不須要進行異常處理了:

 

@RestController
@RequestMapping(value = "/dogs", consumes = {MediaType.APPLICATION_JSON_UTF8_VALUE})
public class DogController {

 

@Autowired
private DogService dogService;

 

@PatchMapping(value = "")
Dog update(@Validated(Update.class) @RequestBody Dog dog){
return dogService.update(dog);
}
}
1
2
3
4
5
6
7
8
9
10
11
12
3.2 代碼說明
Logger 進行全部的異常日誌記錄。

 

@ExceptionHandler(BusinessException.class) 聲明瞭對 BusinessException 業務異常的處理,並獲取該業務異常中的錯誤提示,構造後返回給客戶端。

 

@ExceptionHandler(Exception.class) 聲明瞭對 Exception 異常的處理,起到兜底做用,無論 Controller 層執行的代碼出現了什麼未能考慮到的異常,都返回統一的錯誤提示給客戶端。

 

備註:以上 GlobalExceptionHandler 只是返回 Json 給客戶端,更大的發揮空間須要按需求狀況來作。

 

4、處理 Controller 數據綁定、數據校驗的異常
在 Dog 類中的字段上的註解數據校驗規則:

 

@Data
public class Dog {

 

@NotNull(message = "{Dog.id.non}", groups = {Update.class})
@Min(value = 1, message = "{Dog.age.lt1}", groups = {Update.class})
private Long id;

 

@NotBlank(message = "{Dog.name.non}", groups = {Add.class, Update.class})
private String name;

 

@Min(value = 1, message = "{Dog.age.lt1}", groups = {Add.class, Update.class})
private Integer age;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
說明:@NotNull、@Min、@NotBlank 這些註解的使用方法,不在本文範圍內。若是不熟悉,請查找資料學習便可。

 

其餘說明:
@Data 註解是 **Lombok** 項目的註解,可使咱們不用再在代碼裏手動加 getter & setter。
在 Eclipse 和 IntelliJ IDEA 中使用時,還須要安裝相關插件,這個步驟自行Google/Baidu 吧!
1
2
3
4
5
Lombok 使用方法見:Java奇淫巧技之Lombok

 

SpringMVC 中對於 RESTFUL 的 Json 接口來講,數據綁定和校驗,是這樣的:

 

/**
* 使用 GlobalExceptionHandler 全局處理 Controller 層異常的示例
* @param dog
* @return
*/
@PatchMapping(value = "")
AppResponse update(@Validated(Update.class) @RequestBody Dog dog){
AppResponse resp = new AppResponse();

 

// 執行業務
Dog newDog = dogService.update(dog);

 

// 返回數據
resp.setData(newDog);

 

return resp;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
使用 @Validated + @RequestBody 註解實現。

 

當使用了 @Validated + @RequestBody 註解可是沒有在綁定的數據對象後面跟上 Errors 類型的參數聲明的話,Spring MVC 框架會拋出 MethodArgumentNotValidException 異常。

 

因此,在 GlobalExceptionHandler 中加上對 MethodArgumentNotValidException 異常的聲明和處理,就能夠全局處理數據校驗的異常了!加完後的代碼以下:

 

/**
* Created by kinginblue on 2017/4/10.
* @ControllerAdvice + @ExceptionHandler 實現全局的 Controller 層的異常處理
*/
@ControllerAdvice
public class GlobalExceptionHandler {

 

private static final Logger LOGGER = LoggerFactory.getLogger(GlobalExceptionHandler.class);

 

/**
* 處理全部不可知的異常
* @param e
* @return
*/
@ExceptionHandler(Exception.class)
@ResponseBody
AppResponse handleException(Exception e){
LOGGER.error(e.getMessage(), e);

 

AppResponse response = new AppResponse();
response.setFail("操做失敗!");
return response;
}

 

/**
* 處理全部業務異常
* @param e
* @return
*/
@ExceptionHandler(BusinessException.class)
@ResponseBody
AppResponse handleBusinessException(BusinessException e){
LOGGER.error(e.getMessage(), e);

 

AppResponse response = new AppResponse();
response.setFail(e.getMessage());
return response;
}

 

/**
* 處理全部接口數據驗證異常
* @param e
* @return
*/
@ExceptionHandler(MethodArgumentNotValidException.class)
@ResponseBody
AppResponse handleMethodArgumentNotValidException(MethodArgumentNotValidException e){
LOGGER.error(e.getMessage(), e);

 

AppResponse response = new AppResponse();
response.setFail(e.getBindingResult().getAllErrors().get(0).getDefaultMessage());
return response;
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
注意到了嗎,全部的 Controller 層的異常的日誌記錄,都是在這個 GlobalExceptionHandler 中進行記錄。也就是說,Controller 層也不須要在手動記錄錯誤日誌了。

 

5、總結
本文主要講 @ControllerAdvice + @ExceptionHandler 組合進行的 Controller 層上拋的異常全局統一處理。

 

其實,被 @ExceptionHandler 註解的方法還能夠聲明不少參數,詳見文檔。

 

@ControllerAdvice 也還能夠結合 @InitBinder、@ModelAttribute 等註解一塊兒使用,應用在全部被 @RequestMapping 註解的方法上,詳見搜索引擎。

 

6、附錄本文示例代碼已放到 Github。

相關文章
相關標籤/搜索