java - 将对象转换为多查询参数Swagger

Question

我正在尝试使用对象的查询参数生成 swagger 文档，但我不确定 springdoc-openapi 是否可以。我知道这可以通过 io.springfox 实现。

我想要的是创建一个对象，将所有字段添加到该对象，然后将这些字段作为单独的查询参数显示在 swagger 文档中。

例如测试用例:

1. 测试用例 1
   对于以下代码:
   
   生成以下 swagger 文档:
   

2. 测试用例 2: 对于以下代码:
   
   生成以下 swagger 文档:
   

在这两种情况下，服务都可以按照查询参数的预期工作。我想要的是让测试用例 2 中的代码从测试用例 1 生成相同的文档。我知道这对于 springfox 是可能的，但我不知道如何在 springdoc-openapi 中做到这一点。

Answer 1

要实现此目的，您需要使用 @ParameterObject 注释来修饰 TestCase 类:

@ParameterObject
public class TestCase {
    @Parameter
    String field1;
    @Parameter
    String field2;
    @Parameter
    String field1;
}