RESTLET开发实例（一）基于JAX-RS的REST服务

RESTLET介绍

Restlet项目为“建立REST概念与Java类之间的映射”提供了一个轻量级而全面的框架。它可用于实现任何种类的REST式系统，而不仅仅是REST式Web服务。
Restlet项目受到Servlet API、JSP（Java Server Pages）、HttpURLConnection及Struts等Web开发技术的影响。该项目的主要目标是：在提供同等功能的同时，尽量遵守Roy Fielding博士论文中所阐述的REST的目标。它的另一个主要目标是：提出一个既适于客户端应用又适于服务端的应用的、统一的Web视图。
Restlet的思想是：HTTP客户端与HTTP服务器之间的差别，对架构来说无所谓。一个软件应可以既充当Web客户端又充当Web服务器，而无须采用两套完全不同的APIs。

准备工作

1、Restlet提供了多个版本:Java SE、Java EE、android、Google AppEngine、Google Web Toolkit、Android。
这里我们下载jee版本。
restlet-jee-2.0.6.zip 下载地址：http://www.restlet.org/downloads/2.0/restlet-jee-2.0.6.zip

2、restlet-jee-2.0.6.zip解压到硬盘，这里以%RESTLET_HOME%表示为解压的文件目录。

一、基于JAX-RS的REST服务

JAX-RS (JSR-311) 是一种 Java API，可使 Java Restful 服务的开发变得迅速而轻松。这个 API 提供了一种基于注释的模型来描述分布式资源。注释被用来提供资源的位置、资源的表示和可移植的（pluggable）数据绑定架构。在本文中，学习如何使用 JAX-RS 在 Java EE 环境内实现 RESTful 服务架构的潜能。

1、新建 web project RestService工程

2、%RESTLET_HOME%\lib 复制到 \RestService\WebRoot\WEB-INF\lib 下，并加入工程引用。为了测试方便可以将全部的lib包加入进去。实
际上面，你可以根据实际需要只复制相应的包进去即可。下面的图片是我加入的相关的jar包：

org.restlet.jar这个是必须的，如果是用于JAX-RS发布rest的话，还需要这几个包：
javax.ws.rs.jar
javax.xml.bind.jar
org.json.jar
org.restlet.ext.jaxrs.jar
org.restlet.ext.json.jar
org.restlet.ext.servlet.jar

3、创建Student实体类，用于返回数据。Student使用JAXB绑定技术，自动解析为xml返回给客户端或浏览器。

JAXB是一套自动映射XML和Java实例的开发接口和工具。JAXB使XML更加方便的编译一个XML SCHEMA到一个或若干个JAVA CLASS。可以从
使用 JAXB 进行数据绑定  获得详细介绍。

@XmlRootElement(name="Student")
public class Student {

private int id;
private String name;
private int sex;
private int clsId;
private int age;

public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}