【原创文章,转载请注明原文章地址,谢谢!】
上一节我们介绍了Jesery中的过滤器。过滤器主要用来处理请求头,响应头,请求URI地址等等,但是如果涉及到想要修改请求实体内容或者响应实体内容相关的统一业务,就需要使用Jersey提供的拦截器。
另外,拦截器和过滤器还有很多相同的额外特性,比如Namebind和优先级,也会在本节中介绍。
拦截器简介
在JAX-RS中,提供了拦截器机制,可以对服务端和移动端的请求/响应实体内容进行统一处理。和过滤器一样,拦截器也可以针对移动端和客户端,和过滤器不一样的是,拦截器在客户端和服务端都是相同的:
javax.ws.rs.ext.WriterInterceptor:写拦截器,可以在其中对于响应实体进行拦截操作;
javax.ws.rs.ext.ReaderInterceptor:读拦截器,可以在其中对于请求实体进行拦截操作;
我们分别来看下这两个拦截器的使用(以下两个例子来源于Jersey 用户指南https://jersey.github.io/documentation/latest/user-guide.html#filters-and-interceptors):
public class GZIPWriterInterceptor implements WriterInterceptor {
@Override
public void aroundWriteTo(WriterInterceptorContext context)
throws IOException, WebApplicationException {
final OutputStream outputStream = context.getOutputStream();
context.setOutputStream(new GZIPOutputStream(outputStream));
context.proceed();
}
}
WriterInterceptor需要实现一个方法,aroundWriteTo,该方法传入了一个WriterInterceptorContext对象,通过这个对象我们能够得到相应体相关内容,相应头相关的内容:
我们来看下具体代码,在GZIPWriterInterceptor中,主要是把相应内容使用GZip压缩传输。
第一句代码,通过getOutputStream得到相应输出流;
第二句代码,使用GZIPOutputStream完成输出流的转化,并使用setOutputStream方法,替换原始相应输出流,变成gzip输出流;
第三句代码,使用proceed方法,让执行流程继续向下执行。这个proceed方法大家只要回忆一下Servlet中的Filter的chain.doFilterChain(req,resp)方法,或者想一下SpringAOP中的的around增强,方法中要调用ProceedingJoinPoint.proceed()方法让方法继续向下执行。在JAX-RS的interceptor中相似,interceptor可以有多个,构成一个拦截器链,执行完一个拦截器之后,需要把响应继续向下执行,只到传播到之前我们讲过的MessageBodyWriter的writeTo方法。
要使用该拦截器,有两种方式,第一种在该类上添加@Provider,使用JAX-RS的自动发现机制,第二种方式在服务器端使用ResourceConfig提供的r