需要规定
为了缩小正文和swagger注解的反复定义, 通过标准正文, 让swagger能够通过javadoc来产生
替换@Api、@ApiOperation、@ApiModel、@ApiModelProperties等注解
只是对swagger的扩大，如果有swagger注解，以注解为准
运行环境
springboot2.1.7
jdk1.8
设计思维
零碎构思
编译实现的class里没有正文的，所以正文信息只有在编译代码时存储起来
swagger自身是通过注解实现接口定义形容等加载的，现将代码正文生成json格局,利用swagger扩大在启动我的项目时通过json进行加载到swagger中
须要配合自定义的javadoc-json-maven-plugin先将正文生成json文件
关键技术与算法
生成javadoc.json文件
com.example.CommentToJsonMain(已做成maven插件, 这里原始文件可做测试)
插件: https://github.com/zhaozhiwei...
swagger扩大代码
com.example.SpringbootSwaggerJavadocApplication启动即可失效
类定义: com.example.plugin.CommentApiBuilder
办法定义: com.example.plugin.CommentOperationBuilder
类代码正文标准
/** * @Title: PersonController * @Package: com/example/springbootcache/controller/PersonController.java * @Description: 用户信息接口 * @author: zhaozhiwei * @date: 2022/10/25 下午8:23 * @version: V1.0 */办法代码正文标准
/** * @date: 2022/10/25-上午10:19 * @author: zhaozhiwei * @method: findByID * @param id : 惟一id * @return: com.lx.demo.springbootcache.domain.Person * @Description: 依据id获取用户信息 * 获取十次， 只有第一次是读库，后续都是取缓存 * 间接删掉redis缓存里的内容，依然能够获取数据，并且走缓存，此时获取的是服务缓存ehcache中的信息 * seq 10 |xargs -i curl -XGET 'http://localhost:8080/persons/2' */根本解决流程
零碎流程图
代码
https://github.com/zhaozhiwei...
参考
swagger扩大
https://github.com/hadix-lin/...
https://blog.csdn.net/ydongha...
https://blog.csdn.net/baiihcy...
https://blog.csdn.net/qq_1762...