REST 请求处理

javax.ws.rs.ext.Providers 是JAX-RS 2.0定义的一种辅助接口，其实现类用于辅助REST框架完成过滤和读写拦截的功能，可以使用@Provider 注解标注这些类。Providers接口一共定义了四个方法，分别用来获取MessageBodyReader，MessageBodyWriter，ExceptionMapper，ContextResolver

Jersey 之所以支持那么多中响应实体的传输格式，是因为其底层实体Providers具备的对不同格式的处理能力。Jersey内部提供了丰富的MessageBodyReader和MessageBodyWriter 接口的实现类，用于处理不同格式的表述

如上图，请求流程中存在三种角色，分别是：用户，REST客户端和REST服务器，请求始于请求的发送，止于调用Resonse的readEntity()方法

（1）.用户请求提交数据，客户端接收请求，进入第一个扩展点：客户端请求过滤器 ClientRequestFilter 的filter()方法

（2）.请求处理过滤完毕后，流程进入第二个扩展点：客户端写拦截器WriterInterceptor实现类的aroundWriterTo() 方法，实现对客户端序列化操作的拦截

（3）.客户端消息体写处理器MessageBodyWriter 执行序列化，流程从客户端过渡到服务器端

（4）.服务器接收请求，流程进入第三个扩展点：服务器前置请求过滤器ContainerRequestFilter实现类 的filter()方法

（5）.过滤器处理完毕后，服务器根据请求匹配资源方法，如果匹配到相应的资源方法，流程进入第四个扩展点：服务器后置请求过滤器ContainerRequestFilter 实现类 的filter() 方法

（6）.后置请求过滤器处理完毕后，力促进入第五个扩展点：服务器读拦截器ReaderInterceptor实现类 的aroundReadFrom() 方法，拦截服务器端反序列化操作

（7）.服务器消息体读处理器MessageBodyReader 完成对客户端数据流的反序列化，服务器执行匹配的资源方法

（8）.REST请求资源的处理完毕后，流程进入第六个扩展点：服务器响应过滤器 ContainerResponseFilter 实现类 的filter() 方法

（9）.过滤器处理完毕后，流程进入第七个扩展点：服务器写拦截器WriterInterceptor实现类 的aroundWriterTo() 方法，实现对服务器端序列化到客户端这个操作的拦截

（10）.服务器消息体写处理器MessageBodyWriter 执行序列化，流程返回到客户端一侧

（11）.客户端接收响应，流程进入第八个扩展点：客户端响应过滤器ClientResponseFilter 实现类 的filter() 方法

（12）.过滤处理完毕后，客户端响应实例response 返回到用户一侧，用户执行response.readEntity(),流程进入第九个扩展点：客户端拦截器ReaderInterceptor实现类 的aroundReadFrom() 方法，对客户端反序列化进行拦截

（13）.客服端消息体读处理器MessageBodyReader 执行反序列化，将Java类型的对象最终作为readENtity()方法的返回值

JAX-RS-2.0定义的4种过滤器扩展点接口，供开发者实现其业务逻辑，按请求处理流程的先后顺序为：客户端请求过滤器（ClientRequestFilter） ------->服务端请求过滤器（ContainerRequestFilter）-------->服务端响应过滤器（ContainerResponseFilter）——>客户端响应过滤器（ClientResponseFilter）

ClientRequestFilter

ClientResponseFilter

ContainerRequestFilter

ContainerResponseFilter

Jersey 内部实现了几个典型应用的拦截器，他们是成对出现的

ReaderInterceptor

WriterInterceptor

编码解码拦截器（ContentEncoder）

优先级的定义使用注解 @Priority ,优先级的值是一个整数值，对于ContainerReauest，PreMatchContainerRequest，ClientRequest 和读写拦截器 采用升序策略，数值越小，优先级越高；对于ContainerResponse和ClientResponse采用降序策略，数值越大，优先级越高

Ajax向服务器发送请求

Ajax对象创建完成后，下面就要讲解一下Ajax如何使用。首先详细讲解一下Ajax向服务器发送请求所需的两个方法，具体如下：

(1)open()方法

open()方法用于创建一个新的HTTP请求，并指定此请求的类型(如GET、POST等)、URL以及验证信息，其声明方式如下所示：

在上述声明中，method用于指定请求的类型，其值可为POST、GET、PUT及PROPFIND，大小写不敏感URL表示请求的地址，可以为绝对地址也可以为相对地址，并且可以传递查询字符串。其余参数为可选参数，其中，asyncFlagy用于指定请求方式，同步请求为false，默认为异步请求trueuserName用于指定用户名，password用于指定密码。

(2)send()方法

send()方法用于发送请求到HTTP服务器并接收回应。其声明方式如下所示：

在上述声明中，content用于指定要发送的数据，其值可为DOM对象的实例、输入流或字符串，一般与POST请求类型配合使用，需要注意的是，如果请求声明为同步，该方法将会等待请求完成或者超时才会返回，否则此方法将立即返回。

需要注意的是，在使用GET方式传递特殊字符或中文参数时，要使用JavaScript中的encodeURIComponent()函数将其转换成“%十六进制数”的形式，防止在某些浏览器(如IE浏览器)中中文乱码的问题。

Ajax接收服务器返回的信息

了解Ajax向服务器发送请求后，下面将对Ajax如何接收服务器返回的信息(例如，HTML标签、CSS样式、字符串、XML、JSON等)，进行详细讲解。具体如下：

(1)readyState属性

readyState属性用于返回Ajax的当前状态，状态值有5种形式，具体如表所示。

(2)onreadystatechange属性

onreadystatechange事件属性用于感知readyState属性状态的改变。为了大家更好的理解这两个属性的使用，下面创建一个服务器端的文件index.php，用于输出字符串，然后在浏览器端index.html中向服务器端发送请求，并在控制台输出状态值。具体示例如下所示：

创建服务器端文件：index.php

创建浏览器端文件：index.html

在浏览器中访问客户端文件，按“F12”键，切换到控制台，查看输出结果，具体如下图所示。

从图中可以看出，通过onreadystatechange事件属性可以清晰的感知Ajax状态的改变，同时使用readyState获取转变后的状态值。例如Ajax从0(未初始化)状态变成1(初始化)状态值时，Ajax此时的状态值为1。

(3)status属性

status属性用于返回当前请求的HTTP状态码，常见的状态码如表所示。

值得一提的是，在感知当前Ajax对象状态时，为了追求程序的严谨性，需要同时判断当前HTTP状态status是否等于200(请求成功)。

需要注意的是，Ajax中的statusText属性，仅当数据发送并接收完毕后，才可以获取当前请求的响应状态。

(4)获取响应信息的相关属性

当数据接收完毕且请求服务器的请求成功时，即可以使用Ajax中提供的相关属性获取服务器的响应信息。具体的属性及相关说明如下表所示。

在上表中，responseText属性用于返回文本格式的响应数据属性responseBody表示直接从服务器返回并未经解码的二进制数据responseXML属性用于接收XML数据格式的响应数据。

---