Shindig学习笔记-REST方式的请求处理过程

引用说明：原文来自于http://blog.csdn.net/hissippi/archive/2010/06/06/5651729.aspx，为了方便本人阅读，文本格式略有调整。

在Shindig项目中，典型的rest方式的请求一般是这样的(省略主机地址)：

…/social/rest/people/{guid}/@all/{pid}
…/social/rest/activities/{guid}/@self/{activityid}
…/social/rest/appdata/{guid}/@self/{appid}
…/social/rest/groups/{guid}

然后在项目的Web工程的配置文件web.xml可以看到，所有rest方式的请求都会被映射到DataServiceServlet上。

 

……
<servlet>
    <servlet-name>socialRestapiServlet</servlet-name>
    <servlet-class>
      org.apache.shindig.protocol.DataServiceServlet
    </servlet-class>
    <init-param>
      <param-name>handlers</param-name>
      <param-value>org.apache.shindig.social.handlers</param-value>
    </init-param>
  </servlet>
……
  <servlet-mapping>
    <servlet-name>socialRestapiServlet</servlet-name>
    <url-pattern>/social/rest/*</url-pattern>
  </servlet-mapping>
……

 

 

Figure 1-Servlet configuration for REST request(web.xml)

So all the request are pass to DataServiceServlet. When the first request comes to the server after it started.

Figure 2- Details of the process

当服务器启动后，第一个对social modules的rest 请求到来，会进行DataServiceServlet的初始化工作。这个过程是在所继承的上一级类ApiServlet中的init()方法完成。

初始化：

ApiServlet:

servlet初始化：

1. 获取系统中的handlers的配置位置。In web.xml, 对socialRestapiServlet 的配置有一个初始参数：org.apache.shindig.social.handlers。这个配置只是一个名称，作为一个Annotation，用来设置Guice中的Key。这样可以将系统中的handlers进行分组，在实际server实现中采用不同的handlers实现。

对实例的绑定是在SocialApiGuiceModule中配置的.

SocialApiGuiceModule继承google Guice中的AbstractModule类，覆写了configure方法，进行相关handers的注入绑定(还有诸如对ParameterFetcher，XStreamConfiguration，BeanConverter等其他类的绑定)：

·       ActivityHandler

·       AppDataHandler

·       PersonHandler

·       MessageHandler

这里可以在getHandlers()方法中配置目前系统所有已经实现的XXXHandler类。

2. 然后利用HandlerRegistry中的addHandlers()方法，注入添加所需要的处理Handlers。

DefaultHandlerRegistry

这里主要进行的就是对各个模块实际的处理handler的注册和匹配工作，在初始化中是最重要最主要的工作都是在这里面完成。

public void addHandlers(Set<Object> handlers)

前面已经提到过将handles的实例绑定到injector中。在这个函数中会根据请求的路径获取实际用来处理的具体handle。这里会调用creatRestHandle()函数，将实际的handlers中和Methods方法做一个映射的Map。最终结果就是在一个HandlerRegistry类型dispatcher对象中储存所有的Handlers 路径和Http method的映射。

private void createRestHandler(Provider<?> handlerProvider,

                                          Service service, Operation op, Method m)

这个函数会通过service，operation和http method方法将handler中的方法映射到RestInvocationHandler中去。最后会通过RestInvocationHandler中的execute方法来执行实际的业务逻辑。

public RestHandler getRestHandler(String path, String method)

这个方法是利用request的路径进行handle中的处理方法完全匹配。

以/social/rest/activities/{guid}/@self/{activityid}

过程如下：首先是根据activites相匹配的@Service，则映射到ActivityHandler类。

line-height: 21px; font-fam

分享到：

Shindig JAVA版本内部结构 | 培养人脉的106种方法

• 2011-04-14 10:37
• 浏览 828
• 评论(0)
• 分类:研发管理
• 查看更多