API:application program-interface 应用编程接口。在web应用中常见的是前端开发工程师与后端开发工程师沟通的桥梁,是重要的规范文档。良好的API可以提高前后端协调的效率。
如何设计良好的API:
1.命名风格统一
如列表相关接口统一用ListXXXXX,获取详情接口getXXX,删除delXXX
2.返回格式统一
以返回json 格式为例:{ #返回状态码 code:integer, #返回信息描述 message:string, #返回值 data:object}
3.良好的状态码规范、说明
一、定义枚举类,讲返回的code 和message 保存在枚举类中
二、controller层 将需要返回的信息包装成Result
三、但是这样写,每个接口方法都需去包装一下,有点重复工作。优化思路:
1、先定义一个注解@ResponseResult,表示这个接口返回的值需要包装一下
2、拦截请求,判断此请求是否需要被@ResponseResult注解
3、核心步骤就是实现接口ResponseBodyAdvice和@ControllerAdvice,判断是否需要包装返回值,如果需要,就把Controller接口的返回值进行重写
热门文章
- 宠物粮食批发市场兰州在哪里啊电话多少(兰州宠物用品批发)
- 打过疫苗的猫抓伤出血(打过疫苗的猫抓伤出血要***吗)
- 1月24日→20M/S|2025年最新免费节点Clash for IOS订阅链接地址
- 11月6日→21.6M/S|2024年最新免费节点Clash for IOS订阅链接地址
- 11月18日→18.5M/S|2024年最新免费节点Clash for IOS订阅链接地址
- 1月20日→21.1M/S|2025年最新免费节点Clash for IOS订阅链接地址
- 湖州宠物领养在哪里(湖州动物领养)
- 宠物狗领养免费领养宠物的网站叫什么来着(宠物狗领养平台)
- 猫三针疫苗每针间隔时间(猫咪三针疫苗间隔多久打)
- 12月31日→21.4M/S|2025年最新免费节点Clash for IOS订阅链接地址