java springdoc@ApiResponse ses如何使用将List定义为返回对象

Question

我正在使用SpringBoot与以下依赖关系

    <dependency>
        <groupId>org.springdoc</groupId>
        <artifactId>springdoc-openapi-ui</artifactId>
        <version>1.5.12</version>
    </dependency>

控制器类(@RestController)有一个入口点(@GetMapping)，这个入口点应该返回一个对象列表:MyClass.java。为了通过swagger UI页面创建API文档，我在方法上方添加了Swagger注释。

招摇文档应指示返回对象的类型

列表

但是我应该怎么做呢？如果我这样做

" @Schema(implementation = List

存在编译错误。

Swagger注释:

@Operation(....)
@ApiResponses(value = {
        @ApiResponse(responseCode = "200", description = "successful operation",
                content = { @Content(mediaType = "application/json",
                        schema = @Schema(implementation = ????)) }),
        @ApiResponse(...),
        @ApiResponse(...)

@GetMapping(value = "/aaa", produces = MediaType.APPLICATION_JSON_VALUE)
public List<MyClass> getAaa(...)
{
    return ...
}

Answer 1

您需要为此使用ArraySchema注释并将其分配给array属性，而不是@Content注释的Schema属性。您不需要指定List. class只需要它的类型参数MyClass.class。

    @Operation(
            summary = "Get a list of users",
            description = "Get a list of users registered in the system",
            responses = {@ApiResponse(
                    responseCode = "200",
                    description = "The response for the user request",
                    content = {
                            @Content(
                                    mediaType = "application/json",
                                    array = @ArraySchema(schema = @Schema(implementation = User.class))
                            )
                    })
            }
    )
    @GET
    @SecurityRequirement(name = "JWT")
    @Path("/user")
    public List<User> getUsers() {
        return null;
    }