Spring集成Restlet实践

Spring集成Restlet实践

3.1 基本使用

　　采用Spring3.0和Restlet2.0.6，通过一个叫做RestletServlet的servlet与spring集成，如下：
<servlet>
    <servlet-name>RestletServlet</servlet-name>  
<servlet-class>org.restlet.ext.spring.RestletFrameworkServlet</servlet-class>
    <init-param>
      <param-name>org.restlet.component</param-name>
      <param-value>restletComponent</param-value>
　　</init-param>
</servlet>
<servlet-mapping>
    <servlet-name>RestletServlet</servlet-name>
    <url-pattern>/*</url-pattern>
</servlet-mapping>

    要注意的是，如果直接使用restlet，则只要org.restlet.jar，如果需要与spring集成，则需要一系列org.restlet.ext.*.jar的配合。上述配置涉及到一个初始化参数(org.restlet.component)，其值要求是一个bean，该bean默认配置到RestletServlet-servlet.xml文件中，配置如下：
 <bean id="restletComponent" class="org.restlet.ext.spring.SpringComponent"> 
       <property name="defaultTarget" ref="root" /> 
</bean>
　　此处又涉及到一个叫做root的bean，该bean表示rest结构的path配置的根节点，在这个节点中，允许用户配置多个自己的路由地址，例子如下：
    <bean id="root" class="org.restlet.ext.spring.SpringRouter"> 
        <property name="attachments"> 
             <map> 
                <entry key="/newtest"> 
                     <bean class="org.restlet.ext.spring.SpringFinder"> 
                         <lookup-method name="create" bean="dtsResourceTest" /> 
                     </bean> 
                </entry>
    上面这个配置中，一个entry代表一个路径映射关系，key表示路径，里面的bean是路径对应的处理类，lookup-method name="create"暂时不清楚其作用。Bean的定义如下所示，它依然允许注入其他的bean，路径对应的处理方法通过在bean中的@Get注解来指定
<bean id="dtsResourceTest" class="com.dts.resource.DTSResourceTest" scope="prototype">
  <property name="issueService" ref="issueService"></property>
</bean>
注意：

        1、此处的bean都需要配置为原型模式：scope="prototype" Bean的定义需继承自ServerResource，如下：public class DTSResourceUpdate extends ServerResource
        2、如果servlet拦截的url匹配规则为/rest/*，root这边配置的是/newtest，则真正的访问地址应该为/rest/newtest，也就是说map这边的配置，是拦截后剩余的地址

 

3.2 进阶学习

3.2.1 路径映射如何传值
<entry key="/update/Defect/{number}"> 
　　<bean class="org.restlet.ext.spring.SpringFinder"> 
　　<lookup-method name="create" bean="dtsResourceUpdate" /> 
    </bean> 
</entry>
在path路径中，通过大括号来指明形参名和参数值，如/update/Defect/101，效果等价于在url中带入参数:http://..../Defect?number=101参数的获取方式如下：
@Get
 public String updateInfo(){
  String number = (String)
  getRequestAttributes().get("number");

 

 

3.3 如何返回非String类型的返回值

  Restlet通常当做轻量级的webservice使用，那如何返回较大的数据量呢？此处以xml为例：
return new StringRepresentation(getXmlIssueDTSManager().getIssueDtsFromXML());
其中，getIssueDtsFromXML()如下：
String xmlResult = "";
SAXBuilder builder=new SAXBuilder();
try {
 Document docment = builder.build(this.getClass().getResource("/").getPath()+File.separator+getDtsXMLFileName()+".xml");
 Format format = Format.getPrettyFormat();
 format.setIndent(" ");
 format.setEncoding("gb2312");
 XMLOutputter xmlOut = new XMLOutputter();
 xmlOut.setFormat(format);
 xmlResult = xmlOut.outputString(docment);
......
return xmlResult;

 

3.4 遗留问题

 
3.4.1 如何让一个ServerResource处理类的每个方法对应一个path？
　　目前通过@Get注解，肯定无法区分方法与path的对应关系。如果一个类只能有一个方法对应一个path，那path较多的情况下，会导致处理类膨胀
3.4.2 根节点（SpringRouter）的配置是否有其他方式？
3.4.3 默认使用RestletServlet-servlet.xml作为配置文件的名称，如何自定义？
3.4.4 为什么ServerResource处理类的bean都要配置为scope="prototype"