在DTO上配置Swagger javax验证约束

Question

我使用的是Swagger（1.5.8），我想让我的swagger.json定义检测DTO上的javax.validationJSR-303注释，这样我就可以记录API的验证约束。

我希望@Min注释（如本例）会显示关于最小值（44）的一些信息，但它不会。

@POST
@ApiOperation(value = "post", httpMethod = "POST")
public Response post(
        @QueryParam("id") @NotNull @Min(44) Integer id) {...}

由此产生的swagger.json是：

"/foo": {
  "post": {
    "operationId": "post",
    ...
    "parameters": [
      {
        "in": "body",
        "name": "id",
        "description": "id",
        "required": false,
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      }

Swagger已经关闭了该功能的拉取请求，但我不清楚它在Swagger定义中的位置/方式。

我希望能够做这样的事情：

@POST
public void postFoo(@Valid @RequestBody FooDTO fooDto) {...}

public class FooDTO {
    @NotNull
    @Size(min = 1, max = 100)
    private Integer myInt;
}

"FooDTO": {
  "type": "object",
  "required": [
    "myInt"
  ],
  "properties": {
    "myInt": {
      "type": "number",
      "format": "integer",
      "minimum": "1",
      "maximum": "100",
 ...

配置Swagger模块/插件以启用ModelResolver和BeanValidator等功能的首选方法是什么，以便他们检查我的DTO上的注释？

Answer 1

我浏览了留档。从我的角度来看，在swagger 1. x中，您必须使用@QueryParam验证和@ApiParam，就像在这个测试用例中：

@GET
@Path("/swagger-and-303")
@ApiOperation(value = "Get",
        httpMethod = "GET")
public Response getTestSwaggerAnd303(
        @ApiParam(value = "sample param data", required = false, allowableValues = "range[7, infinity]")
        @QueryParam("id") @NotNull @Min(5) Integer id) throws WebApplicationException {...`

另外，您可以尝试在您的特定情况下使用@ApiIncectParam。

Answer 2

截至目前，Swagger Core版本1.5.19的最新版本完美地支持这一点：

DTO对象与此类似：

public class SampleDTO {

    @Min(value = 5)
    @Max(value = 10)
    @NotNull
    private Integer integer;

    @NotNull
    private String string;

    //...

}

会让人大摇大摆。json与此类似：

...

 "definitions" : {
    "SampleDTO" : {
      "type" : "object",
      "required" : [ "integer", "string" ],
      "properties" : {
        "integer" : {
          "type" : "integer",
          "format" : "int32",
          "minimum" : 5,
          "maximum" : 10
        },
        "string" : {
          "type" : "string"
        },

...