当前位置: 代码迷 >> Web前端 >> Restlet2.0学习――容易WebApp实现
  详细解决方案

Restlet2.0学习――容易WebApp实现

热度:502   发布时间:2012-07-16 15:44:59.0
Restlet2.0学习――简单WebApp实现
由于自己最近正在学习REST,并需要使用Restlet做ROA的开发。所以把自己的一些事件心得写下,以便以后查阅,也希望可以帮助到一些同学。

首先Rest的概念就不提了。主要就是讲关于如何更好,更简单的利用http协议中的一些基本方法,做统一接口,来实现我们基于资源的架构开发。其中Restful web service 书中也说道。很多时候我们都容易陷入把开发变复杂的情况,比如使用SOAP,这种特殊信封去包装我们的数据。而一些尝试开发Rest的人们,也容易由于经验的印象,陷入架构的变异,开发出Rest-RPC风格或者纯RPC风格的程序。而看了很多在java方面关于Rest原则的架构设计,觉得Restlet基本遵循了Rest的原则,而且相对比较简单。所以尝试拿来写一些简单程序开始入手。当然在Rest1.0时代也有很多达人写了很多实战例子。其中,在iteye社区中就有一位ajax达人写了长长33篇关于Restlet1.0的实例,其中较多都是结合spring使用。而本人几下Restlet2.0的一些实践例子,毕竟想把关于2.0方面的经验分享给大家,也因为1.0中的很多类在2.0中都已经废弃,而且现在官网上主要放着的是2.0和2.1的get started。总要与时俱进的嘛,哈哈。好了,言归正传,让我们开始吧。


Restlet2.0中最近的是从Restlet,Resource和respresentation三个包中展开。其他的一些都是富有一些特殊功能的类而其中基于Uniform和UniformResource的两个接口就是其中的核心。

这篇文章下的项目主要实现就是通过一个test,获取放入webapp中resource,并返回hello world的功能。该项目的名称我们命名为RestLetServlet。在开发之前,需要加入如下jar
org.restlet.jar(restlet核心包,不管是JEE或者是JSE都是必需的)
org.restlet.ext.servlet.jar(JEE下servlet专用包)
junit4.8.2.jar(用于编写单元测试,其实直接使用浏览器也是可以的。)

具体实现如下:

首先我们创建一个Resource。原本在1.0中时继承Resource这个类的。但是在2.0中Resource已经废弃,使用实现UniformResource接口的ServerResource类
public class HelloResource extends ServerResource {

	@Get
	public String getHello() {
		return "Hello World";
	}
}

这里使用Get的annotation,方便了对统一接口的指引和调用。而在1.0中,所有的Resource都要重写各种respresent方法才可以。如post->acceptRepresentation;put-> storeRepresentation;delete-> removeRepresentations等。

然后我们就要创建一个application类把resource放入其中。这里的application其实就是实现了Uniform接口的类。所以在服务端这边那两个接口是大头。很多子类都是从上面的两个接口演变出来的。
public class HelloApplication extends Application {

	@Override
	public Restlet createInboundRoot() {
		Router router = new Router(getContext());
		router.attach("/getHello", HelloResource.class);
		return router; 
	}
}


然后在web.xml下添加如下代码:
<servlet>  
      <servlet-name>RestletServlet</servlet-name>  
      <servlet-class>org.restlet.ext.servlet.ServerServlet</servlet-class>
      <init-param>
            <!-- Application class name -->
            <param-name>org.restlet.application</param-name>
            <param-value>com.restlet.application.HelloApplication</param-value>
      </init-param>
   </servlet>  
  
   <!-- Catch all requests -->  
   <servlet-mapping>  
      <servlet-name>RestletServlet</servlet-name>  
      <url-pattern>/*</url-pattern>  
   </servlet-mapping>


这样我们熟悉的服务端就建立完成了。

如上,我们的资源路径就定型了。是基于当前项目的RestLetServlet(而对应的application在这里是所有路径都可以的,在JSE下,这个路径就是各种Application的路径了。)下的getHello资源。把编写的项目放入tomcat或者任何servlet容器即可。

然后附上测试代码:
public class HelloTest {

	@Test
	public void testGetHello() throws Exception {
		ClientResource resource = new ClientResource("http://localhost:8080/RestLetServlet/getHello");
		resource.get().write(System.out);
	}
 }


启动容器,然后使用测试代码运行,在console就可以看到hello world了。
这里的test其实就是模拟了浏览器的功能,所以其实也可以直接向浏览器URL地址栏输入上面的路径依旧可以得到hello world。

这里仅仅是实现了一个get方法的操作。而在webapp下,由于HTML4和HTML5本身设计上的限制。我们不能使用put和delete这两种方法。也不能使用header和options两个辅助方法。所以其他的一些在webapp大多这些方法的使用都是从post进行模拟出来。在restful web service下也指出这个是不得已的演变,只能使用RPC风格进行开发。希望在以后可以有其他的方法解决这个问题。

当然在基于java客户端的clientResource下,那些方法都是可以使用的。所以相对来说学习JSE的restlet可以对rest的核心和编程原则更加的了解和熟悉。不容易让自己走弯路。毕竟也有很多人开发webapp时,看到post可以解决所有的问题,于是就走向了以前开发webapp的老路了。而忽略了rest的真正意义。

  相关解决方案