我怎样才能让Quarkus大摇大摆地识别JsonSerialize(as=)、JsonDeserialize(as=)

Question

我使用Quarkus 1.10.3.final（包括quarkus-resteasy-jackson和quarkus-smallrye-openapi）和Immutables库(org.immmutables:value:2.8.8)来定义各种应用程序模型。我的问题是，大摇大摆的UI似乎不能识别标准的jackson@jsonSerialize(as=)和@jsonDeserialize(as=)注释。

在下面定义的模型示例中，我希望在Swagger UI页面的components部分中看到四（4）个字段。

@JsonIgnoreProperties(ignoreUnknown = true)
@JsonDeserialize(as = ImmutableFieldMetaData.class)
@JsonSerialize(as = ImmutableFieldMetaData.class)
@Value.Immutable
public interface FieldMetaData {
  String field();
  String type();
  Boolean deprecated();
  String description();
}

Swagger UI中的这个问题在Swagger UI1.5.14版本中得到了解决，随后在Swagger UI2.0版本中被删除，然后在2.1版本中再次得到修复。

null

Answer 1

在深入研究smallrye-openapi的源代码之后，可以向每个不可变字段添加@schema注释，即。

@JsonIgnoreProperties(ignoreUnknown = true)
@JsonDeserialize(as = ImmutableFieldMetaData.class)
@JsonSerialize(as = ImmutableFieldMetaData.class)
@Value.Immutable
@Schema(implementation = ImmutableFieldMetaData.class)
public interface FieldMetaData {
  String field();
  String type();
  Boolean deprecated();
  String description();
}

如果需要，您也可以将字段注释为@schema。