我們?cè)谧鯳eb應(yīng)用的時(shí)候,請(qǐng)求處理過(guò)程中發(fā)生錯(cuò)誤是非常常見(jiàn)的情況。Spring Boot提供了一個(gè)默認(rèn)的映射:/error,當(dāng)處理中拋出異常之后,會(huì)轉(zhuǎn)到該請(qǐng)求中處理,并且該請(qǐng)求有一個(gè)全局的錯(cuò)誤頁(yè)面用來(lái)展示異常內(nèi)容。 選擇一個(gè)之前實(shí)現(xiàn)過(guò)的Web應(yīng)用(Chapter3-1-2)為基礎(chǔ),啟動(dòng)該應(yīng)用,訪(fǎng)問(wèn)一個(gè)不存在的URL,或是修改處理內(nèi)容,直接拋出異常,如: - @RequestMapping("/hello")
- public String hello() throws Exception {
- throw new Exception("發(fā)生錯(cuò)誤");
- }
復(fù)制代碼此時(shí),可以看到類(lèi)似下面的報(bào)錯(cuò)頁(yè)面,該頁(yè)面就是Spring Boot提供的默認(rèn)error映射頁(yè)面。 alt=默認(rèn)的錯(cuò)誤頁(yè)面 統(tǒng)一異常處理雖然,Spring Boot中實(shí)現(xiàn)了默認(rèn)的error映射,但是在實(shí)際應(yīng)用中,上面你的錯(cuò)誤頁(yè)面對(duì)用戶(hù)來(lái)說(shuō)并不夠友好,我們通常需要去實(shí)現(xiàn)我們自己的異常提示。 下面我們以之前的Web應(yīng)用例子為基礎(chǔ)(Chapter3-1-2),進(jìn)行統(tǒng)一異常處理的改造。 - 創(chuàng)建全局異常處理類(lèi):通過(guò)使用@ControllerAdvice定義統(tǒng)一的異常處理類(lèi),而不是在每個(gè)Controller中逐個(gè)定義。@ExceptionHandler用來(lái)定義函數(shù)針對(duì)的異常類(lèi)型,最后將Exception對(duì)象和請(qǐng)求URL映射到error.html中
- @ControllerAdvice
- class GlobalExceptionHandler {
-
- public static final String DEFAULT_ERROR_VIEW = "error";
-
- @ExceptionHandler(value = Exception.class)
- public ModelAndView defaultErrorHandler(HttpServletRequest req, Exception e) throws Exception {
- ModelAndView mav = new ModelAndView();
- mav.addObject("exception", e);
- mav.addObject("url", req.getRequestURL());
- mav.setViewName(DEFAULT_ERROR_VIEW);
- return mav;
- }
-
- }
復(fù)制代碼 實(shí)現(xiàn)error.html頁(yè)面展示:在templates目錄下創(chuàng)建error.html,將請(qǐng)求的URL和Exception對(duì)象的message輸出。- <!DOCTYPE html>
- <html>
- <head lang="en">
- <meta charset="UTF-8" />
- <title>統(tǒng)一異常處理</title>
- </head>
- <body>
- <h1>Error Handler</h1>
- <div th:text="${url}"></div>
- <div th:text="${exception.message}"></div>
- </body>
- </html>
復(fù)制代碼啟動(dòng)該應(yīng)用,訪(fǎng)問(wèn):http://localhost:8080/hello,可以看到如下錯(cuò)誤提示頁(yè)面。 alt=自定義的錯(cuò)誤頁(yè)面
通過(guò)實(shí)現(xiàn)上述內(nèi)容之后,我們只需要在Controller中拋出Exception,當(dāng)然我們可能會(huì)有多種不同的Exception。然后在@ControllerAdvice類(lèi)中,根據(jù)拋出的具體Exception類(lèi)型匹配@ExceptionHandler中配置的異常類(lèi)型來(lái)匹配錯(cuò)誤映射和處理。
|