java类似swagger,一种无侵入比swagger-ui兼容性更好更简单的API文档生成方案

作者：互联网活化石

来源：http://suo.im/5Sijti

在后端项目中，难免遇到需要写接口文档方便第三方调用的场景，一般业界最常用的方案是使用swagger。Java项目中，一般采用springfox项目，它集成了swagger和swagger-ui，不需要单独部署项目，可让文档随着项目一起发布。

为什么不使用swagger-ui

但是开源项目往往是开源一时热，事后拂衣去，缺少维护。这个项目已经两年多没有维护了，很多人在issue反馈过bug，作者一年前表示自己比较忙，没空维护。

springfox最新的版本是2.9.2，不支持spring5(虽然有个快照版支持spring5，但一直没发布，整合也有点麻烦)。spring5比较大的一个改变就是增加了webflux，因此旧版springfox无法兼容spring5的。

其实用快照版，稍作修改也能让springfox支持webflux，但是我不是很喜欢这种做法。一个是增加了打包体积和运行内存占用，另一个则是swagger的使用污染了Java源码，很是不美观，强迫症不能忍。

@RestController@RequestMapping("/dataspace/api/v1/hive")@Api(value = "hive", descriptio