Smart—doc配置
依赖
<dependency>
<groupId>com.github.shalousun</groupId>
<artifactId>smart-doc</artifactId>
<version>1.8.1</version>
<scope>compile</scope>
</dependency>
用于测试
<!-- smart-doc -->
<dependency> <groupId>com.github.shalousun</groupId>
<artifactId>smart-doc</artifactId>
<version>1.8.1</version>
<scope>test</scope>
</dependency>
生成markdown文件
/**
* 生成markdown文件
*/
public void testBuilderMdControllersApi() {
ApiConfig config = new ApiConfig();
config.setServerUrl("http://localhost:8080");
//设置为严格模式,Smart-doc将降至要求每个Controller暴露的接口写上标准文档注释
//config.setStrict(true);
config.setStrict(false);
//当把AllInOne设置为true时,Smart-doc将会把所有接口生成到一个Markdown、HHTML或者AsciiDoc中
config.setAllInOne(true);
//Set the api document output path.
config.setOutPath("d:\\md3");
String url="d:\\md3";
File file=new File(url);
if (!file.exists()){
file.mkdir();
}
// 设置接口包扫描路径过滤,如果不配置则Smart-doc默认扫描所有的接口类
// 配置多个报名有英文逗号隔开
// config.setPackageFilters("com.power.doc.controller");
//since 1.7.5
//如果该选项的值为false,则smart-doc生成allInOne.md文件的名称会自动添加版本号
config.setCoverOld(true);
//since 1.7.5
//设置项目名(非必须),如果不设置会导致在使用一些自动添加标题序号的工具显示的序号不正常
config.setProjectName("smart-doc测试接口文档");
//设置公共请求头.如果不需要请求头,则无需设置
// config.setRequestHeaders(
// ApiReqHeader.header().setName("access_token").setType("string")
// .setDesc("Basic auth credentials").setRequired(true).setSince("v1.1.0"),
// ApiReqHeader.header().setName("user_uuid").setType("string").setDesc("User Uuid key")
// );
long start = System.currentTimeMillis();
//生成Markdown文件
ApiDocBuilder.buildApiDoc(config);
long end = System.currentTimeMillis();
DateTimeUtil.printRunTime(end, start);
}
生成HTML文件
/**
* 生成HTML文件
*/
public void testBuilderHtmlControllersApi() {
ApiConfig config = new ApiConfig();
config.setServerUrl("http://192.168.6.110:8080");
//设置为严格模式,Smart-doc将降至要求每个Controller暴露的接口写上标准文档注释
config.setStrict(false);
//当把AllInOne设置为true时,Smart-doc将会把所有接口生成到一个Markdown、HHTML或者AsciiDoc中
config.setAllInOne(true);
//HTML5文档,建议直接放到src/main/resources/static/doc下,Smart-doc提供一个配置常量HTML_DOC_OUT_PATH
config.setOutPath(DocGlobalConstants.HTML_DOC_OUT_PATH);
config.setProjectName("XXXXXX接口文档");
// 设置接口包扫描路径过滤,如果不配置则Smart-doc默认扫描所有的接口类
// 配置多个报名有英文逗号隔开
//config.setPackageFilters("com.power.doc.controller");
//设置公共请求头.如果不需要请求头,则无需设置
// config.setRequestHeaders(
// ApiReqHeader.header().setName("access_token").setType("string")
// .setDesc("Basic auth credentials").setRequired(true).setSince("v1.1.0"),
// ApiReqHeader.header().setName("user_uuid").setType("string").setDesc("User Uuid key")
// );
//设置错误错列表,遍历自己的错误码设置给Smart-doc即可
// List<ApiErrorCode> errorCodeList = new ArrayList<>();
// for (ErrorCodeEnum codeEnum : ErrorCodeEnum.values()) {
// ApiErrorCode errorCode = new ApiErrorCode();
// errorCode.setValue(codeEnum.getCode()).setDesc(codeEnum.getDesc());
// errorCodeList.add(errorCode);
// }
// //不需要显示错误码,则可以设置
// config.setErrorCodes(errorCodeList);
long start = System.currentTimeMillis();
//生成HTML5文件
HtmlApiDocBuilder.buildApiDoc(config);
long end = System.currentTimeMillis();
DateTimeUtil.printRunTime(end, start);
}