Swagger UI中的多级（嵌套）标记

我最近刚开始研究Swagger 2.0 API。我正在寻找一些方法来组织API文档

目前我正在使用

@Api（tags={“Heading1”}）

Java注释来标记每个Api。生成的文档如下所示

Tasks
--------->Heading1
          -------->Desc1
          --------->Desc2
---------->Heading2
          --------->Desc3
          --------->Desc4

Tasks
--------->Heading1
          -------->Desc1
          --------->SubHeading1
                        --------->Desc2
---------->Heading2
          --------->SubHeading1
                     --------->Desc3 
          --------->SubHeading1
                     --------->Desc4

我想在文件中加一些副标题，这样看起来

Tasks
--------->Heading1
          -------->Desc1
          --------->Desc2
---------->Heading2
          --------->Desc3
          --------->Desc4

Tasks
--------->Heading1
          -------->Desc1
          --------->SubHeading1
                        --------->Desc2
---------->Heading2
          --------->SubHeading1
                     --------->Desc3 
          --------->SubHeading1
                     --------->Desc4

---

如何实现这一点？

OpenAPI规范不支持嵌套标记。下面是相应的功能请求：

您可以尝试通过将标记命名为

tag1/tag2

、

tag1.tag2

、

tag1 | tag2

或类似的方式来模拟嵌套标记，但您还必须修改工具以将此类名称作为嵌套标记处理

对于大摇大摆的UI用户，请注意：有一个功能要求支持使用标签名的嵌套标签，其格式为

tag1 | tag2

或类似：

---

以下是关于这项任务的对话：