SpringBoot第七集:異常處理與整合JSR303校驗(2020最新最易懂)
SpringBoot第七集:異常處理與整合JSR303校驗(2020最新最易懂)
一.SpringBoot全域性異常
先講下什麼是全域性異常處理器?
全域性異常處理器就是把整個系統的異常統一自動處理,程式設計師可以做到不用寫try... catch。SpringBoot內建有預設全域性異常處理器。
Spring Boot對異常的處理有一套預設的機制,BasicErrorController處理預設異常轉發的或這error請求:當應用中產生異常時,當從瀏覽器位址列中訪問應用介面時,SpringBoot會獲取請求頭中資料,如果請求頭中的accept
包含text/html
資訊,產生異常時,Spring Boot會通過ModelAndView模型
accept
不包含text/html時
,Spring Boot則以JSON的格式返回異常資訊。
例如:訪問一個未知介面資源(或後臺介面定義10/0的錯誤,響應的HTML結果如下)
例如:利用Postman測試工具,訪問未知資源測試:(可以嘗試使用其他外掛工具:使用Chrome外掛Restlet Client)
1.全域性異常處理機制原始碼解析
BasicErrorController原始碼擷取如下:
@RequestMapping("${server.error.path:${error.path:/error}}")請求的異常頁面地址為/error/下面的資源
當沒有自定義異常頁面時,預設按下方原始碼執行構建HTML或JSON響應給前臺。
1 @Controller 2 @RequestMapping("${server.error.path:${error.path:/error}}") 3 public class BasicErrorController extends AbstractErrorController { 4 /** 5 * 錯誤資訊處理器方法errorHtml,設定了請求頭Accpet值型別,如果包含text/html,即執行該方法 6 * @param request 請求物件 7 *@param response 響應物件 8 * @return 9 * MediaType.TEXT_HTML_VALUE的實際值就是一個字串“text/html” 10 */ 11 @RequestMapping(produces = MediaType.TEXT_HTML_VALUE) 12 public ModelAndView errorHtml(HttpServletRequest request, HttpServletResponse response) { 13 // 獲取狀態碼 14 HttpStatus status = getStatus(request); 15 Map<String, Object> model = Collections 16 .unmodifiableMap(getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.TEXT_HTML))); 17 // 響應狀態碼描述 18 response.setStatus(status.value()); 19 // 建立檢視模型物件 20 ModelAndView modelAndView = resolveErrorView(request, response, status, model); 21 return (modelAndView != null) ? modelAndView : new ModelAndView("error", model); 22 } 23 24 /** 25 * 錯誤資訊處理器方法error方法,設定了請求頭Accpet值型別,即沒有包含text/html執行該方法 26 * @param request 請求物件 27 * @param response 響應物件 28 */ 29 @RequestMapping 30 public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) { 31 HttpStatus status = getStatus(request); 32 if (status == HttpStatus.NO_CONTENT) { 33 return new ResponseEntity<>(status); 34 } 35 Map<String, Object> body = getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.ALL)); 36 return new ResponseEntity<>(body, status); 37 } 38 39 }
我們可以自定義友好的異常頁面。但必須是放在資源/error/目錄下,資源目錄存放預設地址可選
src/main/resources/static/,src/main/resources/resources/,src/main/resources/public/,src/main/templates/
說明:前三者是靜態資源目錄,頁面我們使用模板引擎,因此如果需要自定義錯誤頁面,那麼需要放在src/main/templates/error目錄下(當然所有的前提是,沒有更改預設配置,SpringBoot預設載入其中的錯誤頁面),且錯誤頁面命名必須以狀態碼方式。SpringBoot預設錯誤檢視解析器DefaultErrorViewResolver原始碼解析如下:
1 public class DefaultErrorViewResolver implements ErrorViewResolver, Ordered { 2 3 private static final Map<Series, String> SERIES_VIEWS; 4 5 // 靜態初始化錯誤狀態型別:4xx 或 5xx 6 static { 7 Map<Series, String> views = new EnumMap<>(Series.class); 8 views.put(Series.CLIENT_ERROR, "4xx"); 9 views.put(Series.SERVER_ERROR, "5xx"); 10 SERIES_VIEWS = Collections.unmodifiableMap(views); 11 } 12 13 14 // 解析錯誤檢視 15 @Override 16 public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) { 17 // 獲取錯誤狀態碼例如:404,轉為字串呼叫方法resolve(解析方法) 18 ModelAndView modelAndView = resolve(String.valueOf(status.value()), model); 19 if (modelAndView == null && SERIES_VIEWS.containsKey(status.series())) { 20 modelAndView = resolve(SERIES_VIEWS.get(status.series()), model); 21 } 22 return modelAndView; 23 } 24 25 // 解析處理方法 26 private ModelAndView resolve(String viewName, Map<String, Object> model) { 27 // 拼接錯誤檢視訪問字首:error/500 28 String errorViewName = "error/" + viewName; 29 TemplateAvailabilityProvider provider = this.templateAvailabilityProviders.getProvider(errorViewName, 30 this.applicationContext); 31 if (provider != null) { 32 return new ModelAndView(errorViewName, model); 33 } 34 // 呼叫解析資源:傳入error/500 35 return resolveResource(errorViewName, model); 36 } 37 38 // 解析資源 39 private ModelAndView resolveResource(String viewName, Map<String, Object> model) { 40 for (String location : this.resourceProperties.getStaticLocations()) { 41 try { 42 // 獲取資解析 43 Resource resource = this.applicationContext.getResource(location); 44 // 建立解析檔案為:error/500.html 45 resource = resource.createRelative(viewName + ".html"); 46 if (resource.exists()) { 47 return new ModelAndView(new HtmlResourceView(resource), model); 48 } 49 } 50 catch (Exception ex) { 51 } 52 } 53 return null; 54 } 55 }
關於模板引擎的整合,參考第九集:整合JSP和模板引擎
2.自定義異常頁面
1.在src/main/templates/error目錄下新建錯誤頁面:例如:404.html
2.測試訪問。
1 <!DOCTYPE html> 2 <html xmlns:th="http://www.thymeleaf.org"> <!-- Thymeleaf模板約束 --> 3 <head> 4 <meta charset="UTF-8"> 5 <title>Insert title here</title> 6 </head> 7 <body> 8 自定義404友好錯誤頁面!<br> 9 對不起,你訪問的資料被外星人盜竊了…… 10 </body> 11 </html>
3.自定義異常資訊
除了可以可以自定義友好異常頁面(HTML)外,我們也可以自定義異常處理資訊,改變預設的客戶端訪問介面產生的異常資訊。
由於工作中都是前後端分離開發模式,所以幾乎沒有直接返回資源頁的需求,一般上都是返回固定的響應格式JSON,如respCode
、respMsg
、data等
,前端通過判斷respCode
的值進行業務判斷,是彈窗還是跳轉頁面。
- 編寫自定義異常類,封裝異常資訊(便於JSON轉換)
1 @Data 2 @NoArgsConstructor 3 @AllArgsConstructor 4 public class ExceptionResponseResult{ 5 @DateTimeFormat(pattern = "yyyy-MM-dd hh:mm:ss") // 日期格式化 6 private Date timestamp;// 時間 7 private int respCode;// 狀態碼 8 private String respMsg;// 給使用者看的描述資訊 9 private String message;// 實際錯誤異常資訊 10 private String exceptionName;// 實際錯誤異常名字 11 private String path;// URI 12 private Object data;// 資料 13 }
- 編寫全域性異常處理器
a,編寫一個全域性異常處理器類
b,在類上添加註解@ControllerAdvice
@ControllerAdvice:作用:對所有控制器中,被@RequestMapping註解標註的方法,進行增強(也可以直接使用@RestControllerAdvice)
c,自定義異常處理方法,並使用註解@ExceptionHandler(Throwable.class),@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR),@ResponseBody
@ExceptionHandler(Throwable.class):異常處理器註解,通常配合@ControllerAdvice註解使用。作用是:對指定或滿足的異常型別實施攔截處理
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR):用於指定響應狀態碼的,HttpStatus是Spring內建的一個狀態碼列舉類,內定了詳細的狀態碼及描。
@ResponseBody:作用:將響應的結果轉為JSON資訊。如果使用了@RestControllerAdvice則方法無需使用@ResponseBody註解
1 // @ControllerAdvice 2 @RestControllerAdvice // 控制器類增強:可以對Controller中所有使用@RequestMapping註解的方法增強 3 public class GlobalExceptionHandler { 4 5 // 該註解是異常處理器註解,可以對指定異常型別處理,執行註解標註的方法(只要發生指定異常都會被攔截) 6 @ExceptionHandler(Throwable.class) 7 // 該註解用於指定異常處理方法執行後響應頁面的HTTP狀態碼,HttpStatus是Spring內建的一個狀態碼列舉類,內定了詳細的狀態碼及描述,當前獲取的是500 8 @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)// 響應500 9 public Object exceptonResponse(Exception ex,HttpServletRequest request) { 10 ExceptionResponseResult resultError = new ExceptionResponseResult(); 11 resultError.setTimestamp(new Date());// 設定異常發生時間 12 resultError.setRespCode(0);// 可以選擇自定義列舉類,定義狀態碼 13 resultError.setRespMsg("伺服器重新整理異常,請稍後。。。");// 使用者看到的異常資訊 14 resultError.setMessage(ex.getMessage());// 實際發生的異常資訊 15 resultError.setExceptionName(ex.getClass().getName());// 實際異常的名字 16 resultError.setPath(request.getRequestURI());// 異常RUI 17 return resultError; 18 } 19 20 }
- 編寫控制器Controller定義後臺錯誤
1 @Controller 2 public class HtmlController { 3 4 @RequestMapping("/indexHtml") 5 public String indexHtml(Model model) { 6 model.addAttribute("url","XSGE個人網站:http://www.xsge123.com"); 7 System.out.println("測試"+(10/0)); 8 return "indexHtml"; 9 } 10 }
- 使用Postman測試訪問
頁面訪問測試結果:正常響應,但狀態碼是500
- 異常處理優化
在異常處理器方法中,判斷異常型別,定義更加細節的異常響應內容。
1 // 該註解是異常處理器註解,可以對指定異常型別處理,執行註解標註的方法(只要發生指定異常都會被攔截) 2 @ExceptionHandler(Throwable.class) 3 // 該註解用於指定異常處理方法執行後響應頁面的HTTP狀態碼,HttpStatus是Spring內建的一個狀態碼列舉類,內定了詳細的狀態碼及描述,當前獲取的是500 4 @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)// 響應500 5 public Object exceptonResponse(Exception ex,HttpServletRequest request) { 6 ExceptionResponseResult resultError = new ExceptionResponseResult(); 7 if (ex instanceof NullPointerException) {// 如果捕獲的異常為控空指標異常 8 // ****設定異常資訊***** 9 } else if (ex instanceof ArithmeticException) { 10 // ****設定異常資訊***** 11 }// ***** 12 return resultError; 13 }
二.JSR-303資料校驗
在任何時候,當你要處理一個應用程式的業務邏輯,資料校驗是你必須要考慮和麵對的事情。然後僅僅前端頁面的校驗就能保證安全了嗎?小朋友還是年輕,基礎的前端攻擊技術網上很多,所以,僅僅頁面資料校驗是不夠的。JSR是Java Specification Requests的縮寫,意思是Java 規範提案。是指向JCP(Java Community Process)提出新增一個標準化技術規範的正式請求。
JSR-303 是JAVA EE 6 中的一項子規範,叫做Bean Validation,Hibernate Validator 是 Bean Validation 的參考實現 。 Hibernate Validator 提供了 JSR 303 規範中所有內建 constraint(約束) 的實現,除此之外還有一些附加的 constraint(約束)。(注意:此實現與 Hibernate ORM 沒有任何關係)。
校驗規則及使用方法:關注博主SSM整合之資料校驗!!!(目前資料已備沒時間寫,敬請期待!)等不及的可以查閱Githup官網,檢視說明文件。