JavaSpringbootAPI接口设计模式通用返回类

1. API接口返回数据格式

日常在调用其他服务提供的API接口时，常见的返回数据格式为：

{"code": xx, "data": xxxx}

因此有必要照猫画虎，在自己的项目中也设计一个通用的数据格式。

2. 定义通用数据返回类

首先需要定义一个通用数据返回类： CommonResponseData

import lombok.Data;
/**
* HTTP通用返回类，返回格式 {"code": xxx, "data": xxx }
*/
@Data
public class CommonResponseData {
// 状态码
private int code;
// 数据内容
private Object data;
// 通用静态工厂方法
public static CommonResponseData create(Object data){
// 设置默认code为0，表示访问正常
return CommonResponseData.create(data, 0);
}
// 静态工厂方法，重写Code和Data
public static CommonResponseData create(Object data, int code){
CommonResponseData returnType = new CommonResponseData();
returnType.setCode(code);
returnType.setData(data);
return returnType;
}
}

3. 使用通用数据返回类

我们可以在Controller中使用CommonResponseData类来封装返回数据

@RestController
@RequestMapping(value = "/")
public class ApiController {
@GetMapping(value = "/test1")
public CommonResponseData test1(){
return CommonResponseData.create("ok");
}
@GetMapping(value = "/test2")
public CommonResponseData test2(){
return CommonResponseData.create(1001, "request error");
}
}

4. 测试效果

通过Postman测试test1接口，返回预期结果

通过Postman测试test2接口，返回预期结果

5. 总结

通过CommonResponseData类非常简单的就实现了API接口通用的返回数据封装，便于被前端或其他系统调用。

在CommonResponseData类中我们定义了code状态码，因此在下一篇文章中介绍《Java Springboot设计通用错误处理》。

本文地址：https://blog.csdn.net/coco3848/article/details/108263535