SpringBoot如何優(yōu)雅的處理全局異常
前言
本篇文章主要介紹的是SpringBoot項目進行全局異常的處理。
SpringBoot全局異常準備
說明：如果想直接獲取工程那么可以直接跳到底部，通過鏈接下載工程代碼。
開發(fā)準備
環(huán)境要求
JDK：1.8
SpringBoot：1.5.17.RELEASE
首先還是Maven的相關依賴:
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <java.version>1.8</java.version> <maven.compiler.source>1.8</maven.compiler.source> <maven.compiler.target>1.8</maven.compiler.target> </properties> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.17.RELEASE</version> <relativePath /> </parent> <dependencies> <!-- Spring Boot Web 依賴 核心 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Spring Boot Test 依賴 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.41</version> </dependency> </dependencies>
配置文件這塊基本不需要更改，全局異常的處理只需在代碼中實現(xiàn)即可。
代碼編寫
SpringBoot的項目已經對有一定的異常處理了，但是對于我們開發(fā)者而言可能就不太合適了，因此我們需要對這些異常進行統(tǒng)一的捕獲并處理。SpringBoot中有一個ControllerAdvice的注解，使用該注解表示開啟了全局異常的捕獲，我們只需在自定義一個方法使用ExceptionHandler注解然后定義捕獲異常的類型即可對這些捕獲的異常進行統(tǒng)一的處理。
我們根據(jù)下面的這個示例來看該注解是如何使用吧。
示例代碼:
@ControllerAdvice
public class MyExceptionHandler {
@ExceptionHandler(value =Exception.class)
public String exceptionHandler(Exception e){
System.out.println("未知異常！原因是:"+e);
return e.getMessage();
}
}
上述的示例中，我們對捕獲的異常進行簡單的二次處理，返回異常的信息，雖然這種能夠讓我們知道異常的原因，但是在很多的情況下來說，可能還是不夠人性化，不符合我們的要求。
那么我們這里可以通過自定義的異常類以及枚舉類來實現(xiàn)我們想要的那種數(shù)據(jù)吧。
自定義基礎接口類
首先定義一個基礎的接口類，自定義的錯誤描述枚舉類需實現(xiàn)該接口。
代碼如下:
public interface BaseErrorInfoInterface {
/** 錯誤碼*/
String getResultCode();
/** 錯誤描述*/
String getResultMsg();
}
自定義枚舉類
然后我們這里在自定義一個枚舉類，并實現(xiàn)該接口。
代碼如下:
public enum CommonEnum implements BaseErrorInfoInterface {
// 數(shù)據(jù)操作錯誤定義
SUCCESS("200", "成功!"),
BODY_NOT_MATCH("400","請求的數(shù)據(jù)格式不符!"),
SIGNATURE_NOT_MATCH("401","請求的數(shù)字簽名不匹配!"),
NOT_FOUND("404", "未找到該資源!"),
INTERNAL_SERVER_ERROR("500", "服務器內部錯誤!"),
SERVER_BUSY("503","服務器正忙，請稍后再試!")
;
/** 錯誤碼 */
private String resultCode;
/** 錯誤描述 */
private String resultMsg;
CommonEnum(String resultCode, String resultMsg) {
this.resultCode = resultCode;
this.resultMsg = resultMsg;
}
@Override
public String getResultCode() {
return resultCode;
}
@Override
public String getResultMsg() {
return resultMsg;
}
}
自定義異常類
然后我們在來自定義一個異常類，用于處理我們發(fā)生的業(yè)務異常。
代碼如下:
public class BizException extends RuntimeException {
private static final long serialVersionUID = 1L;
/**
* 錯誤碼
*/
protected String errorCode;
/**
* 錯誤信息
*/
protected String errorMsg;
public BizException() {
super();
}
public BizException(BaseErrorInfoInterface errorInfoInterface) {
super(errorInfoInterface.getResultCode());
this.errorCode = errorInfoInterface.getResultCode();
this.errorMsg = errorInfoInterface.getResultMsg();
}
public BizException(BaseErrorInfoInterface errorInfoInterface, Throwable cause) {
super(errorInfoInterface.getResultCode(), cause);
this.errorCode = errorInfoInterface.getResultCode();
this.errorMsg = errorInfoInterface.getResultMsg();
}
public BizException(String errorMsg) {
super(errorMsg);
this.errorMsg = errorMsg;
}
public BizException(String errorCode, String errorMsg) {
super(errorCode);
this.errorCode = errorCode;
this.errorMsg = errorMsg;
}
public BizException(String errorCode, String errorMsg, Throwable cause) {
super(errorCode, cause);
this.errorCode = errorCode;
this.errorMsg = errorMsg;
}
public String getErrorCode() {
return errorCode;
}
public void setErrorCode(String errorCode) {
this.errorCode = errorCode;
}
public String getErrorMsg() {
return errorMsg;
}
public void setErrorMsg(String errorMsg) {
this.errorMsg = errorMsg;
}
public String getMessage() {
return errorMsg;
}
@Override
public Throwable fillInStackTrace() {
return this;
}
}
自定義數(shù)據(jù)格式
順便這里我們定義一下數(shù)據(jù)的傳輸格式。
代碼如下:
public class ResultBody {
/**
* 響應代碼
*/
private String code;
/**
* 響應消息
*/
private String message;
/**
* 響應結果
*/
private Object result;
public ResultBody() {
}
public ResultBody(BaseErrorInfoInterface errorInfo) {
this.code = errorInfo.getResultCode();
this.message = errorInfo.getResultMsg();
}
public String getCode() {
return code;
}
public void setCode(String code) {
this.code = code;
}
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
public Object getResult() {
return result;
}
public void setResult(Object result) {
this.result = result;
}
/**
* 成功
*
* @return
*/
public static ResultBody success() {
return success(null);
}
/**
* 成功
* @param data
* @return
*/
public static ResultBody success(Object data) {
ResultBody rb = new ResultBody();
rb.setCode(CommonEnum.SUCCESS.getResultCode());
rb.setMessage(CommonEnum.SUCCESS.getResultMsg());
rb.setResult(data);
return rb;
}
/**
* 失敗
*/
public static ResultBody error(BaseErrorInfoInterface errorInfo) {
ResultBody rb = new ResultBody();
rb.setCode(errorInfo.getResultCode());
rb.setMessage(errorInfo.getResultMsg());
rb.setResult(null);
return rb;
}
/**
* 失敗
*/
public static ResultBody error(String code, String message) {
ResultBody rb = new ResultBody();
rb.setCode(code);
rb.setMessage(message);
rb.setResult(null);
return rb;
}
/**
* 失敗
*/
public static ResultBody error( String message) {
ResultBody rb = new ResultBody();
rb.setCode("-1");
rb.setMessage(message);
rb.setResult(null);
return rb;
}
@Override
public String toString() {
return JSONObject.toJSONString(this);
}
}
自定義全局異常處理類
最后我們在來編寫一個自定義全局異常處理的類。
代碼如下:
@ControllerAdvice
public class GlobalExceptionHandler {
private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);
/**
* 處理自定義的業(yè)務異常
* @param req
* @param e
* @return
*/
@ExceptionHandler(value = BizException.class)
@ResponseBody
public ResultBody bizExceptionHandler(HttpServletRequest req, BizException e){
logger.error("發(fā)生業(yè)務異常！原因是：{}",e.getErrorMsg());
return ResultBody.error(e.getErrorCode(),e.getErrorMsg());
}
/**
* 處理空指針的異常
* @param req
* @param e
* @return
*/
@ExceptionHandler(value =NullPointerException.class)
@ResponseBody
public ResultBody exceptionHandler(HttpServletRequest req, NullPointerException e){
logger.error("發(fā)生空指針異常！原因是:",e);
return ResultBody.error(CommonEnum.BODY_NOT_MATCH);
}
/**
* 處理其他異常
* @param req
* @param e
* @return
*/
@ExceptionHandler(value =Exception.class)
@ResponseBody
public ResultBody exceptionHandler(HttpServletRequest req, Exception e){
logger.error("未知異常！原因是:",e);
return ResultBody.error(CommonEnum.INTERNAL_SERVER_ERROR);
}
}
因為這里我們只是用于做全局異常處理的功能實現(xiàn)以及測試，所以這里我們只需在添加一個實體類和一個控制層類即可。
實體類
又是萬能的用戶表 (^▽^)
代碼如下：
public class User implements Serializable{
private static final long serialVersionUID = 1L;
/** 編號 */
private int id;
/** 姓名 */
private String name;
/** 年齡 */
private int age;
public User(){
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String toString() {
return JSONObject.toJSONString(this);
}
}
Controller 控制層
控制層這邊也比較簡單，使用Restful風格實現(xiàn)的CRUD功能，不同的是這里我故意弄出了一些異常，好讓這些異常被捕獲到然后處理。這些異常中，有自定義的異常拋出，也有空指針的異常拋出，當然也有不可預知的異常拋出(這里我用類型轉換異常代替)，那么我們在完成代碼編寫之后，看看這些異常是否能夠被捕獲處理成功吧！
代碼如下:
@RestController
@RequestMapping(value = "/api")
public class UserRestController {
@PostMapping("/user")
public boolean insert(@RequestBody User user) {
System.out.println("開始新增...");
//如果姓名為空就手動拋出一個自定義的異常！
if(user.getName()==null){
throw new BizException("-1","用戶姓名不能為空！");
}
return true;
}
@PutMapping("/user")
public boolean update(@RequestBody User user) {
System.out.println("開始更新...");
//這里故意造成一個空指針的異常，并且不進行處理
String str=null;
str.equals("111");
return true;
}
@DeleteMapping("/user")
public boolean delete(@RequestBody User user) {
System.out.println("開始刪除...");
//這里故意造成一個異常，并且不進行處理
Integer.parseInt("abc123");
return true;
}
@GetMapping("/user")
public List<User> findByUser(User user) {
System.out.println("開始查詢...");
List<User> userList =new ArrayList<>();
User user2=new User();
user2.setId(1L);
user2.setName("xuwujing");
user2.setAge(18);
userList.add(user2);
return userList;
}
}
App 入口
和普通的SpringBoot項目基本一樣。
代碼如下:
@SpringBootApplication
public class App
{
public static void main( String[] args )
{
SpringApplication.run(App.class, args);
System.out.println("程序正在運行...");
}
}
功能測試
我們成功啟動該程序之后，使用Postman工具來進行接口測試。
首先進行查詢，查看程序正常運行是否ok，使用GET 方式進行請求。
GET http://localhost:8181/api/user
返回參數(shù)為:
{"id":1,"name":"xuwujing","age":18}
示例圖:
可以看到程序正常返回，并沒有因自定義的全局異常而影響。
然后我們再來測試下自定義的異常是否能夠被正確的捕獲并處理。
使用POST方式進行請求
POST http://localhost:8181/api/user
Body參數(shù)為:
{"id":1,"age":18}
返回參數(shù)為:
{"code":"-1","message":"用戶姓名不能為空！","result":null}
示例圖:
可以看出將我們拋出的異常進行數(shù)據(jù)封裝，然后將異常返回出來。
然后我們再來測試下空指針異常是否能夠被正確的捕獲并處理。在自定義全局異常中，我們除了定義空指針的異常處理，也定義最高級別之一的Exception異常，那么這里發(fā)生了空指針異常之后，它是回優(yōu)先使用哪一個呢？這里我們來測試下。
使用PUT方式進行請求。
PUT http://localhost:8181/api/user
Body參數(shù)為:
{"id":1,"age":18}
返回參數(shù)為:
{"code":"400","message":"請求的數(shù)據(jù)格式不符!","result":null}
示例圖:
我們可以看到這里的的確是返回空指針的異常護理，可以得出全局異常處理優(yōu)先處理子類的異常。
那么我們在來試試未指定其異常的處理，看該異常是否能夠被捕獲。
使用DELETE方式進行請求。
DELETE http://localhost:8181/api/user
Body參數(shù)為:
{"id":1}
返回參數(shù)為:
{"code":"500","message":"服務器內部錯誤!","result":null}
這里可以看到它使用了我們在自定義全局異常處理類中的Exception異常處理的方法。
到這里，測試就結束了。順便再說一下，自義定全局異常處理除了可以處理上述的數(shù)據(jù)格式之外，也可以處理頁面的跳轉，只需在新增的異常方法的返回處理上填寫該跳轉的路徑并不使用ResponseBody 注解即可。 細心的同學也許發(fā)現(xiàn)了在GlobalExceptionHandler類中使用的是ControllerAdvice注解，而非RestControllerAdvice注解，如果是用的RestControllerAdvice注解，它會將數(shù)據(jù)自動轉換成JSON格式，這種于Controller和RestController類似，所以我們在使用全局異常處理的之后可以進行靈活的選擇處理。
其它
關于SpringBoot優(yōu)雅的全局異常處理的文章就講解到這里了，如有不妥，歡迎指正！
項目地址
SpringBoot全局異常的處理項目工程地址:
https://github.com/xuwujing/springBoot-study/tree/master/springboot-exceptionHandler
SpringBoot整個集合的地址:
https://github.com/xuwujing/springBoot-study
總結
以上就是這篇文章的全部內容了，希望本文的內容對大家的學習或者工作具有一定的參考學習價值，謝謝大家對腳本之家的支持。
相關文章
因工作需要和一個Sap相關系統(tǒng)以WebService的方式進行接口聯(lián)調,之前僅聽過這種技術,但并沒有實操過,所以將本次開發(fā)進行記錄,這篇文章主要給大家介紹了關于java對接webservice接口的4種方式,需要的朋友可以參考下2023-10-10
這篇文章主要介紹了MybatisPlus多表查詢及分頁查詢完整代碼,本文通過示例代碼給大家介紹的非常詳細,感興趣的朋友跟隨小編一起看看吧2024-08-08
詳解java并發(fā)編程(2) --Synchronized與Volatile區(qū)別
這篇文章主要介紹了Synchronized與Volatile區(qū)別，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2019-04-04
SpringCloudAlibaba Nacos開啟鑒權解決跳過登錄頁面問題
對于Nacos,如果需要開啟權限控制,可以在 Nacos 控制臺上進行配置,本文主要介紹了SpringCloudAlibaba Nacos開啟鑒權解決跳過登錄頁面問題,感興趣的可以了解一下2023-10-10
這篇文章主要介紹了Java Collections類操作集合詳解，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2021-01-01
這篇文章主要介紹了java漢字轉拼音工具類完整代碼實例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-03-03
Java+Nginx實現(xiàn)POP、IMAP、SMTP郵箱代理服務
本篇文章的內容是介紹Java+Nginx如何實現(xiàn)POP、IMAP、SMTP郵箱代理服務，步驟詳細，思路清新,需要的朋友可以參考下2015-07-07
Flink API提供了開發(fā)的接口，此外，為了實現(xiàn)業(yè)務邏輯，還必須為開發(fā)者提供自定義業(yè)務邏輯的能力，下面為大家解析Flink內核原理與實現(xiàn)核心抽象2021-08-08
Spring Boot Thymeleaf實現(xiàn)國際化的方法詳解
這篇文章主要給大家介紹了關于Spring Boot Thymeleaf實現(xiàn)國際化的相關資料，文中通過示例代碼介紹的非常詳細，對大家學習或者使用Spring Boot具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧2019-10-10
這篇文章主要介紹了教你用Java驗證服務器登錄系統(tǒng),文中有非常詳細的代碼示例,對正在學習java的小伙伴們有很好的幫助,需要的朋友可以參考下2021-04-04