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

Question

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

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

大摇大摆-ui，他们看起来像这样：

日期：

时间：

我想修改这个显示：

"change_date": "YYYY-MM-DD"
"change_time": "mm:ss"

这是我的 class :

@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

我希望这仍然对您有所帮助。

我正在使用 swagger jersey 2。

我认为 Swagger 目前没有使用 JsonProperty 注释。您仍然可以使用 Swagger 注释指示您需要的属性名称：

@ApiModelProperty(name = "index-url")

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

此致

Answer 2

我们遇到了类似的问题。我们需要将 springfox 版本升级到 2.3.0 ，之前我们使用的是 springfox 2.2.2 版本。在那个旧版本中，swagger 的 @ApiModelPreporty 具有名为 "example" 的属性，它没有做任何事情。从版本 2.3.0 开始，这个 "example" 开始工作。所以当我们将springfox版本升级到2.3.0之后，我们要做的就是如下图。

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

下面是 link 我们发现此信息的来源：

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

Answer 3

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

将 dataType 指定为 String 让我得到了示例。

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

Change model schema for java.sql.Time in swagger-ui

java

swagger-ui

swagger-2.0

springfox