招摇过市批注未生成预期结果

我找到了这个问题的原因,它位于Springfox库中的Swagger2JacksonModule类中,有一个基于值的方法检查:

 private boolean isNotJsonString(final String value) throws IOException {
    // strictly speaking, should also test for equals("null") since {"example": null} would be valid JSON
    // but swagger2 does not support null values
    // and an example value of "null" probably does not make much sense anyway
    return value.startsWith("{")                              // object
        || value.startsWith("[")                          // array
        || "true".equals(value)                           // true
        || "false".equals(value)                          // false
        || JSON_NUMBER_PATTERN.matcher(value).matches();  // number
  }

这只检查值,但忽略注释上声明的数据类型。

您可以在@ApiModelProperty中使用“dataType”元素属性。

@ApiModelProperty(datatype= "String", example="484799")
private String accountNumber;

或

@ApiModelProperty(datatype= "java.lang.String", example="484799")
private String accountNumber;

如果您使用的是Swagger2,那么@Schema是可选的。 https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X---Annotations#schema

也许你可以用 String.format() 下面类似的方式。

String example="484799"
private String accountNumber = String.format("%s", example)