使用spring mvc或者resteasy构建restful服务

resteasy 是 jboss的一个开源restful service实现参考。本文假设读者熟悉spring mvc，但是不了解或者没有使用过resteasy的用户。

其实一直以来，笔者实际都是使用spring mvc，对于研究resteasy没有兴趣。至于最近研究resteasy，纯属因为现在公司使用dubbox作为rpc框架，而dubbox使用resteasy作为REST实现库。

简单地说，resteasy核心就是一个servlet前端控制器，理念都一样。

应该来说，resteasy的优势在于相比spring mvc而言，更加的专注，简单。就大型应用而言，绝对是spring mvc占据优势。

就简洁性而言，应该来说在spring 4.0引入spring restcontroller之后，优势就没有那么明显了，应该来说3.2之前对restful还不那么有信心。

就像我们现在发现基本上mvc上spring mvc占据了绝大部分的新项目，估计以后resteasy也会小众化。

至于说resteasy为什么活下来，感觉上spring社区有个比较明显的倾向就是好像不怎么吃螃蟹，等到趋势比较明朗之后，要么就整合对方，要么就强行自己引入一套接口玩死对方。

resteasy是JAX-RS的参考实现之一，规范制定者是核心人员之一，所以概念和属于上基本上完全各种restful service教材上能够直接对应。spring mvc方面，就没有那么直接的对应了，估计是鄙视J2EE的一种商业手法。

就应用而言，如果restful作为rpc的实现机制，resteasy应该是有优势的，毕竟集成没有spring mvc那么多配置（当然spring cloud除外），但作为应用，估计干不过spring mvc。

先在web.xml文件中做了以下配置：



其中ResteasyBootstrap作为监听器是拉起Resteasy服务的入口，在服务启动时主要做了以下动作：

1）通过ListenerBootstrap组件读取在web.xml文件中的一些系统配置信息，创建ResteasyDeployment对象，并将这些配置信息初始化到该对象中，其中就包括将”resteasy.resources”中配置的资源类的路径初始化到其成员变量resourceClasses中;

2）通过调用ResteasyDeployment的start()方法，并根据相关配置信息初始化Resteasy的核心组件ResteasyProviderFactory ，Dispatcher，Registry.

3）最关键的部分是调用registration()，在该方法中会遍历之前在web.xml中配置的资源并将其注册到Registry中, 以Demo中的例子来看会遍历resourceClasses中配置好的TestRest资源路径,并加载该类然后通过调用registry.addPerRequestResource(clazz)注册到Registry中; 详见以下代码片段：



在addPerRequestResource()中做了两个主要的事情:其中一个是会使用相应的ResourceFactory来包装资源类TestRest,见以下代码片段：



通过阅读POJOResourceFactory的源码可以了解到其作用就是包含了资源类的所有元信息，因此它可以利用ResteasyProviderFactory提供的注入器在需要时通过createResource()来创建资源类TestRest的对象；

第二个主要的事情是Registry可以通过资源类中的元信息来解析上面的JAX-RS注解,并将该注解的路径和对应的方法生成的invoker对象注册到Registry中,在Demo中就是把”/path1/subpath/{id}”和 test()方法的invoker对象注册到Registry中。



（Resteasy在服务启动时初始化过程图）

在web.xml文件中另一个配置是配置了HttpServletDispatcher,该类是HttpServlet的实现是所有请求的入口,通过其service()方法最终将请求交给之前启动服务时已经初始化好的Dispatcher对象来处理. 以Demo为例,当请求”http://localhost:8080/resteasydemo/path1/subpath/123”过来时,Dispatcher对象会调用其成员变量Registry对象来解析该请求中的路径”/path1/subpath/123”, 然后匹配到相应的invoker来执行客户端请求(详见以下代码段)，并将结果返回,页面会显示”Hello 123”;





（Resteasy 客户端请求处理流程图）

四、总结

通过对Resteasy源码的解读分析我们就可以解答刚开始的三个问题：

1）谁来接受来自客户端的请求，并进行分发交给对应的对象的方法去处理。

----->HttpServletDispatcher,（接受并分发客户端http请求）

2）负责处理客户端请求的对象由谁来负责产生。

----->ResourceFactory （在服务器启动时通过web.xml读取class的配置信息然后通过反射机制产生）

3）如何解析Java类上面的注解，使客户端过来的请求可以找到对应的方法去执行。

------>Registry（服务器启动时加载用户自定义Rest资源时，会解析上面的注解，并将注解相对路径和该类中执行的方法建立对应关系注册到Registry中，当客户端请求过来时会根据请求中的相对路径去Registry中查找对应的invoker对象，然后执行并将处理结果返回）

Resteasy就是通过以上几个核心组件的相互配合，最终将一个JavaBean发布成Rest服务，这种基于服务注册的实现方式，使得Resteasy具有较好的可扩展性，例如它能很好的和Spring进行整合将SpringBean发布成Rest服务，它是如何做到的呢？首先扩展了Resteasy的ResourceFactory实现了一个SpringResourceFactory（用来从Spring容器中获得对象），然后在服务启动时当Spring容器初始化好以后，通过扩展Spring的BeanFactoryPostProcessor，将Spring容器中初始化好的SpringBean以及对应的SpringResourceFactory注册到Resteasy的Registry中.这样客户端请求过来后，当请求路径在Registry中匹配到相应的SpringBean时就可以调用该SpringBean的ResourceFactory的createResource方法，该方法可以从Spring容器中获得对象来处理请求。

Resteasy发布Rest服务的两种方式：

一种是通过listener (ResteasyBootstrap)方式在server启动时通过该listener的contextInitialized()初始化Resteasy核心组件及Rest资源。
第二种是如果没有在web.xml中配置ResteasyBootstrap监听器，则在HttpServletDispatcher，第一次请求过来时通过servlet的init方法初始化Resteasy核心组件及Rest资源。
无论哪种方式原理都是一样的，只是初始化的时机不同。
http://blog.csdn.net/skydivingwang/article/details/77961872