微服务 API 文档自动生成实战(基于 Swagger 可生成 PDF/MD/Asciidoc/HT

现在互联网最流行的技术架构就是微服务架构了,在微服务架构体系中,很多业务被拆分成不同的服务,每个人负责一个或多个服务开发,然后使用前后端分离技术,这时候前后端开发之间的沟通成本就比较大了, 加上对外输出 API 能力,也需要接口文档输出。本课程教您自己开发一个 API 文档生成工具。

在本场 Chat 中,会讲到如下内容:

  • Spring Boot 集成 Swagger
  • Swagger 常用注解介绍
  • 通过 swagger2markup maven 插件生成 Asciidoc 文档
  • 通过 asciidoctorj maven 插件生成 HTML/PDF 文档
  • 通过代码方式生成 Asciidoc/MD
  • 通过代码方式 生成 PDF/HTML
  • PDF 格式中文乱码/缺失问题解决
  • API 文档自定义中文配置
  • 开发一个整合生成文档的 API 工具服务

阅读全文: http://gitbook.cn/gitchat/activity/5daba191bcd49254d49b8f0a

您还可以下载 CSDN 旗下精品原创内容社区 GitChat App ,阅读更多 GitChat 专享技术内容哦。

微服务 API 文档自动生成实战(基于 Swagger 可生成 PDF/MD/Asciidoc/HT