如何使用可选参数创建REST API?

时间:2016-03-01 05:18:04

标签: java rest jax-rs

我需要使用这些路径参数实现API。

@Path("/job/{param1}/{optional1}/{optional2}/{param2}")

可选择第二和第三个参数吗?所以客户端不需要传递这些,但必须传递第一个和最后一个。

如果不可能,那么建议以这种方式重新排列参数吗?

@Path("/job/{param1}/{param2}/{optional1}/{optional2}")

如何提供可选参数?

3 个答案:

答案 0 :(得分:14)

将可选路径参数转换为查询参数可能更容易。然后,如果需要,您可以使用@DefaultValue

@GET @Path("/job/{param1}/{param2}")
public Response method(@PathParam("param1") String param1,
    @PathParam("param2") String param2,
    @QueryParam("optional1") String optional1,
    @QueryParam("optional2") @DefaultValue("default") String optional2) {
  ...
}

然后,您可以使用/job/one/two?optional1=test调用它,只传递您需要的可选参数。

答案 1 :(得分:3)

您可以匹配以REST请求结尾的整个路径

@Path("/location/{locationId}{path:.*}")
public Response getLocation(
    @PathParam("locationId") int locationId,
    @PathParam("path") String path) {
    //your code
}

现在路径变量包含location/{locationId}

之后的整个路径

您还可以使用正则表达式使路径可选。

@Path("/user/{id}{format:(/format/[^/]+?)?}{encoding:(/encoding/[^/]+?)?}")
public Response getUser(
    @PathParam("id") int id,
    @PathParam("format") String format,
    @PathParam("encoding") String encoding) {
    //your code
}

现在,如果您格式化,编码将是可选的。你没有给出任何价值,他们将是空的。

答案 2 :(得分:1)

重新排列参数并尝试以下操作:

@Path("/job/{param1}/{param2}{optional1 : (/optional1)?}{optional2 : (/optional2)?}")
public Response myMethod(@PathParam("param1") String param1,
                         @PathParam("param2") String param2,
                         @PathParam("optional1") String optional1,
                         @PathParam("optional2") String optional2) {
    ...
}