生产大文件下载导致 OOM，顺藤摸瓜拿下

👉 这是一个或许对你有用的社群
🐱 一对一交流/面试小册/简历优化/求职解惑，欢迎加入「芋道快速开发平台」知识星球。下面是星球提供的部分资料：
《项目实战（视频）》：从书中学，往事上“练”
《互联网高频面试题》：面朝简历学习，春暖花开
《架构 x 系统设计》：摧枯拉朽，掌控面试高频场景题
《精进 Java 学习指南》：系统学习，互联网主流技术栈
《必读 Java 源码专栏》：知其然，知其所以然

👉这是一个或许对你有用的开源项目
国产 Star 破 10w+ 的开源项目，前端包括管理后台 + 微信小程序，后端支持单体和微服务架构。
功能涵盖 RBAC 权限、SaaS 多租户、数据权限、商城、支付、工作流、大屏报表、微信公众号、CRM 等等功能：
Boot 仓库：https://gitee.com/zhijiantianya/ruoyi-vue-pro
Cloud 仓库：https://gitee.com/zhijiantianya/yudao-cloud
视频教程：https://doc.iocoder.cn
【国内首批】支持 JDK 21 + SpringBoot 3.2.2、JDK 8 + Spring Boot 2.7.18 双版本

来源：飞天小牛肉

1 简介

Graceful Response是一个Spring Boot技术栈下的优雅响应处理器，提供一站式统一返回值封装、全局异常处理、自定义异常错误码 等功能，使用Graceful Response进行web接口开发不仅可以节省大量的时间，还可以提高代码质量，使代码逻辑更清晰。

强烈推荐你花3分钟学会它！

本项目案例工程代码：https://github.com/feiniaojin/graceful-response-example.git ，注意选择最新版本的分支。

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

注意，3.2.1-boot2版本的Graceful Response源码由单独的仓库进行维护，地址为：https://github.com/feiniaojin/graceful-response-boot2
3.2.1-boot2和3.2.1-boot3除了支持的SpringBoot版本不一样，其他实现完全一致，Maven引用时只需要根据对应的SpringBoot版本选择Graceful Response的version即可，两者的groupId、artifactId是一致的。

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
项目地址：https://github.com/YunaiV/ruoyi-vue-pro
视频教程：https://doc.iocoder.cn/video/

2 快速入门

2.1 Spring Boot接口开发现状

目前，业界使用Spring Boot进行接口开发时，往往存在效率底下、重复劳动、可读性差等问题。以下伪代码相信大家非常熟悉，我们大部分项目的Controller接口都是这样的。

@Controller
publicclassController{


@GetMapping(
"/query")

@ResponseBody
public Response query(Map<String, Object> paramMap){

    Response res = 
new Response();

try {

//1.校验params参数合法性，包括非空校验、长度校验等
if (illegal(paramMap)) {

        res.setCode(
1);

        res.setMsg(
"error");

return res;

      }

//2.调用Service的一系列操作，得到查询结果
      Object data = service.query(params);

//3.将操作结果设置到res对象中
      res.setData(data);

      res.setCode(
0);

      res.setMsg(
"ok");

return res;

    } 
catch (Exception e) {

//4.异常处理：一堆丑陋的try...catch，如果有错误码的，还需要手工填充错误码
      res.setCode(
1);

      res.setMsg(
"error");

return res;

    }

  }

}

这段伪代码存在什么样的问题呢？

第一个问题，效率低下。 Controller层的代码应该尽量简洁，上面的伪代码其实只是为了将数据查询的结果进行封装，使其以统一的格式进行返回。例如以下格式的响应体：

{

"code": 
0,

"msg": 
"ok",

"data": {

"id": 
1,

"name": 
"username"
  }

}

查询过程中如果发生异常，需要在Controller进行手工捕获，根据捕获的异常人工地设置错误码，当然，也用同样的格式封装错误码进行返回。

可以看到，除了调用service层的query方法这一行，其他大部分的代码都执行进行结果的封装，大量的冗余、低价值的代码导致我们的开发活动效率很低。

第二个问题，重复劳动。 以上捕获异常、封装执行结果的操作，每个接口都会进行一次，因此造成大量重复劳动。

第三个问题，可读性低。 上面的核心代码被淹没在许多冗余代码中，很难阅读，如同大海捞针。

我们可以通过Graceful Response这个组件解决这样的问题。

2.2. 快速入门

2.2.1 引入Graceful Response组件

Graceful Response已发布至maven中央仓库，我们可以直接引入到项目中。

maven依赖如下：

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

Spring Boot版本	Graceful Response最新版本
2.x	3.2.1-boot2
3.x	3.2.1-boot3

2.2.2 启用Graceful Response

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

@EnableGracefulResponse
@SpringBootApplication
publicclassExampleApplication{

publicstaticvoidmain(String[] args){

    SpringApplication.run(ExampleApplication
.class, args);

  }

}

2.2.3 Controller层

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

Controller层示例如下。

@Controller
publicclassController{

@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的方法，也会自动进行封装。

publicclassController{

@RequestMapping(
"/command")

@ResponseBody
publicvoidcommand(){

//业务操作
  }

}

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

{

"status": {

"code": 
"200",

"msg": 
"success"
  },

"payload": {}

}

2.2.4 Service层

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

Response的代码如下。

//lombok注解
@Data
publicclassResponse{

private String code;

private String msg;

private Object data;

}

直接返回Response的Service层方法：

/**

 * 直接返回Reponse的Service

 * 不规范

 */
publicinterfaceService{

public Reponse commandMethod(Command command);

}

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

@ExceptionMapper的用法如下。

/**

 * NotFoundException的定义，使用
@ExceptionMapper注解修饰

 * code:代表接口的异常码

 * msg:代表接口的异常提示

 */
@ExceptionMapper(code = 
"1404", msg = 
"找不到对象")

publicclassNotFoundExceptionextendsRuntimeException{


}

Service接口定义：

publicinterfaceQueryService{

UserInfoView queryOne(Query query);

}

Service接口实现：

publicclassQueryServiceImplimplementsQueryService{

@Resource
private UserInfoMapper mapper;


public UserInfoView queryOne(Query query){

    UserInfo userInfo = mapper.findOne(query.getId());

if (Objects.isNull(userInfo)) {

//这里直接抛自定义异常
thrownew NotFoundException();

    }

//……后续业务操作
  }

}

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

{

"status": {

"code": 
"1404",

"msg": 
"找不到对象"
        },

"payload": {}

        }

2.2.5 参数校验

Graceful Response对JSR-303数据校验规范和Hibernate Validator进行了增强，Graceful Response自身不提供参数校验的功能，但是用户使用了Hibernate Validator后，Graceful Response可以通过@ValidationStatusCode注解为参数校验结果提供响应码，并将其统一封装返回。

例如以下的UserInfoQuery。

@Data
publicclassUserInfoQuery{

@NotNull(message = 
"userName is null !")

@Length(min = 
6, max = 
12)

@ValidationStatusCode(code = 
"520")

private String userName;

}

UserInfoQuery对象中定义了@NotNull和@Length两个校验规则，在未引入Graceful Response的情况下，会直接抛出异常；

在引入Graceful Response但是没有加入@ValidationStatusCode注解的情况下，会以默认的错误码进行返回；

在上面的UserInfoQuery中由于使用了@ValidationStatusCode注解，并指定异常码为520，则当userName字段任意校验不通过时，都会使用异常码520进行返回，如下。

{

"status": {

"code": 
"520",

"msg": 
"userName is null !"
  },

"payload": {}

}

而对于Controller层直接校验方法入参的场景，Graceful Response也进行了增强，如以下Controller。

publicclassController{


@RequestMapping(
"/validateMethodParam")

@ResponseBody
@ValidationStatusCode(code = 
"1314")

publicvoidvalidateMethodParam(

          @NotNull(message = 
"userId不能为空") Long userId,

          @
NotNull(message = "userName不能为空") Long userName) {

//省略业务逻辑
  }

}

如果该方法入参校验触发了userId和userName的校验异常，将以错误码1314进行返回，如下。

{

"status": {

"code": 
"1314",

"msg": 
"userId不能为空"
  },

"payload": {}

}

2.2.6 自定义Response格式

Graceful Response内置了两种风格的响应格式，并通过graceful-response.response-style进行配置。

graceful-response.response-style=0，或者不配置（默认情况），将以以下的格式进行返回：

{

"status": {

"code": 
1007,

"msg": 
"有内鬼，终止交易"
  },

"payload": {

  }

}

graceful-response.response-style=1，将以以下的格式进行返回：

{

"code": 
"1404",

"msg": 
"not found",

"data": {

        }

        }

如果这两种格式均不满足业务需要，Graceful Response也支持用户自定义响应体，关于自定义响应体的技术实现，请到自定义Response格式进行了解。

本项目提供的进阶功能，包括

第三方组件汽车（Swagger、执行器等）
自定义响应
异常请求放行
异常别名
常用配置项

目前该组件在GitHub上已经有两百多Star，很多朋友已经开始用了，大家可以通过下方链接了解下：

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

欢迎加入我的知识星球，全面提升技术能力。

👉 加入方式，“长按”或“扫描”下方二维码噢：

星球的内容包括：项目实战、面试招聘、源码解析、学习路线。

文章有帮助的话，在看，转发吧。

谢谢支持哟 (*^__^*）

继续阅读

阅读原文