转载地址:http://blog.csdn.net/qq383264679/article/details/50847295
HTTP Methods
HTTP方法映射到资源的CRUD(创建、读取、更新和删除)操作,基本模式如下:
- HTTP GET:读取/列出/检索单个或资源集合。
- HTTP POST:新建资源。
- HTTP PUT:更新现有资源或资源集合。
- HTTP DELETE:删除资源或资源集合。
1.@Produces
@Produces
注释用来指定将要返回给client端的数据标识类型(MIME)。
@Produces
可以作为class注释,也可以作为方法注释,方法的
@Produces
注释将会覆盖class的注释。
a.返回给client字符串类型(text/plain)
- @Produces(MediaType.TEXT_PLAIN)
@Produces(MediaType.TEXT_PLAIN)
b.返回给client为json类型(application/json)
- @Produces(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
测试:
string类型:
- @Path(“say”)
- @GET
- @Produces(MediaType.TEXT_PLAIN)
- public String say() {
- System.out.println(“hello world”);
- return “hello world”;
- }
@Path("say")
@GET
@Produces(MediaType.TEXT_PLAIN)
public String say() {
System.out.println("hello world");
return "hello world";
}
json和bean类型:
- @Path(“test”)
- @GET
- @Produces(MediaType.APPLICATION_JSON)
- public Result<String> test() {
- Result<String> result = new Result<String>();
- result.success(“aaaaaa”);
- return result;
- }
- @Path(“bean”)
- @GET
- @Produces(MediaType.APPLICATION_JSON)
- public UserBean bean() {
- UserBean userBean = new UserBean();
- userBean.setId(1);
- userBean.setUsername(“fengchao”);
- return userBean;
- }
@Path("test")
@GET
@Produces(MediaType.APPLICATION_JSON)
public Result<String> test() {
Result<String> result = new Result<String>();
result.success("aaaaaa");
return result;
}
@Path("bean")
@GET
@Produces(MediaType.APPLICATION_JSON)
public UserBean bean() {
UserBean userBean = new UserBean();
userBean.setId(1);
userBean.setUsername("fengchao");
return userBean;
}
2.@Consumes
@Consumes
与
@Produces
相反,用来指定可以接受client发送过来的MIME类型,同样可以用于class或者method,也可以指定多个MIME类型,一般用于
@PUT
,
@POST
a.接受client参数为字符串类型
- @Consumes(MediaType.TEXT_PLAIN)
@Consumes(MediaType.TEXT_PLAIN)
b.接受clent参数为json类型
- @Consumes(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
3.请求参数注解
@PathParam
获取url中指定参数名称:
- @GET
- @Path(“{username”})
- @Produces(MediaType.APPLICATION_JSON)
- public User getUser(@PathParam(“username”) String userName) {
- …
- }
@GET
@Path("{username"})
@Produces(MediaType.APPLICATION_JSON)
public User getUser(@PathParam("username") String userName) {
...
}
请求url:http://localhost/user/jack时,userName值为jack @QueryParam
获取get请求中的查询参数:
- @GET
- @Path(“/user”)
- @Produces(“text/plain”)
- public User getUser(@QueryParam(“name”) String name,
- @QueryParam(“age”) int age) {
- …
- }
@GET
@Path("/user")
@Produces("text/plain")
public User getUser(@QueryParam("name") String name,
@QueryParam("age") int age) {
...
}
当浏览器请求http://host:port/user?name=rose&age=25时,name值为rose,age值为25。如果需要为参数设置默认值,可以使用
@DefaultValue
,如:
- @GET
- @Path(“/user”)
- @Produces(“text/plain”)
- public User getUser(@QueryParam(“name”) String name,
- @DefaultValue(“26”) @QueryParam(“age”) int age) {
- …
- }
@GET
@Path("/user")
@Produces("text/plain")
public User getUser(@QueryParam("name") String name,
@DefaultValue("26") @QueryParam("age") int age) {
...
}
@FormParam
获取post请求中表单中的数据:
- @POST
- @Consumes(“application/x-www-form-urlencoded”)
- public void post(@FormParam(“name”) String name) {
- // Store the message
- }
@POST
@Consumes("application/x-www-form-urlencoded")
public void post(@FormParam("name") String name) {
// Store the message
}
@BeanParam
获取请求参数中的数据,用实体Bean进行封装:
- @POST
- @Consumes(“application/x-www-form-urlencoded”)
- public void update(@BeanParam User user) {
- // Store the user data
- }
@POST
@Consumes("application/x-www-form-urlencoded")
public void update(@BeanParam User user) {
// Store the user data
}