SpringCloud微服务接口这么多怎么调试
122 浏览量
2021-02-24
16:10:47
上传
评论
收藏 197KB PDF 举报
SpringCloud微服务接口这么多怎么调试微服务接口这么多怎么调试
导读
我们知道在微服务架构下，软件系统会被拆分成很多个独立运行的服务，而这些服务间需要交互通信，就需要定义各种各样的
服务接口。具体来说，在基于Spring Cloud的微服务模式中，各个微服务会基于Spring MVC的Controller定义多个该微服务需
要向外部发布的接口。
根据各个微服务功能边界定义的不同，有些微服务会提供与具体业务相关的接口，如支付接口账户接口等；而有些微服务则会
提供一些公共性质的服务接口，如短信接口统一认证接口之类。而这些微服务往往又是由多个不同的团队在开发维护，传统方
式下服务接口的定义往往需要服务提供方提供良好的可阅读性比较高的接口文档才可以比较方便地对接和测试，而事实上，随
着时间的推移人员的迭代更新，很多情况下这些早期的接口文档往往很快就会因为无人维护而过时，即便不过时，微服务模式
下这样的方式也会因为服务接口文档太多而让开发人员显得抓狂！
那么有没有一种更便捷地方式，可以让开发接口的同时，自动就能生成与服务接口高度一致的文档来呢？答案是有的，接下来
就和大家一起聊聊到底有什么样方式可以让微服务的接口管理变得更加容易些！
接口管理方式介绍
事实上，市面上已经有多种开源项目提供了这样的支持！如：SwaggerApiDocRAPDOCLeverCrapApi等，这些项目都提供了
对于Api在线文档的管理功能，那么在Spring Cloud体系中哪一种方式更加适合呢？下面，我们一起来对比下这些项目的优缺
点。
Swagger
Swagger是一款基于YAMLJSON语言的文档在线生成和代码自动生成的工具。它的优点如下：
1）它可以直接嵌入在Spring Boot项目中，通过开发时编写注释，从而自动生成接口文档，实现代码与文档的高度一致；
2）可以分析接口的结构，并且还可以通过发起请求来验证接口的正确性；
3）它提供了多种编程语言的前后端分离解决方案，支持根据定义的接口导出各种语言的服务端或客户端代码 ；
4）它还包括了Swagger Editor，这是使用yaml语言的Swagger API的编辑器，支持导出yaml和json格式的接口文件；
5）包含了Swagger UI，它可以将Swagger Editor编辑好的接口文档以html的形式展示出来；
6）免费开源，支持国际化，生态丰富社区活跃；
它的缺点是：
1）对代码有侵入性；
2）不同项目的Swagger接口文档是分离的，需要到不同的地方去找；
3）Swagger UI展现出来的接口文档缺乏分类，使用体验比较差；
4）不同项目的接口文档没有权限管理，缺少Mock；
官网地址：https://swagger.io/
ApiDoc
ApiDoc是一款轻量级的类似于Swagger的在线文档生成工具。其缺点也类似于Swagger，接口管理自动测试等功能也比较
弱，并且其社区生态国际化方面都还不如Swagger。
官网地址：http://apidocjs.com/
RAP
RAP是一个可视化接口管理工具，它可以通过分析接口结构，动态生成模拟数据，校验真实接口正确性，围绕接口定义，通
过一系列自动化工具提升微服务模式下的协作效率。
它的优点如下：
1）支持项目管理团队管理文档版本管理；
2）支持Mock测试数据；
资源评论
