如何让springdoc-openapi在不更改toString的情况下使用@JsonValue枚举格式？

springdoc-openapi 是一个开源的 Spring Boot 插件，用于生成 OpenAPI 文档。它可以通过自动生成 API 文档来简化开发过程，提高开发效率。在使用 springdoc-openapi 时，如果想要在不修改枚举类的 toString 方法的情况下使用 @JsonValue 注解来指定枚举的序列化格式，可以按照以下步骤进行操作：

创建枚举类，并使用 @JsonValue 注解来标注需要作为枚举值的字段。这个注解用于指定在序列化枚举时使用的字段值。

public enum MyEnum {
    VALUE1("Value 1"),
    VALUE2("Value 2");

    private final String value;

    MyEnum(String value) {
        this.value = value;
    }

    @JsonValue
    public String getValue() {
        return value;
    }
}

在 Spring Boot 应用的配置类中，通过使用 Jackson 库的 ObjectMapper 对象来注册自定义的枚举序列化器。

@Configuration
public class JacksonConfiguration {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule module = new SimpleModule();
        module.addSerializer(MyEnum.class, new MyEnumSerializer());
        objectMapper.registerModule(module);
        return objectMapper;
    }
}

创建一个自定义的枚举序列化器来实现枚举的序列化逻辑。这个序列化器需要继承 JsonSerializer 并实现其中的 serialize 方法。

public class MyEnumSerializer extends JsonSerializer<MyEnum> {
    @Override
    public void serialize(MyEnum value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeString(value.getValue());
    }
}

使用 @Schema 注解来指定枚举字段的类型和描述信息。在 API 文档中，这些注解会被解析并生成相应的文档内容。

public class MyModel {
    @Schema(type = "string", description = "MyEnum value")
    private MyEnum myEnum;
    
    // other fields and methods
}

通过以上步骤，就可以在不修改枚举类的 toString 方法的情况下，使用 @JsonValue 枚举格式，并且生成符合要求的 API 文档。另外，推荐使用腾讯云的相关产品 Tencent Cloud API Gateway，用于构建和管理 API 网关，实现灵活的流量控制、访问授权和 API 文档管理等功能。