Swagger 如何记录我不知道的对象'；你没有所有权吗？

我在方法端点中返回一个

页面

。在我的OpenAPI UI中，如何生成来自

org.springframework.data.domain.Page

类型的字段描述。 通常我要做的是转到我要记录的对象，并用

@Schema（description=“some description”）

注释其字段。但是我没有访问

页面

类的权限。如何记录其字段

我可能错过了一些简单的东西，但任何帮助都将不胜感激

---

PS：我正在使用OpenAPIv3和springdoc

您可以使用OpenApiCustomiser

例如，假设您有一个控制器：

@RestController 公共类Hello控制器{

@GetMapping("/hello")
Page<PersonDTO> getPage() {
    return null;
}

相同的逻辑适用于您需要自定义的任何其他属性

@Bean
public OpenApiCustomiser pageableOpenApiCustomiser() {
    return openApi -> {
        Schema pageableSchema = openApi.getComponents().getSchemas().get("Pageable");
        pageableSchema.setDescription("my description");
    };
}