Jersey Response响应请求

Chapter2-3 Jersey Response响应请求

前面介绍的Jersey示例，是根据实际需求返回结果，但我们实际在开发中一般不采用这种方式进行开发，在响应客户端请求时，我们使用Response进行响应请求。
javax.ws.rs.core.Response 官方Response Api

Response设置响应状态码

前面的示例中默认都是响应状态码是200，通过Response类，我们可以很方便的根据我们需求响应不同的状态码。
在Response 类中有内部的静态枚举Status，用于描述不同的响应状态码。常用的有。
OK(200, “OK”), 请求成功 需要我们手动响应
NO_CONTENT(204, “No Content”),无返回数据
BAD_REQUEST(400, “Bad Request”),请求错误 一般由于请求参数有误造成 需要我们手动响应
UNAUTHORIZED(401, “Unauthorized”),无权限 一般是由于没有登陆 需要我们手动响应
FORBIDDEN(403, “Forbidden”), 被禁止，无权限，一般是由于没有设置访问权限 需要我们手动响应
NOT_FOUND(404, “Not Found”), 未找到路径
METHOD_NOT_ALLOWED(405, “Method Not Allowed”),
INTERNAL_SERVER_ERROR(500, “Internal Server Error”),服务器异常 需要我们手动响应

@GET@Path("/getAll")public Response getAllBad(String userId){    try {        if(userId == null){            //请求参数有误，响应400 错误请求            return Response.status(Response.Status.BAD_REQUEST).build();        }        List<Student> lists = new ArrayList<Student>(map.values());    }catch (Exception e){        //当服务器抛出异常时会响应500        return Response.status(Response.Status.INTERNAL_SERVER_ERROR).build();    }    //正常响应200    return Response.status(Response.Status.OK).build();}

上面的示例代码中，当请求参数userId为空时，服务器会响应400，当服务器抛出异常时，服务器会响应500，当一切响应正常时，服务器响应200。

Response响应JSON数据

在RESTful服务中，通常服务器是通过json数据与客户端进行交互的，下面介绍Jersey如何响应json数据的。
Response.entity()可以用于设置返回的数据。
本次示例使用阿里巴巴的fastjosn，在pom文件中引入fastjson的依赖。当然Jersey框架中也提供了自己的JSON工具，但开发中习惯使用Fastjson。

<dependency>  <groupId>com.alibaba</groupId>  <artifactId>fastjson</artifactId>  <version>1.2.21</version>  <type>pom</type></dependency>

RESTful服务

@GET@Path("/getAllByJson")public Response getAllJson(){    List<Student> lists = new ArrayList<Student>();    lists.add(new Student("1","mayun",23));    lists.add(new Student("2","mahuateng",24));    lists.add(new Student("3","zhouhongyi",25));    JSONObject json = new JSONObject();    return Response.status(Response.Status.OK).entity( json.toJSONString(lists)).build();}

访问http://localhost:8080/student/getAllByJson，返回对应的josn数据

[    {        "age": 23,        "id": "1",        "name": "mayun"    },    {        "age": 24,        "id": "2",        "name": "mahuateng"    },    {        "age": 25,        "id": "3",        "name": "zhouhongyi"    }]

Response设置响应类型

Response.type(“application/json”);
可以根据具体需要设置不同的响应类型

Response实现跳转

Response实现跳转有两种方式：

1. 保留请求方式

@POST@Path("/jump2")public Response jump(){    String url = "http://www.baidu.com";    return Response.temporaryRedirect(URI.create(url)).build();}

Response.temporaryRedirect(URI.create(url)).build();这样是跳转到指定路径，需要注意的是这个方法的跳转方式GET,POST等会延用进入该方法时的方法，如果是POST方法进入的那么跳转后的方法还是post。
2. GET请求方式

/** * 请求方式变为GET * @return */@GET@Path("/jump")public Response redict(){    String url = "http://www.baidu.com";    return   Response.seeOther(URI.create(url)).build();}

Response.seeOther(URI.create(url)).build().上面的示例中访问/jump ，可以跳转到百度首页，需要注意的是通过这种方式跳转url路径必须是完整的，也即要带着对应的协议。

Response工具类

对于Response使用我们可以提出一个常用的工具类，下面分享下我们使用的，供大家参考。
只是关于响应的工具类。

public class JerseyTool {    public static Response returnUnauthorized() {        return Response.status(Status.UNAUTHORIZED).build();    }    public static Response returnAbort(String errorJson) {        return Response.status(Status.BAD_REQUEST).entity(errorJson).type("application/json").build();    }    public static Response returnServerError(String errorJson) {        return Response.status(Status.INTERNAL_SERVER_ERROR).entity(errorJson).type("application/json").build();    }    public static Response returnSuccess(String json) {        return json != null?Response.status(Status.OK).entity(json).type("application/json").build():Response.status(Status.OK).build();    }    public static Response returnSuccess() {        return Response.status(Status.OK).build();    }}

前面介绍了Response的基本使用，基本可以满足在日常开发时的大量场景，如需其他资料请参考官方Response Api。

Jersey系列相关源码请访问：Jersey_learing项目