<div align=center><img src="./assets/project-name.png"></div>

<a href="https://hellogithub.com/repository/1fc5b7426d9a4398b53719468a2ae16a" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=1fc5b7426d9a4398b53719468a2ae16a&claim_uid=CGoRi0Ug35dqj42" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>

<!-- TOC -->

• 1. 项目介绍
• 2. 功能列表
• 3. 推广感谢
• 4.快速入门
  • 4.1 maven依赖
  • 4.2 版本选择
  • 4.3 注解开启
  • 4.4 代码编写
• 5.文档和示例
  • 5.1 文档中心
  • 5.2 代码示例
• 6.交流和反馈
• 7.贡献者
• 8.star

<!-- TOC -->

1. 项目介绍

Graceful Response是Spring Boot技术体系下的响应处理解决方案，可以帮助开发者优雅地完成包括统一响应格式数据封装、全局异常处理、错误码填充、异常消息国际化等处理过程，提高开发效率，提高代码质量。

代码仓库如下，欢迎star！

• GitHub

https://github.com/feiniaojin/graceful-response

不怕学不会，B站教学视频：https://www.bilibili.com/video/BV1Wm411C7vs/

不怕学不会，B站教学视频：https://www.bilibili.com/video/BV1Wm411C7vs/

不怕学不会，B站教学视频：https://www.bilibili.com/video/BV1Wm411C7vs/

2. 功能列表

• 统一返回值封装
• void返回类型封装
• 全局异常处理
• 参数校验错误码
• 自定义响应体，适应不同项目的需求
• 断言增强并且填充错误码和异常信息到Response
• 异常别名，适配外部异常
• 例外请求放行
• 第三方组件适配（Swagger、actuator、FastJson序列化等）

更多功能，请到文档中心的项目主页进行了解。

3. 推广感谢

感谢以下公众号或者自媒体对本项目的推广。

自媒体名称	类型	链接
芋道源码	公众号	https://mp.weixin.qq.com/s/VG6n5IsIDez8iZkY8JK6QQ
Java面试那些事	公众号	https://mp.weixin.qq.com/s/V9MhNVj3uQRrmnrfy9KkAQ
编程奇点	公众号	https://mp.weixin.qq.com/s/cQWgivkpuXGEijRR1WRt0g
macrozheng	公众号	https://mp.weixin.qq.com/s/XAHBzVRFuMJTEh8Y1Xvv4g
Java后端技术	公众号	https://mp.weixin.qq.com/s/4ssfZftGUqq0l9nW9lShLA
Java高性能架构	公众号	https://mp.weixin.qq.com/s/XImjkUExBHEklgrLnrINyw
技术老男孩	公众号	https://mp.weixin.qq.com/s/6gafudNaNTK1FRIdvNMXXw
Java知音	公众号	https://mp.weixin.qq.com/s/ZNmpTZnL2XqsPN2ayq0_4Q
Java123	公众号	https://mp.weixin.qq.com/s/MF0PaawFILzNBMM78O_Pnw
程序员追风	公众号	https://mp.weixin.qq.com/s/wlY0phnXEiO7E_basxsWJw

4.快速入门

4.1 maven依赖

<dependency>
    <groupId>com.feiniaojin</groupId>
    <artifactId>graceful-response</artifactId>
    <version>{latest.version}</version>
</dependency>

4.2 版本选择

Latest Version

Spring Boot版本	maven版本	graceful-response-example分支
2.x	3.5.2-boot2	3.5.2-boot2
3.x	4.0.1-boot3	4.0.0-boot3

注意，boot2版本的Graceful

Response源码由单独的仓库进行维护，boot2和boot3除了支持的SpringBoot版本不一样，其他实现完全一致。boot2版本地址：graceful-response-boot2

4.3 注解开启

在启动类中引入@EnableGracefulResponse注解，即可启用Graceful Response组件。

@EnableGracefulResponse
@SpringBootApplication
public class ExampleApplication {
    public static void main(String[] args) {
        SpringApplication.run(ExampleApplication.class, args);
    }
}

4.4 代码编写

• Controller

引入Graceful Response后，我们不需要再手工进行查询结果的封装，直接返回实际结果即可，Graceful Response会自动完成封装的操作。

Controller层示例如下。

@Controller
public class Controller {
    @RequestMapping("/get")
    @ResponseBody
    public UserInfoView get(Long id) {
        log.info("id={}", id);
        return UserInfoView.builder().id(id).name("name" + id).build();
    }
}

在示例代码中，Controller层的方法直接返回了UserInfoView对象，没有进行封装的操作，但经过Graceful Response处理后，我们还是得到了以下的响应结果。

{
  "status": {
    "code": "0",
    "msg": "ok"
  },
  "payload": {
    "id": 1,
    "name": "name1"
  }
}

而对于命令操作（Command）尽量不返回数据，因此command操作的方法的返回值应该是void，Graceful Response对于对于返回值类型void的方法，也会自动进行封装。

public class Controller {
    @RequestMapping("/command")
    @ResponseBody
    public void command() {
        //业务操作
    }
}

成功调用该接口，将得到：

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

• Service层

在引入Graceful Response前，有的开发者在定义Service层的方法时，为了在接口中返回异常码，干脆直接将Service层方法定义为Response，淹没了方法的正常返回值。

传统项目直接返回Response的Service层方法：

/**
 * 直接返回Reponse的Service
 * 不规范
 */
public interface Service {
    public Reponse commandMethod(Command command);
}

Graceful Response引入@ExceptionMapper注解，通过该注解将异常和错误码关联起来，这样Service方法就不需要再维护Response的响应码了，直接抛出业务异常，由Graceful Response进行异常和响应码的关联。 @ExceptionMapper的用法如下。

/**
 * NotFoundException的定义，使用@ExceptionMapper注解修饰
 * code:代表接口的异常码
 * msg:代表接口的异常提示
 */
@ExceptionMapper(code = "1404", msg = "找不到对象")
public class NotFoundException extends RuntimeException {

}

Service接口定义：

public interface QueryService {
    UserInfoView queryOne(Query query);
}

Service接口实现：

public class QueryServiceImpl implements QueryService {
    @Resource
    private UserInfoMapper mapper;

    public UserInfoView queryOne(Query query) {
        UserInfo userInfo = mapper.findOne(query.getId());
        if (Objects.isNull(userInfo)) {
            //这里直接抛自定义异常
            throw new NotFoundException();
        }
        //……后续业务操作
    }
}

当Service层的queryOne方法抛出NotFoundException时，Graceful Response会进行异常捕获，并将NotFoundException对应的异常码和异常信息封装到统一的响应对象中，最终接口返回以下JSON。

{
  "status": {
    "code": "1404",
    "msg": "找不到对象"
  },
  "payload": {}
}

5.文档和示例

5.1 文档中心

https://doc.feiniaojin.com/graceful-response/home.html

点击访问文档中心

5.2 代码示例

• GitHub

https://github.com/feiniaojin/graceful-response-example

6.交流和反馈

欢迎通过以下二维码联系作者、并加入Graceful Response用户交流群，申请好友时请备注“GR”。

<div><img src="./assets/qr.jpg" style="width: 50%"/></div>

公众号: 悟道领域驱动设计

<div><img src="./assets/gzh.jpg" style="width: 50%"/></div>

7.贡献者

<a href="https://github.com/feiniaojin/graceful-response/graphs/contributors"> <img src="https://contrib.rocks/image?repo=feiniaojin/graceful-response" /> </a>

8.star