自己入门Java时做过一个小型RESTful Web Service的项目,这里总结一下。服务的数据交换格式主要采用JSON,服务为REST风格,连接采用Http协议,数据库使用MySQL,OR Mapping采用的是Hibernate. 小数据直接用URL传参,配合Restlet 的强大的 URI重写重定向,层级URI路由功能,更是十分的方便。数据大时就是用JSON,配合强大的Fastjson,解析起来也是十分迅速和便捷,
REST是一种设计风格而不是标准,通常基于使用HTTP、URI、XML、HTML这些现有广泛流行的协议和标准,详见wikipedia.
有一点要注意的是:REST的无状态指的是连接协议,而非应用本身的状态,REST传输会包含应用的所有状态信息,可大幅降低对HTTP连接的重复请求资源消耗。
框架的快速上手,先理解概念并掌握主要功能,然后学会配置文件和主要类的使用。
一个框架的功能往往非常之多,经常看到一些框架本身的介绍都能够写成一本厚厚的书。但是实际项目中,要快速掌握主要的功能,需要的功能。往往框架20%的主要功能就足以满足我们80%的需要。
项目里最常用到类就是:ServerResource 和 Application, Router 类。
Application和Router 类:
public class MyApplication extends Application { //层级URI和资源绑定 public Restlet createInboundRoot() { Router router = new Router(getContext()); // 定义router对象,用于绑定服务器资源 router.attach("/test", MyResource.class); router.attach("/test/{param1}", MyResource.class); router.attach("/test/{param1}/{param2}", MyResource.class); return router; } }
ServerResource类:
public class MyResource extends ServerResource{ @Override protected void doInit() throws ResourceException { // 初始化,常常初始化属性值,解码URL传过来的参数等; }; @Get public Representation fun1() { //自己的方法 } @Post public Representation fun2(Representation entity){ //自己的方法 } }
当然,项目也使用了很多的servlet, 配合一些其他功能的实现。想要深入使用,还要自己去看官方的Tutorial,去Github上看有没有符合自己需要的开源代码。最后推荐一篇博文: Restlet 开发实例,写的挺详细的。