Restlet入门示例

http://cunfu.iteye.com/blog/757467

本文的目的在于完成一个Restlet入门示例。
首先，是一个Stand alone应用。
然后，将其部署与Tomcat容器中。
最后，完成Restlet与Spring的整合。

1.按照官方教程，完成“firstSteps”

创建一个动态Web工程RestEE，并建立firstSteps包，并复制如下代码到：HelloWorldResource.java

Java代码  

1. package firstSteps;   
2.   
3. import org.restlet.Context;   
4. import org.restlet.Request;   
5. import org.restlet.Response;   
6. import org.restlet.resource.Get;   
7. import org.restlet.resource.ServerResource;   
8.   
9. /**  
10.  * Resource which has only one representation.  
11.  */  
12. public class HelloWorldResource extends ServerResource {   
13.   
14.     @Get  
15.     public String represent() {   
16.         return "hello, world";   
17.     }   
18.   
19. }  

package firstSteps;

import org.restlet.Context;
import org.restlet.Request;
import org.restlet.Response;
import org.restlet.resource.Get;
import org.restlet.resource.ServerResource;

/**
 * Resource which has only one representation.
 */
public class HelloWorldResource extends ServerResource {

    @Get
    public String represent() {
        return "hello, world";
    }

}

2.复制如下代码到FirstStepsApplication.java

Java代码  

1. package firstSteps;   
2.   
3. import org.restlet.Application;   
4. import org.restlet.Restlet;   
5. import org.restlet.routing.Router;   
6.   
7. public class FirstStepsApplication extends Application {   
8.   
9.     /**  
10.      * Creates a root Restlet that will receive all incoming calls.  
11.      */  
12.     @Override  
13.     public synchronized Restlet createInboundRoot() {   
14.         // Create a router Restlet that routes each call to a new instance of HelloWorldResource.   
15.         Router router = new Router(getContext());   
16.   
17.         // Defines only one route   
18.         router.attach("/hello", HelloWorldResource.class);   
19.   
20.         return router;   
21.     }   
22.   
23. }  

package firstSteps;

import org.restlet.Application;
import org.restlet.Restlet;
import org.restlet.routing.Router;

public class FirstStepsApplication extends Application {

    /**
     * Creates a root Restlet that will receive all incoming calls.
     */
    @Override
    public synchronized Restlet createInboundRoot() {
        // Create a router Restlet that routes each call to a new instance of HelloWorldResource.
        Router router = new Router(getContext());

        // Defines only one route
        router.attach("/hello", HelloWorldResource.class);

        return router;
    }

}

3.编写main，复制如下代码到：FirstStepsMain.java

Java代码  

1. package firstSteps;   
2.   
3. import org.restlet.Component;   
4. import org.restlet.data.Protocol;   
5.   
6. public class FirtstStepsMain {   
7.     public static void main(String[] args) throws Exception {     
8.         // Create a new Component.     
9.         Component component = new Component();     
10.          
11.         // Add a new HTTP server listening on port 8182.     
12.         component.getServers().add(Protocol.HTTP, 8182);     
13.          
14.         // Attach the sample application.     
15.         component.getDefaultHost().attach("/firstSteps",     
16.                 new FirstStepsApplication());     
17.          
18.         // Start the component.     
19.         component.start();     
20.     }    
21. }  

package firstSteps;

import org.restlet.Component;
import org.restlet.data.Protocol;

public class FirtstStepsMain {
	public static void main(String[] args) throws Exception {  
	    // Create a new Component.  
	    Component component = new Component();  
	  
	    // Add a new HTTP server listening on port 8182.  
	    component.getServers().add(Protocol.HTTP, 8182);  
	  
	    // Attach the sample application.  
	    component.getDefaultHost().attach("/firstSteps",  
	            new FirstStepsApplication());  
	  
	    // Start the component.  
	    component.start();  
	} 
}

4.以Java Application运行FirstStepsMain，在浏览器中输入：
http://localhost:8182/hello，将打印“hello, world”信息。

5.修改web.xml，具体代码如下：

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">  
3.     
4.    <display-name>firstSteps</display-name>  
5.    <context-param>     
6.       <param-name>org.restlet.application</param-name>     
7.       <param-value>     
8.          firstSteps.FirstStepsApplication   
9.       </param-value>     
10.    </context-param>  
11.    <!-- Restlet adapter -->     
12.    <servlet>     
13.       <servlet-name>RestletServlet</servlet-name>    
14.       <servlet-class>org.restlet.ext.servlet.ServerServlet</servlet-class>  
15.          
16.          
17.    </servlet>     
18.      
19.    <!-- Catch all requests -->     
20.    <servlet-mapping>     
21.       <servlet-name>RestletServlet</servlet-name>     
22.       <url-pattern>/*</url-pattern>     
23.    </servlet-mapping>     
24. </web-app>  

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
 
   <display-name>firstSteps</display-name>
   <context-param>  
      <param-name>org.restlet.application</param-name>  
      <param-value>  
         firstSteps.FirstStepsApplication
      </param-value>  
   </context-param>
   <!-- Restlet adapter -->  
   <servlet>  
      <servlet-name>RestletServlet</servlet-name> 
	  <servlet-class>org.restlet.ext.servlet.ServerServlet</servlet-class>
      
      
   </servlet>  
  
   <!-- Catch all requests -->  
   <servlet-mapping>  
      <servlet-name>RestletServlet</servlet-name>  
      <url-pattern>/*</url-pattern>  
   </servlet-mapping>  
</web-app>

6.启动Tomcat，运行该项目。在浏览器中输入：
http://localhost:8080/RestEE/hello，出现“hello, world”信息。

7.集成restlet，spring
7.1 修改web.xml，内容如下：

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">  
3.     
4.    <display-name>firststepsservlet</display-name>  
5.          
6.    <context-param>     
7.       <param-name>contextConfigLocation</param-name>     
8.       <param-value>/WEB-INF/applicationContext.xml</param-value>     
9.    </context-param>     
10.        
11.    <listener>     
12.       <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>     
13.    </listener>     
14.       
15.    <!-- Restlet adapter -->     
16.     <servlet>     
17.         <servlet-name>RestletServlet</servlet-name>     
18.         <servlet-class>org.restlet.ext.spring.SpringServerServlet</servlet-class>  
19.         <init-param>  
20.             <param-name>org.restlet.component</param-name>      
21.             <param-value>component</param-value>      
22.         </init-param>  
23.     </servlet>     
24.      
25.    <!-- Catch all requests -->     
26.    <servlet-mapping>     
27.       <servlet-name>RestletServlet</servlet-name>     
28.       <url-pattern>/*</url-pattern>     
29.    </servlet-mapping>     
30. </web-app>  

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
 
   <display-name>firststepsservlet</display-name>
      
   <context-param>  
	  <param-name>contextConfigLocation</param-name>  
      <param-value>/WEB-INF/applicationContext.xml</param-value>  
   </context-param>  
    
   <listener>  
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
   </listener>  
   
   <!-- Restlet adapter -->  
   	<servlet>  
      	<servlet-name>RestletServlet</servlet-name>  
       	<servlet-class>org.restlet.ext.spring.SpringServerServlet</servlet-class>
		<init-param>
      		<param-name>org.restlet.component</param-name>   
			<param-value>component</param-value>   
	  	</init-param>
	</servlet>  
  
   <!-- Catch all requests -->  
   <servlet-mapping>  
      <servlet-name>RestletServlet</servlet-name>  
      <url-pattern>/*</url-pattern>  
   </servlet-mapping>  
</web-app>

7.2 application.xml内容如下：

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.        xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd">  
5.     
6.     <bean id="component" class="org.restlet.ext.spring.SpringComponent">  
7.         <property name="defaultTarget" ref="application" />    
8.     </bean>  
9.     <bean id="application" class="firstSteps.FirstStepsApplication">  
10.         <lookup-method name="createRoot" bean="root" />  
11.     </bean>  
12.     <bean id="root" class="org.restlet.ext.spring.SpringRouter">  
13.         <property name="attachments">  
14.             <map>  
15.                 <entry key="/hello">  
16.                     <bean class="org.restlet.ext.spring.SpringFinder">  
17.                         <lookup-method name="create" bean="HelloWorldResource" />  
18.                     </bean>  
19.                 </entry>  
20.             </map>  
21.         </property>  
22.     </bean>  
23.     <bean id="HelloWorldResource" class="firstSteps.HelloWorldResource" scope="prototype" />  
24. </beans>  

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd">
 
 	<bean id="component" class="org.restlet.ext.spring.SpringComponent">
 		<property name="defaultTarget" ref="application" /> 
 	</bean>
 	<bean id="application" class="firstSteps.FirstStepsApplication">
 		<lookup-method name="createRoot" bean="root" />
 	</bean>
	<bean id="root" class="org.restlet.ext.spring.SpringRouter">
        <property name="attachments">
            <map>
                <entry key="/hello">
                    <bean class="org.restlet.ext.spring.SpringFinder">
                        <lookup-method name="create" bean="HelloWorldResource" />
                    </bean>
                </entry>
            </map>
        </property>
    </bean>
    <bean id="HelloWorldResource" class="firstSteps.HelloWorldResource" scope="prototype" />
</beans>

7.3 启动Tomcat，运行该项目。浏览器中输入：
http://localhost:8080/RestEE/hello，出现“hello,world”信息。