Graceful Response 構(gòu)建 Spring Boot 響應(yīng)處理的方法

更新時(shí)間：2024年01月25日 11:11:13 作者：小畢超

Graceful Response是一個(gè)Spring Boot技術(shù)棧下的優(yōu)雅響應(yīng)處理器,提供一站式統(tǒng)一返回值封裝、全局異常處理、自定義異常錯(cuò)誤碼等功能,本文介紹Graceful Response 構(gòu)建 Spring Boot 下優(yōu)雅的響應(yīng)處理,感興趣的朋友一起看看吧

一、Graceful Response

Graceful Response 是一個(gè) Spring Boot 技術(shù)棧下的優(yōu)雅響應(yīng)處理器，提供一站式統(tǒng)一返回值封裝、全局異常處理、自定義異常錯(cuò)誤碼等功能，使用Graceful Response進(jìn)行web接口開發(fā)不僅可以節(jié)省大量的時(shí)間，還可以提高代碼質(zhì)量，使代碼邏輯更清晰。

github地址：https://github.com/feiniaojin/graceful-response

對(duì)應(yīng) SpringBoot 版本

Spring Boot版本	Graceful Response版本	graceful-response-example分支
2.x	3.4.0-boot2	3.4.0-boot2
3.x	3.4.0-boot3	3.4.0-boot3

二、快速使用

引入依賴：

<dependency>
    <groupId>com.feiniaojin</groupId>
    <artifactId>graceful-response</artifactId>
    <version>3.4.0-boot2</version>
</dependency>

啟動(dòng)類增加注解：

@EnableGracefulResponse

聲明測(cè)試接口：

@Slf4j
@RestController
@RequestMapping("/test")
public class TestController {
    /**
     * 返回對(duì)象形式
     */
    @GetMapping("/t1")
    public Map<String, String> t1() {
        //具體邏輯
        return Collections.singletonMap("status","abc");
    }
    /**
     * Command 形式
     */
    @GetMapping("/t2")
    public void t2() {
        // 具體邏輯
    }
}

測(cè)試 /test/t1 接口：

測(cè)試 /test/t2 接口：

三、返回格式調(diào)整

Graceful Response 內(nèi)置了兩種風(fēng)格的返回，可以通過修改 graceful-response.response-style 進(jìn)行切換，分別是：

默認(rèn)格式：

graceful-response:
  response-style: 0

第二種模式：

{
  "status": {
    "code": 200,
    "msg": "success"
  },
  "payload": {
  }
}

格式如下：

{
  "code": "200",
  "msg": "success",
  "data": {
  }
}

如果需要自定義返回格式則需要實(shí)現(xiàn) Response 接口，并在配置中通過graceful-response.response-class-full-name 進(jìn)行指定，例如：

@Data
public class CustomResponse implements Response {

    private String code;

    private Long timestamp = System.currentTimeMillis();

    private String message;

    private Object data = Collections.EMPTY_MAP;

    @Override
    public void setStatus(ResponseStatus statusLine) {
        this.code = statusLine.getCode();
        this.message = statusLine.getMsg();
    }

    @Override
    @JsonIgnore
    public ResponseStatus getStatus() {
        return null;
    }

    @Override
    public void setPayload(Object payload) {
        this.data = payload;
    }

    @Override
    @JsonIgnore
    public Object getPayload() {
        return null;
    }
}

然后在配置文件中聲明：

graceful-response:
  response-class-full-name: com.bxc.retrydemo.handler.CustomResponse

再次訪問上面的測(cè)試接口：

四、自定義異常和錯(cuò)誤碼

當(dāng)拋出異常時(shí)我們希望根據(jù)不同的異常返回不同的錯(cuò)誤碼，在 Graceful Response 中為我們提供了 @ExceptionMapper 注解，可以快速的指定返回的錯(cuò)誤碼和提示。

例如：

@ExceptionMapper(code = "1003", msg = "自定義異常", msgReplaceable = true)
public class MyException extends RuntimeException {
    public MyException() {
        super();
    }
    public MyException(String message) {
        super(message);
    }
    public MyException(String message, Throwable cause) {
        super(message, cause);
    }
    public MyException(Throwable cause) {
        super(cause);
    }
    public MyException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
        super(message, cause, enableSuppression, writableStackTrace);
    }
}

測(cè)試接口修改：

@Slf4j
@RestController
@RequestMapping("/test")
public class TestController {
    /**
     * 返回對(duì)象形式
     */
    @GetMapping("/t1")
    public Map<String, String> t1(Integer a) {
        //具體邏輯
        // ....
        // 拋出異常
        if (a == 0){
            throw new MyException();
        }
        return Collections.singletonMap("status","abc");
    }
    /**
     * Command 形式
     */
    @GetMapping("/t2")
    public void t2(Integer a) {
        //具體邏輯
        // ....
        // 拋出異常
        if (a == 0){
            throw new MyException("t2 接口執(zhí)行異常");
        }
    }
}

測(cè)試 /test/t1 接口：

測(cè)試 /test/t2 接口：

五、參數(shù)校驗(yàn)異常錯(cuò)誤碼

有的時(shí)候我們需要校驗(yàn)?zāi)硞€(gè)參數(shù)是否合法，當(dāng)在不同情況下需要返回不同的錯(cuò)誤碼，在 Graceful Response 中對(duì)JSR-303數(shù)據(jù)校驗(yàn)規(guī)范和Hibernate Validator進(jìn)行了增強(qiáng)，Graceful Response自身不提供參數(shù)校驗(yàn)的功能，但是用戶使用了Hibernate Validator后，Graceful Response可以通過@ValidationStatusCode注解為參數(shù)校驗(yàn)結(jié)果提供響應(yīng)碼，并將其統(tǒng)一封裝返回。

例如：

@Data
public class TestDTO {
    @NotNull(message = "name 不可為空")
    @Length(min = 1, max = 5, message = "name 的長(zhǎng)度在 1-5 之間")
    @ValidationStatusCode(code = "1003")
    private String name;
    @NotNull(message = "age 不可為空")
    @Min(value = 0,message = "age 不可小于 0 ")
    @ValidationStatusCode(code = "1004")
    private Integer age;
}

聲明測(cè)試接口：

@Slf4j
@RestController
@RequestMapping("/test")
public class TestController {
    @PostMapping("/t3")
    public void t3(@Validated TestDTO dto) {
        //具體邏輯
        // ....
    }
}

測(cè)試 /test/t3 接口：

六、手動(dòng)拋出指定狀態(tài)碼和信息

Graceful Response 提供了 GracefulResponse 通用工具類，在需要拋出GracefulResponseException時(shí)，只需要調(diào)用raiseException方法即可。

例如：

@Slf4j
@RestController
@RequestMapping("/test")
public class TestController {
    /**
     * 返回對(duì)象形式
     */
    @GetMapping("/t1")
    public Map<String, String> t1(Integer a) {
        //具體邏輯
        // ....
        // 拋出異常
        if (a == 0) {
            GracefulResponse.raiseException("1065", "自定義拋出異常");
        }
        return Collections.singletonMap("status", "abc");
    }
}

測(cè)試 /test/t1 接口：

七、例外請(qǐng)求放行

Graceful Response 會(huì)對(duì)所有的 controller 方法處理，如果希望跳過自定處理返回可以可以添加 @ExcludeFromGracefulResponse注解：

例如：

@Slf4j
@RestController
@RequestMapping("/test")
public class TestController {
    /**
     * 返回對(duì)象形式
     */
    @GetMapping("/t1")
    @ExcludeFromGracefulResponse
    public Map<String, String> t1(Integer a) {
        //具體邏輯
        // ....
        return Collections.singletonMap("status", "abc");
    }
}

也可以根據(jù)包名進(jìn)行排除，例如：

graceful-response:
  exclude-packages:
    - springfox.**

graceful-response:
  exclude-packages:
    - org.springframework.boot.actuate.*

八、常用配置

graceful-response:
  # 自定義Response類的全限定名，默認(rèn)為空。 
  # 配置response-class-full-name后，response-style將不再生效
  response-class-full-name:
  # 是否打印異常日志，默認(rèn)為false
  print-exception-in-global-advice: false
  # Response風(fēng)格，不配置默認(rèn)為0
  response-style: 0
  # 自定義的成功響應(yīng)碼，不配置則為0
  default-success-code: 0
  # 自定義的成功提示，默認(rèn)為ok
  default-success-msg: ok
  # 自定義的失敗響應(yīng)碼，默認(rèn)為1
  default-error-code: 1
  # 自定義的失敗提示，默認(rèn)為error
  default-error-msg: error
  # 全局的參數(shù)校驗(yàn)錯(cuò)誤碼，默認(rèn)等于default-error-code
  default-validate-error-code:
  # 例外包路徑(支持?jǐn)?shù)字, *和**通配符匹配)，該包路徑下的controller將被忽略處理
  exclude-packages:
    - com.lizhiadmin.pro.module.*.controller
  # 設(shè)置是否將原生異常錯(cuò)誤信息detailMessage字段填充到Response的msg中
  # 默認(rèn)為false，即不打開
  origin-exception-using-detail-message: false

到此這篇關(guān)于Graceful Response 構(gòu)建 Spring Boot 下優(yōu)雅的響應(yīng)處理的文章就介紹到這了,更多相關(guān)Spring Boot 響應(yīng)處理內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: