Quarkus Swagger MongoDB ObjectId 格式

Quarkus Swagger MongoDB ObjectId Format

我正在使用 quarkus-resteasy 和 mongodb 编写应用程序。安装 quarkus OpenAPI 后,我看到 swagger UI 没有正确显示 ObjectID 格式。

我想看到类似“61338f5b47bfc65136b5de30”的内容。如何全局设置ObjectID输出格式?

因为 objectId 就是它的本质,所以里面有字段以及 openapi 正在解释的内容。

您可以覆盖使用 @Schema 注释生成的内容,提供格式、示例和类型(在本例中为字符串),您可以控制 swagger 将包含的内容。

@Schema(description = "Identifier of the Whatever", type = SchemaType.STRING, format = "XXXXXX", example="<Insert and example here>")

因为这是一个值而不是您可以修改的 class 我认为您需要将此注释放在所有使用这些类型的 DTO 中。

另一种选择是使用 Wrapper 对象,但这可能会根据您的实现方式修改您的 json 结构。