Swagger 自动生成 Dubbo 服务的接口文档，以及测试调用

点击上方“芋道源码”，选择“设为星标”

管她前浪，还是后浪？

能浪的浪，才是好浪！

每天 8:55 更新文章，每天掉亿点点头发...

源码精品专栏

 

• 原创 | Java 2020 超神之路，很肝~
  

• 中文详细注释的开源项目
  

• RPC 框架 Dubbo 源码解析

• 网络应用框架 Netty 源码解析
  

• 消息中间件 RocketMQ 源码解析
  

• 数据库中间件 Sharding-JDBC 和 MyCAT 源码解析

• 作业调度中间件 Elastic-Job 源码解析

• 分布式事务中间件 TCC-Transaction 源码解析

• Eureka 和 Hystrix 源码解析

• Java 并发源码

• 1. 概述

• 2. Swagger Dubbo

• 3. 接入 Knife4j 作为 Swagger UI 界面

• 4. 接入 YApi 统一管理

• 666. 彩蛋

---

1. 概述

在使用 SpringMVC 构建 HTTP API 时，我们可以通过 Swagger 自动生成 HTTP 接口文档，通过 Swagger UI 界面上进行 HTTP 接口调试。如下图所示：

Swagger HTTP 界面

秃头提示：对 Swagger 不太了解的胖友，可以去阅读下艿艿写的 《芋道 Spring Boot API 接口文档 Swagger 入门》 文章。

开发体验杠杠的好！但是在使用 Dubbo 构建 RPC API 时，简直想要自闭。常常面临的痛苦是：

• 隔壁团队的老王，不肯给 Dubbo 写接口文档，只能从他的 Dubbo API 的 jar 包中寻寻觅觅想要的接口，贼不方便~

• 自己编写的每个 Dubbo API 接口，都需要写个 Controller 或者 Test 类去调用测试，接口调试非常麻烦~

在一个逐步自闭到要爆炸的下午，艿艿做了一波 Dubbo 接口文档与接口调试的调研，想要尝试这块的痛点。结果比想象中顺利且简单，这不趁着这无聊到抠脚的周末，整理下分享给胖友。