OpenAPI3默认数组生成

Question

我的API定义如下：

/api:
  get:
  ...
  parameters:
     - name: "tags"
       in: "query"
       description: "some description"
       required: false
       schema:
         type: "array"
         items:
           type: "string"
  ....

我们使用openapi生成器maven-plugin:3.3.5生成代码。

生成的API参数：@ApiParam（value=“description”，defaultValue=“new ArrayList

控制器接收的实际参数不是空的，并且包含literalnew ArrayList

String first = tags.get(0);
assert "new ArrayList<>()".equals(first) //true

我找不到任何控制此行为的参数值（如defaultValue）。如何使参数为null或至少为空列表？

在Spring boot应用程序中使用sagger：

 <dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>${io.springfox.swagger.version}</version>
</dependency>

openapitools生成器配置选项

  <configOptions>
      <dateLibrary>java8</dateLibrary>
      <serializationLibrary>jackson</serializationLibrary>
      <interfaceOnly>true</interfaceOnly>
      <delegatePattern>true</delegatePattern>
      <useTags>true</useTags>
  </configOptions>




Answer 1

这里有同样的问题，但无法使其工作。但您可以添加一些验证来查看列表是否至少包含一个元素，例如。

/api:
  get:
  ...
  parameters:
   - name: "tags"
     in: "query"
     description: "some description"
     required: false
     schema:
       type: "array"
       minItems: 1
       items:
         type: "string"
  ....

Answer 2

较新的生成器版本已经修复了此问题：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>4.3.0</version>
    ...
</plugin>

另外，添加Jackson数据库为空

 <dependency>
  <groupId>org.openapitools</groupId>
  <artifactId>jackson-databind-nullable</artifactId>
  <version>0.2.1</version>
</dependency>