maven引入插件
<plugin> <groupId>com.github.shalousun</groupId> <artifactId>smart-doc-maven-plugin</artifactId> <version>2.0.0</version> <configuration> <!--指定生成文档的使用的配置文件,配置文件放在自己的项目中--> <configFile>./src/main/resources/smart-doc.json</configFile> <!--指定项目名称--> <projectName>开发环境</projectName> <!--smart-doc实现自动分析依赖树加载第三方依赖的源码,如果一些框架依赖库加载不到导致报错,这时请使用excludes排除掉--> <!--smart-doc能自动分析依赖树加载所有依赖源码,原则上会影响文档构建效率,因此你可以使用includes来让插件加载你配置的组件--> <includes> <!--格式为:groupId:artifactId;参考如下--> <include>com.alibaba:fastjson</include> </includes> </configuration> <!-- <executions> <execution> <!–如果不需要在执行编译时启动smart-doc,则将phase注释掉–> <phase>compile</phase> <goals> <!–smart-doc提供了html、openapi、markdown等goal,可按需配置–> <goal>html</goal> </goals> </execution> </executions>--> </plugin>
smart-doc.json
{ "serverUrl": "http://ip:port", //设置服务器地址,非必须 "isStrict": false, //是否开启严格模式 "allInOne": true, //是否将文档合并到一个文件中,一般推荐为true "outPath": "D://api", //指定文档的输出路径 "coverOld": true, //是否覆盖旧的文件,主要用于mardown文件覆盖 "packageFilters": "",//controller包过滤,多个包用英文逗号隔开 "createDebugPage": true,//@since 2.0.0 smart-doc支持创建可以测试的html页面,仅在AllInOne模式中起作用。 "md5EncryptedHtmlName": false,//只有每个controller生成一个html文件是才使用 "projectName": "接口",//配置自己的项目名称 "skipTransientField": true,//目前未实现 "showAuthor":false,//是否显示接口作者名称,默认是true,不想显示可关闭 "requestFieldToUnderline":false, //自动将驼峰入参字段在文档中转为下划线格式,//@since 1.8.7 版本开始 "responseFieldToUnderline":false,//自动将驼峰入参字段在文档中转为下划线格式,//@since 1.8.7 版本开始 "inlineEnum":true,//设置为true会将枚举详情展示到参数表中,默认关闭,//@since 1.8.8版本开始 "recursionLimit":20,//设置允许递归执行的次数用于避免栈溢出,默认是7,正常为3次以内,//@since 1.8.8版本开始 "displayActualType":false,//配置true会在注释栏自动显示泛型的真实类型短类名,@since 1.9.6 "urlSuffix":"",//支持SpringMVC旧项目的url后缀,@since 2.1.0 "appKey": "2020208",// torna平台对接appKey,, @since 2.0.9 "appToken": "c16931fa685340fcbfef", //torna平台appToken,@since 2.0.9 "secret": "[email protected]#V&tUUYZR", "ignoreRequestParams":[ //忽略请求参数对象,把不想生成文档的参数对象屏蔽掉,@since 1.9.2 "javax.servlet.http.HttpSession", "javax.servlet.http.HttpServletRequest" ] }
生成
这会生成html页面接口文档
注释方式直接
标签:false,doc,since,文档,true,smart From: https://www.cnblogs.com/pxblog/p/16802648.html