OpenApi（Swagger）枚举显示名称

Question

例如：

@AllArgsConstructor
@Getter
@JsonbTypeAdapter(MyEnumAdapter.class)
@Schema(implementation = MyEnum.class)
public enum MyEnum{
    V1("displayname v1"),
    V2("displayname v2"),
    V3("displayname v3");

    private final String name;

    @Nullable
    public static MyEnumfromString(String name) {
        return Arrays.stream(values()).filter(u -> u.getName().equalsIgnoreCase(name)).findFirst().orElse(null);
    }


}

Swagger这样显示枚举：

MyEnum string
Enum:
[ V1, V2, V3 ]

我想要的是：

 MyEnum string
 Enum:
 [ "displayname V1", "displayname V2", "displayname V3" ]

API返回“显示名称”，然而，Swagger显示“枚举名称”，这经常导致混淆。有可能改变狂妄的价值观吗？

Answer 1

public Object ...(@QueryParam(...)
                  @ApiParam(name = ..., value = "...", 
                            allowableValues = "displayname v1, displayname v2, displayname v3")
                  MyEnum myEnum) {