swagger导出Word接口文档

pom增加依赖

<repositories>
		<repository>
			<snapshots>
				<enabled>trueenabled>
				<updatePolicy>alwaysupdatePolicy>
			snapshots>
			<id>jcenter-releasesid>
			<name>jcentername>
			<url>http://jcenter.bintray.comurl>
		repository>
	repositories>
<dependency>
			<groupId>io.github.swagger2markupgroupId>
			<artifactId>swagger2markupartifactId>
			<version>1.3.3version>
		dependency>

测试类

@Test
	public void generateMarkdownDocsToFile() throws Exception {
		//    输出Markdown到单文件
		Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder()
				.withMarkupLanguage(MarkupLanguage.MARKDOWN)
				.withOutputLanguage(Language.ZH)
				.withPathsGroupedBy(GroupBy.TAGS)
				.withGeneratedExamples()
				.withoutInlineSchema()
				.build();

		Swagger2MarkupConverter.from(new URL("http://localhost:8080/myproject/v2/api-docs"))
				.withConfig(config)
				.build()
				.toFile(Paths.get("./docs/markdown/generated/all"));
	}

输入命令:mvn clean test
会在根目录下生成docs文件夹,里面就有生成的文件
swagger导出Word接口文档_第1张图片
虽然是md格式,但是有一个神器网站:http://coolaf.com/tool/md 把md格式的文件复制进去,下载下来即可.

你可能感兴趣的:(项目总结)