JAX-RS 2.0 支持4种返回值类型的响应,分别是无返回值、返回Response类实例、返回GenericEntity类实例和返回自定义类实例。
1、在返回值类型是VOID的响应中,其响应实体为空,HTTP状态码为204.
2、在返回值类型为Response的响应中,如该内容为空,则HTTP状态码为204,否则HTTP状态码为200。
示例:
@POST
@Path("a")
public Response get(final String s){
return Response.ok().entity("char[]:"+s).build();
}
Response先定义了HTTP的状态码为OK,然后填充实体信息,最后调用build()方法构建Response实例。
3、GenericEntity作为返回值的情况并不常用。形式是构造一个统一的实体实例并将其返回,实体实例作为第一参数,该实体类型作为第二参数。
示例:
@POST
@Path("a")
public String get(final byte[] bs){
for (final byte b:bs){ Loger.debug(b) };
return "byte[]:"+new String(bs);
}
public GenericEntity<String> get(final byte[] bs){
return new GenericEntity<String>("byte[]:"+new String(bs),String.class);
}
以上示例中第一参数是由byte数组实例用为参数构建的字符串实例,第二个参数是字符串类。
4、自定义类型是JDK中的类都可以作为返回值类型,常用的返回自定义的POJO类型。
示例:
@POST
@Consumes({MediaType.APPLICATION_XML,MediaType.APPLICATION_JSON})
@Produces(MediaType.APPLICATION_XML)
public Book GetEntity(Book book){ return book }//返回自定义的book类
@POST
@Consumes({MediaType.APPLICATION_XML,MediaType.APPLICATION_JSON})
@Produces(MediaType.APPLICATION_XML)
public Book getEntity(JAXBElement<Book> bookElement){
Book book=bookElement.getValue();
return book;
}