Swagger ui - 查询参数

时间:2015-07-01 19:05:22

标签: java rest swagger swagger-ui jersey-1.0

我使用Swagger ui和Swagger core(1.3)进行平针织应用。我有一些查询参数,我必须发送每个请求,如post,get,delete ...

我该如何默认?

2 个答案:

答案 0 :(得分:7)

您可以使用Swagger注释中的注释@ApiParam来配置要在Swagger-UI中使用的查询参数。

例如

@Path("/{username}")
@ApiOperation(value = "Updated user")
public Response updateUser(
  @ApiParam(value = "description for query-parameter") @QueryParam("username") String username
) {
...
}

请在以下官方文档中阅读有关此注释的更多信息: https://github.com/swagger-api/swagger-core/wiki/Annotations#apiparam

答案 1 :(得分:0)

你不能,但是自从swagger 2.0(我不知道swagger-code / swagger-ui是否支持),你可以定义parameters to be reuse across operations

例如:

{
  "parameters": {
    "pageParam": {
      "name": "page",
      "in": "query",
      "description": "page number to get",
      "required": false,
      "type": "integer",
      "format": "int32"
    }
  },
  "paths": {
    "/customers": {
      "get":  {
        "description": "Retrive list of customers",
        "parameters": {
          "$ref": "#/parameters/pageParam"
        },
        ...
      }
    }
  },
  ...
}