response统一格式
一、目标 弄清楚为什么要对springboot,所有Controller的response做统一格式封装?学会用ResponseBodyAdvice接口 和 @ControllerAdvice注解 二、为什么要对springboot的接口返回值统一标准格式?我们先来看下,springboot默认情况下的response是什么格式的
第一种格式:response为String以上springboot的返回值为
test 第二种格式:response为Objct以上springboot的返回值为
第三种格式:response为void以上springboot的返回值为空
第四种格式:response为异常以上springboot的返回值为空
以上4种,情况,如果你和客户端(app h5)开发人联调接口,他们会很懵逼,因为你给他们的接口没有一个统一的格式,客户端开发人员,不知道如何处理返回值。
故,我们应该统一response的标准格式。
三、定义response的标准格式一般的response的标准格式包含3部分:
1.status状态值:代表本次请求response的状态结果。
2.response描述:对本次状态码的描述。
3.data数据:本次返回的数据。
四、初级程序员对response代码封装对response的统一封装,是有一定的技术含量的,我们先来看下,初级程序员的封装,网上很多教程都是这么写的。
步骤1:把标准格式转换为代码把以上格式转换为Result代码
步骤2:把状态码存在枚举类里面 步骤3:加一个体验类结论:看到这里,应该有很多同学都知道这样封装代码有很大弊端。
因为今后你每写一个接口,都要手工指定Result.suc()这行代码,多累啊??
如果你写这种代码推广给你整个公司用,然后硬性规定代码必须这么写!!所有程序都会吐槽鄙视!!!!
五、高级程序员对response代码封装如果你在公司推广你的编码规范,为了避免被公司其他程序员吐槽和鄙视,我们必须优化代码。
优化的目标:不要每个接口都手工指定Result返回值。
步骤1:采用ResponseBodyAdvice技术来实现response的统一格式springboot提供了ResponseBodyAdvice来帮我们处理
ResponseBodyAdvice的作用:拦截Controller方法的返回值,统一处理返回值/响应体,一般用来做response的统一格式、加解密、签名等等。
先看下ResponseBodyAdvice这个接口的源码。
步骤2:写一个ResponseBodyAdvice实现类以上代码,有2个地方需要重点讲解:
第1个地方:@ControllerAdvice 注解@ControllerAdvice这是一个非常有用的注解,它的作用是增强Controller的扩展功能类。
那@ControllerAdvice对Controller增强了哪些扩展功能呢?主要体现在2方面:
对Controller全局数据统一处理,例如,我们这节课就是对response统一封装。对Controller全局异常统一处理,这个后面的课程会详细讲解。在使用@ControllerAdvice时,还要特别注意,加上basePackages,
因为如果不加的话,它可是对整个系统的Controller做了扩展功能,
它会对某些特殊功能产生冲突,例如 不加的话,在使用swagger时会出现空白页异常。
第2个地方:beforeBodyWrite方法体的response类型判断以上代码一定要加,因为Controller的返回值为String的时候,它是直接返回String,不是json,
故我们要手工做下json转换处理
以上为个人经验,希望能给大家一个参考,也希望大家多多支持七叶笔记。