Java Restful Web Service 学习指南

Restful是一种架构style，目前常说的有restful web service, resultful http。现在热搜榜的微服务，大多数会采用Restful方式。

JAX-RS 作为一个Restful 风格WebService规范，目前已发展到了2.0版本，目前比较常用的两个版本是JAX-RS1.1（jsr-311）、 JAX-RS2.0（jsr-339） 。

规范地址：https://jax-rs-spec.java.net/ 。现在已有很多实现：

Jersey：是jax-rs的标准实现，对规范的支持自然是最快的（JAX-RS1.1、 JAX-RS2.0）。它支持多种Servlet容器、并可以与Grizzly、Netty等结合使用，性能也是很不错的。网上有人说它是一个参考实现，但它真的不仅仅是一个参考实现而已，Kafka Connect采用了它。 支持与Spring 集成。

https://jersey.java.net/

CXF：apache下的一个开源的services框架，支持多种协议（ SOAP, XML/HTTP, RESTful HTTP, or CORBA），同时也支持多种传输协议：（HTTP, JMS or JBI）。

支持的Java规范(jsr)有：JAX-WS、JAX-RS、SAAJ 。 对于JAX-RS，支持目前JAX-RS1.1、 JAX-RS2.0。 支持与Spring集成。

http://cxf.apache.org/docs/restful-services.html

http://cxf.apache.org/docs/overview.html

RestEasy：它是JBoss社区的一个开源项目，已支持2.0规范。据说是性能最好的，我没有测试过。

http://docs.jboss.org/resteasy/docs/3.1.1.Final/userguide/html/index.html

Restlet：支持JAX-RS，支持与Spring集成。

https://restlet.com/open-source/features

这里有一篇网友的性能测试博客：http://www.tuicool.com/articles/UziAZ3u

这里是一篇网友的8个restful框架对比的博客：http://developer.51cto.com/art/201511/497863.htm

题外话说了这么多，言归正传，既然他们都实现了jax-rs规范，那么我们只需要学习了标准规范，并使用规范中的API来编程，那么我们的程序就可以与这些实现结合使用。

为了快速学习规范：我们可以参考： 1）标准规范 2）入门教程：Java Restful WebService 实战  3） API  Docs

下面提供前两者的下载链接：

链接：http://pan.baidu.com/s/1kVkb7CF 密码：vrln

Jersey2.x用户指南：https://github.com/waylau/Jersey-2.x-User-Guide

下面总结了如何学习JAX-RS，进行Restful WebService编程：

第一步： 了解规范中各个组件、API处理流程

JAX-RS中组件：

1）Resource ：代表资源，用于在接收到资源请求后，调用相应的方法处理。

资源分类：Resource、SubResouce。如何编写一个Resource Class、Resource Method？如何定位一个Resource？Resource的生命周期如何？等等问题都将在jsr手册里提到。

2）AOP：包括Filter、Interceptor。用于在Client、Container中读写请求之前做一些处理。

3）Provider：Provider提供某种东西的。有下列Provider：

MessageBodyReader：从InputStream中读取数据转换成Java对象。也就是常说的反序列化。

MessageBodyWriter：把Java对象写到OutputStream中，也就是常说的序列化。

ExceptionMapper：把指定的Exception映射到一个Response对象。

ContextResolver：用于解析Resource中需要用的上下文。参见：@Context

这些接口的实现，注册到JAX-RS容器里，通常有两种方法：1）使用@Provider让容器自动扫描，2）通过编程的方式注册。

4）Client：发起请求，处理响应。

每一种JAX-RS实现都要遵循的处理流程：

第二步：结合DI容器，并采用分层思想（Resource、Service、DAO）进行业务系统编写。

目前流行的DI容器有：Spring、Guice、HK2等等。

第三步：和其他容器结合，部署项目。

譬如说Servlet容器、Grizzly等。