Swagger:号称世界最流行的api框架(持续更新)
简介:
大后端时代,前端只需关心html css就可以了,数据的变动都是后端负责,利用jsp,前后端的沟通成本极低,因此极少出现沟通不到位的问题;
前后端分离时代的来临,让前后端彻底的独立,甚至前端和后端分别在两个服务器上都可以独立运行,优点:解耦了,但沟通成本也变大了;
产生的问题:无法做到产生问题,尽早解决,最终导致问题集中爆发,产品上线延期
解决方案:制定schema(计划提纲),实时更新API前后端开发文档
最初时用的word,但当开发规模过大时,协调负担极大
第二阶段postman,很好的解决的前后端api联调的问题;优点,实时展示后端api,也可以测试api是否连接成功;缺点,第三方工具,需要购买;
注意:IDEA2020以上版本集成了一个http请求工具(http client)来代替postman,很不错适合小项目使用
http client教程:https://my.oschina.net/keking/blog/3104972
现在swagger;仅需在后端打相应注解就可以自动的实时的更新api信息,方便前后端联调;
官网:https://swagger.io/
在项目中使用swagger,需要springfox.swagger(相当于一个jar包)
包含: swagger2 ,ui