Swagger2Markup：使用Swagger远程endpoint从测试时如何按标签分组？

Question

我正在使用伟大的swagger2markup插件为我的RESTAPI生成Asciidoc文档，正如Swagger提供的那样。我遵循了swagger2markup文档，并使用Spring MVC集成测试从我的Springfox Swaggerendpoint生成如下标记（我使用Maven）：

@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest(classes = { AppConfig.class, SwaggerConfig.class })
public class DocumentationIT {

    protected MockMvc mockMvc;

    @Autowired
    protected WebApplicationContext webApplicationContext;

    @Rule
    public JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation("src/docs/asciidoc/apidoc/generated-snippets");

    @Before
    public void setUp(){
        this.mockMvc = MockMvcBuilders.webAppContextSetup(webApplicationContext)
                .apply(documentationConfiguration(this.restDocumentation))
                .build();
    }

    @Test
    public void convertSwaggerToAsciiDoc() throws Exception {
        this.mockMvc.perform(get("/v2/api-docs")
                .accept(MediaType.APPLICATION_JSON))
                .andDo(
                        Swagger2MarkupResultHandler
                                .outputDirectory("src/docs/asciidoc/apidoc")
                                .withExamples("src/docs/asciidoc/apidoc/generated-snippets").build())
                .andExpect(status().isOk());
    }
}

一切都很好，我所有的路径都在我的最终留档中，但是路径都直接出现在根目录上，并且不按资源分组（即按控制器），因此Controller 1中的方法1将与Controller 2中的方法2显示在同一级别。

我的输出：

我想要的是：

从我所看到的情况来看，当像在这个swagger2 markup Maven项目模板中那样使用从本地文件生成时，可以指定一个属性，告诉swagger2markup使用config属性对路径进行分组

我错过什么了吗？

Answer 1

正如您所提到的，有一个属性是swagger2markup。pathsGroupedBy由swagger2Markup提供，用于指定路径的分组方式。但是，Swagger2MarkupResultHandler不提供API来支持配置。

根据Swagger2Markup API，

Swagger2Markup的属性是在2mark. Swagger2MarkupPropertiesio.github.swagger类中定义的。这些属性按以下顺序考虑：

>

Java系统属性

自定义属性

默认属性（包含在Swagger2Markup中）

可以使用系统属性来配置它。因此，您可以在测试中将swagger2markup.pathsGroupeBy的系统属性设置为TAGS。

如果您喜欢使用JavaAPI配置它，您可以扩展Swagger2MarkupResultHandler并使用Swagger2MarkupConfigBuilder API覆盖句柄方法。