Restlet+Fastjson 快速构建轻量级Java RESTful Webservice

jopen 10年前

服务的数据交换格式主要采用JSON协议,服务为REST风格,连接采用Http协议,数据库使用MySQL,OR Mapping采用的是Hibernate.

主要用的类库:

REST是一种设计风格而不是标准,通常基于使用HTTP、URI、XML、HTML这些现有广泛流行的协议和标准,详见wikipedia

有一点要注意的是:REST的无状态指的是连接协议,而非应用本身的状态,REST传输会包含应用的所有状态信息,可大幅降低对HTTP连接的重复请求资源消耗。

REST设计:

  • 面向资源的接口设计:现在将网络上的操作实体都作为资源来看待,同时URI的设计也是体现了对于资源的定位设计;
  • 抽象操作为基础的增删改查:Http中的get,put,post,delete分别对应了read,update,create,delete四种操作,实际中get方法和post方法就已经足够使用了,如果仅仅是作为对于资源的操作,抽象成为这四种已经足够了,但是对于现在的一些复杂的业务服务接口设计,未必能够满足;

REST特点:

  • 资源是由URI来指定;
  • 对资源的操作包括获取、创建、修改和删除资源,这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法;
  • 通过操作资源的表现形式来操作资源;
  • 资源的表现形式则是XML或者HTML,取决于读者是机器还是人,是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式;

REST要求:

  • 客户端和服务器结构;
  • 连接协议具有无状态性;
  • 能够利用Cache机制增进性能;
  • 层次化的系统;
  • 随需代码 - Javascript (可选);

主要功能代码:

框架的快速上手,先理解概念并掌握主要功能,然后学会配置文件和主要类的使用。

一个框架的功能往往非常之多,经常看到一些框架本身的介绍都能够写成一本厚厚的书。但是实际项目中,要快速掌握主要的功能,需要的功能。往往框架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);                }            }        }  
</div> </div>
ServerResource类
    public class MyResource extends ServerResource{                        @Override            protected void doInit() throws ResourceException {                // 初始化,常常初始化属性值,解码URL传过来的参数等;            };                    @Get            public Representation fun1() {                //自己的方法            }                    @Post            public Representation fun2(Representation entity){                //自己的方法            }        }  
</div> </div>

当然,项目也只用了很多的servlet,配合一些其他功能的实现。想要深入使用,还要自己去看官方的Tutorial,去Github上看有没有符合自己需要的开源代码。最后推荐一篇博文: Restlet 开发实例,写的挺详细的。

来自:http://blog.csdn.net/thisinnocence/article/details/24702137