在 swagger-ui 中更改 java.sql.Time 的模型模式

Question

在我的 spring-boot 应用程序中，我使用 swagger2 来记录 Web 服务。

我使用一些具有 java.sql.Time 和 java.util.Date 属性的类。

在 swagger-ui 中，它们看起来像这样：

日期 ：

时间 ：

我想修改它以显示：

• “change_date”：“YYYY-MM-DD”

• “change_time”：“mm：ss”

这是我的课：

@lombok.Data
@JsonRootName("translation_value")
@ApiModel(value="TranslationValue", description="Traduction de valeur")
public class TranslationValue implements Serializable {

@JsonProperty("translation_id") private Integer translationId;
@JsonProperty("family") private String family;
@JsonProperty("language_code") private String languageCode;
@JsonProperty("value") private String value;
@JsonProperty("translation_language_code") private String translationLanguageCode;
@JsonProperty("translation_value") private String translationValue;
@JsonProperty("delivered") private String delivered;
@JsonProperty("creation_date") private Date creationDate;
@JsonProperty("creation_time") private Time creationTime;
@JsonProperty("creation_user") private String creationUser;
@JsonProperty("change_date") private Date changeDate;
@JsonProperty("change_time") private Time changeTime;
@JsonProperty("change_user") private String changeUser;
@JsonProperty("status") private String status;
@JsonProperty("orignal_translation_id") private Integer orignalTranslationId;
}

我怎样才能做到这一点 ？ 我没有找到任何注释来设置格式。

Answer 1

我们有类似的问题。 我们需要将springfox版本升级到2.3.0，之前我们正在使用springfox 2.2.2版本。 在那个旧版本中，swagger的@ApiModelPreporty具有名为“ example”的属性，它没有执行任何操作。 从2.3.0版开始，此“示例”开始工作。 因此，在将springfox版本升级到2.3.0之后，我们要做的就是如下所示。

@ApiModelProperty(required = true,example = "2016-01-01")
@JsonFormat(pattern = DATE_FORMAT)
private LocalDate date; 

以下是我们从中找到此信息的链接：

https://github.com/springfox/springfox/issues/998

Answer 2

希望对您有所帮助。

我正在使用宽大的球衣2。

我认为Swagger目前未使用JsonProperty批注。 仍然可以使用Swagger注释指示所需的属性名称：

@ApiModelProperty(name = "index-url")

这是双重工作，但这是我能找到的唯一解决方案。

问候

Answer 3

@ApiModelProperty(value = "description", name = "notificationExpiryDate",
            dataType = "String", example = "2022-01-16T08:42:37.484Z")
private Timestamp expiryDate;

将 dataType 作为 String 让我得到了这个例子。