RESTEasy:@FormParam、@PathParam、@QueryParam、@HeaderParam、@CookieParam、@MatrixParam说明

在第一RESTEasy教程我们已经学习了基本的Web服务和休息我们已经测试了一个简单的REST风格的Web服务。在本教程中，我们将
显示如何将Web应用程序元素（形式参数，查询参数和更多）为REST风格的Web服务。
你可以使用下面的注释绑定HTTP请求REST风格的Web服务：

@FormParam
@PathParam
@QueryParam
@HeaderParam
@CookieParam
@MatrixParam

让我们探索所有可能的相互作用。

@FormParam

@formparam可以用来注入web表单的参数为REST风格的Web服务。

下面是一个例子：



在这里，我们提交一个后请求包含两个参数的电子邮件和密码
是转化为参数的“E”和“P”的登录方法。
这里是完整的例子：

<form method="POST" action="login">
Email Address: <input type="text" name="email"><br>
Password:      <input type="text" name="password">
<input type="submit">
</form>

@Path("/")
public class LoginService
{
　　@POST

　　@Path("login")

　　public String login(@FormParam("email") String e, @FormParam("password") String p) {
　　　　return "Logged with " + e + " " + p;
　　}
}

作为一种替代方法，您可以在类级别上绑定参数电子邮件和密码，如果您需要在不同的其他参数重新使用相同的参数，可以使用它是有用的
服务方法。

public class User {
@FormParam("email")
private String email;

@FormParam("password")
private String password;
}

你需要修改相应的方法：

@POST
@Path("login")
public String login(@Form User form) {
return "Logged with " + form.email + " " + form.password;
}

@PathParam

@pathparam标注绑定一个路径段资源的方法参数的值。例如，下面的方法将拦截HTTP GET http://server:port/login/12345
“12345”@pathparam转换为字符串“id”

@Path("/")
public class LoginService
{
@GET
@Path("login/{zip}")
public String login(@PathParam("zip") String id) {
return "Id is " +id;
}
}

作为@formparam，你可以嵌入@pathparam声明在类级别上，如果你喜欢。

@QueryParam

@queryparam　　标注绑定一个路径段资源的方法参数的值。例如，下面的方法将拦截HTTP GET http://server:port/login?zip=12345 和
将查询参数 “zip” 注入到方法参数 “zip”

@Path("/")
public class LoginService
{
@GET
@Path("login/{zip}")
public String login(@QueryParam("zip") String zip) {
return "Id is " +id;
}
}

@queryparam可以方便快捷使用defaultValue标注以便你能如果没有查询参数是通过避免空指针异常。

@GET
@Path("login/{zip}")
public String login(@DefaultValue("11111") @QueryParam("zip") String zip) {
return "Id is " +id;
}

作为@formparam，你可以嵌入@pathparam声明在类级别上，如果你喜欢。

@HeaderParam

@headerparam　　标注提取　　HTTP标头（ HTTP header）并将它绑定到一个方法的参数。

例子:

@GET
public String callService(@HeaderParam("User-Agent") String whichBrowser) {
...
}

@CookieParam

@cookieparam注释读取信息存储为一个cookie，并将它绑定到一个方法的参数。例子:

@GET
public String callService(@CookieParam("sessionid") String sessionid) {
...
}

@MatrixParam

@matrixparam注释可以用来绑定包含多个 property (属性)=value(值) 方法参数表达式。例如，假设你要调用一个网址　　 http://server:port/login?name=francesco&surname=marchioni

@GET
public String callService(@MatrixParam("name") String name,
@MatrixParam("surname") String surname) {
...
}