Restlet 第一步

内容提纲

本文创建了一个“Hello world”的资源，它将会让你在10分钟之内领略到Restlet框架的简洁。

1. 我需要做什么

2. “Hello，world” application

3. 在Servlet容器中运行

4. 作为独立的java程序运行

5. 总结

我需要做什么

我们假设你有一个搭建好的可用开发环境，并且你已经安装了JRE1.5或更高版本。如果你还没有下载Restlet，那么你可以从Restlet framework2.0 的最近版本中选择并下载。

“Hello, world” application

首先，让我们从REST应用的核心开始：resource。这个例子比较简单，只定义了一个resource，代码如下。

package firstSteps;   
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";   
    }   
}  

然后，创建一个简单的application，我们将它命名为”FirstStepsApplication”。

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 Restlet createRoot() {   
        // 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;   
    }   
}   

在Servlet容器中运行

因为你可能对Servlet更熟悉，我们建议在你的Servlet容器中运行这个Restlet应用程序。像往常一样，新建一个Servlet Web 应用，添加一个”firstStepsServlet”包并把上面的resource和application类放里边，并把下面所列的jar包导入到类库中（/WEB-INF/lib）：

• org.restlet.jar
• org.restlet.ext.servlet_2.5.jar

然后，修改web.xml的配置信息，内容如下所示：

 

<?xml version="1.0" encoding="UTF-8"?>  

<web-app id="WebApp_ID" version="2.4"  xmlns="http://java.sun.com/xml/ns/j2ee"  
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee   http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  

<display-name>first steps servlet</display-name>  

<!-- Application class 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>  

 

最后，将整个工程打包为WAR文件，可以命名为firstStepsServlet.war，并将其部署在你的servlet容器中。容器启动后，打开浏览器，输入URL： http://<你的服务器名字>:<服务器端口>/firstStepsServlet，你将在页面上看到”Hello, world”。

你可以下载这个war文件http://www.restlet.org/documentation/2.0/examples/firstSteps/sources.zip

作为独立的java文件运行

一个Restlet应用程序不仅能够运行在Servlet容器中，也能通过引用jar包”org.restlet.jar”来作为独立的java文件运行。下面的这段代码创建了一个主类，在其中定义了一个新的HTTP服务器，来监听端口8182并代理所有向FirstStepsApplication发来的请求。

 

public static void main(String[] args) {   

    try {   
        // 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(new FirstStepsApplication());   
 
        // Start the component.   
        component.start();   
        } catch (Exception e) {   
            // Something is wrong.   
            e.printStackTrace();   
        }   
}   

运行主类后，在浏览器中输入链接：http://localhost:8182/hello，服务器将会显示“hello, world”。另外，要确保classpath是正确的并且端口8182没有被其它程序占用。

总结

但愿这些简单的流程能对你有所帮助，但愿能继续学习first Resource或者进行更深一步的学习。

 

相关资源：

http://www.restlet.org/documentation/2.0/firstSteps