Spring Boot 项目时用 Swagger2Markup 生成静态文档遇到的问题
代码:
@Test
public void remoteSwaggerFile() throws MalformedURLException {
URL remoteSwaggerFile = new URL("http://localhost:8888/v2/api-docs");
Path outputDirectory = Paths.get("src/docs/asciidoc/generated");
// 输出Ascii格式
Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder()
.withMarkupLanguage(MarkupLanguage.ASCIIDOC)
.build();
Swagger2MarkupConverter.from(remoteSwaggerFile)
.withConfig(config)
.build()
.toFolder(outputDirectory);
}
运行报错
java.lang.NoClassDefFoundError: nl/jworks/markdown_to_asciidoc/Converter
原因在于 nl/jworks/markdown_to_asciidoc/Converter 在 maven center 中没有.
解决方法:添加阿里的jcenter镜像
打开 settings.xml(.m2目录下)
在<mirrors>标签里加上
<mirror>
<id>nexus-aliyun</id>
<mirrorOf>*</mirrorOf>
<name>Nexus aliyun</name>
<url>https://maven.aliyun.com/repository/jcenter</url>
</mirror>