swagger-jaxrs @ApiModelProperty AllowableValues是否可以與「range [x，y]」一起使用？

Question

我一直沒能得到以下產生任何結果：

@ApiModelProperty(allowableValues = "range[0,8]", required = true) 
private String myfield; 

這工作：

@ApiModelProperty(allowableValues = "Email, Post", required = true) 
private String multiValField; 

併產生（在UI）：

multiValField(string) = ['Email' or ' Post'] 

我可能會誤讀文檔，這是來自ApiModelProperty中的javadoc：

要設置一系列值，請以「範圍」開始值，方括號周圍的值包括最小值和最大值。 例如：範圍[1，5]。要設置最小/最大值，請使用 與範圍相同的格式，但使用「infinity」或「-infinity」作爲第二個值 。例如，範圍[1，∞，表示該參數的 允許的最小值爲1

我找不到人做任何的例子，雖然它看起來這將是常見的。我確實在@ApiParam的modules/swagger-jaxrs/src/test/scala/testresources/ResourceWithReturnTypes.java中找到了這個，但是我無法在我的GET端點上正常工作。

@ApiParam(value = "sample param data", required = true, 
allowableValues = "range[0,10]") 
@DefaultValue("1") @QueryParam("id") String id) { 

有沒有人有這個工作的一些版本？

Answer 1

招搖核心項目中包含一組樣本。在@ApiParam和@ApiModelProperty中都展示了range的用法。

@ApiModelProperty可以在這裏看到 - https://github.com/swagger-api/swagger-core/blob/master/samples/scala-oauth-authorization-server/src/main/scala/com/wordnik/swagger/sample/model/Pet.scala#L30。可以在這裏看到@ApiParam - https://github.com/swagger-api/swagger-core/blob/master/samples/java-jaxrs/src/main/java/com/wordnik/swagger/sample/resource/PetStoreResource.java#L42。

所有示例都包含有關如何在本地運行它們的簡單詳細信息，並且它們按照預期值輸出minimum和maximum值。