使用Springfox为Rest web服务创建pdf

Question

我使用的是Spring（不是Spring boot）、Maven和Springfox。使用最后一个插件，我可以通过URL/swagger ui显示web服务文档。html但我需要一个文档来共享。我读到了＜code＞Swagger2Markup＜/code＞的内容，因此我将此依赖项导入到pom文件中：

    <dependency>
        <groupId>io.github.swagger2markup</groupId>
        <artifactId>swagger2markup</artifactId>
        <version>1.3.1</version>
    </dependency>

和此存储库

<repositories>
    <repository>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
        <id>jcenter-releases</id>
        <name>jcenter</name>
        <url>http://jcenter.bintray.com</url>
    </repository>
</repositories>

至此，我已经创建了一个测试类:

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes = {AppConfig.class, SwaggerConfig.class})
@WebAppConfiguration
public class Swagger2MarkupTest {

    @Autowired
    private WebApplicationContext context;

    private MockMvc mockMvc;

    @Before
    public void setUp() {
        this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context).build();
    }

    @Test
    public void convertSwaggerToAsciiDoc() throws Exception {
        String outputDir = ("C:/Users/Luca Calicchio/Downloads");
        MvcResult mvcResult = this.mockMvc.perform(get("/v2/api-docs")
                .accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andReturn();

        MockHttpServletResponse response = mvcResult.getResponse();
        String swaggerJson = response.getContentAsString();
        Files.createDirectories(Paths.get(outputDir));
        try (BufferedWriter writer = Files.newBufferedWriter(Paths.get(outputDir, "swagger.json"), StandardCharsets.UTF_8)){
            writer.write(swaggerJson);
        }
    }
}

这个类创建了一个带有文档的json文件，现在我必须将这个文件转换为pdf。我还没有找到这一步骤的指南，只有这一指南

>

在单元或集成测试期间生成最新的 Swagger JSON 文件

将 Swagger JSON 文件转换为 AsciiDoc

添加手写的AsciiDoc文档

将HTML和PDF工件复制到一个可执行的Spring Boot Jar文件中，并将其作为静态内容

你能帮助我吗？

Answer 1

https://github.com/Swagger2Markup/spring-swagger2markup-demo

注意pom.xml文件，它配置了上述所有步骤