今天在gitee上学习到一个,个人觉得非常使用的功能。就是采用 SpringDoc、javadoc 无注解零入侵基于java注释,只需把注释写好 无需再写一大堆的文档注解了。
下面是源码的地址
我知道其他项目可能也有,但是我是从上面的地址学习来的。
说实话,个人觉得得力推的。所以将这个功能,从项目拷贝到我们自己的项目中。
在这里记录一下,搬运功能过程中碰到的一个问题
其实搬运起来,没太大问题,
把SpringDoc、javadoc对应的包引入,关于swagger的配置项复制过来。
一切都很顺利。
(在这里事先说明下,我们项目分了四个模块包,各尽其职。)
运行起来后,重写SwaggerConfig,对已经生成好的 OpenApi 进行自定义操作也执行了。可以生成接口文档了,但是就是不生成字段对应的注释。
后面关注要一个不起眼的东西。
加上这个后,注解就生成了。
在这里就想跟告知大家一下,如果你用SpringDoc、javadoc 无注解零入侵基于java注释,但是注释就是不生成的话。一般就是忘记加这个东西了。
博主新推出的gitee免费开源项目(商城+APP+小程序+H5),有兴趣的小伙伴可以了解一下。