[转贴]JAVA:RESTLET开发实例（二）使用Component、Application的REST服务

上一篇文章，我们介绍了基于JAX-RS的REST服务，本篇文章我们介绍不基于JAX-RS的模式。JAX-RS其实就是一个简单的 Application服务。和我们接下来介绍的Application基本一致，唯一不同的地方就是，不使用JAX-RS自动映射为xml。 restlet的一些基本概念可以参考上篇文章 RESTLET开发实例（一）基于JAX-RS的REST服务 的介绍，这里不再阐述。

一、基于ServerResource的REST，来实现JAX-RS中get方法。

1、新建RestApplication Web工程。

然后把相应的restlet的lib下的全部jar加入工程引用中，然后在web.xml，加入如下配置：

<context-param>

<param-name>org.restlet.application</param-name>

<param-value>org.lifeba.ws.app.RestSimpleApplication</param-value>

</context-param>

<servlet>

<servlet-name>RestletServlet</servlet-name>

<servlet-class>org.restlet.ext.servlet.ServerServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>RestletServlet</servlet-name>

<url-pattern>/*</url-pattern>

</servlet-mapping>

上面的配置和基于JAX-RS的配置一样的。

2、新建RestSimpleApplication对象。将应用程序和资源类绑定在一起，代码如下：

public class RestSimpleApplication extends org.restlet.Application{

@Override

public Restlet createInboundRoot() {

Router router = new Router(getContext());

router.attach("/student/{studentId}", StudentResource.class);

return router;

}

}

和JAX-RS不同主要有2个地方：

1）RestSimpleApplication直接扩展了Application对象，而不是JAX-RS中的JaxRsApplication对象。

2）重载了createInboundRoot通过attach方法绑定资源类，并且制定了访问路径。而JAX-RS中调用了this.add(new StudentApplication())来绑定资源类，并且不用指定访问路径，因为是在资源类中指定。

3、新建Student对象，代码如下：和JAX-RS的区别就是少了@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;

}

public int getSex() {

return sex;

}

public void setSex(int sex) {

this.sex = sex;

}

public int getClsId() {

return clsId;

}

public void setClsId(int clsId) {

this.clsId = clsId;

}

public int getAge() {

return age;

}

public void setAge(int age) {

this.age = age;

}

public String toString(){

return "Id:"+this.id+"\r\nName:"+this.name+"\r\nClass:"+

this.clsId+"\r\nSex:"+this.sex+"\r\nAge:"+this.age;

}

}

4、新建StudentResource类，该类扩展ServerResource类。代码如下：

public class StudentResource extends ServerResource{

private int id;

@Override

protected void doInit() throws ResourceException {

id = Integer.valueOf((String) getRequestAttributes().get("studentId"));

}

@Get

public Representation get(Representation entity) {

Student student = ResourceHelper.findStudent(id);

return new StringRepresentation(student.toString());

}

}

上面的代码实现的功能和JAX-RS中的下面的代码的功能一样，都是根据ID来获取对应的student信息。

@GET

@Path("{id}/xml")

@Produces("application/xml")

public Student getStudentXml(@PathParam("id") int id) {

return ResourceHelper.findStudent(id);

}

非JAX-RS模式的，扩展了ServerResource类，并且重载了doInit()方法用来获取传递过来的studentId占位符的值。因为没 有传递method方法，默认是调用@Get标注的无参方法，最后返回StringRepresentation对象（你也可以返回xml或json的 Representation对象）。

JAX-RS的也是类似，不过他的方法是带参数，并且返回一个Student对象（会根据@Produces("application/xml")自动封装xml数据）。

5、完成了上面的主要类得创建和编写，你就可以在tomcat中运行了，启动tomcat后，访问http://localhost:8085/RestApplication/student/1，你将看到下面界面：

二、实现更新、删除、添加(delete,put,post)及列表展示

1、上面的介绍，我们实现将JAX-RS中的get方法，用ServerResource方式的来实现。根据rest规范，对StudentResource，除了有get方法外，还有delete及put方法。

@Delete

public Representation delete() {

int status = ResourceHelper.deleteStudent(id);

return new StringRepresentation(String.valueOf(status));

}

@Put

public Representation put(Representation entity)

throws ResourceException {

Form form = new Form(entity);

Student student = ResourceHelper.findStudent(id);

String name = form.getFirstValue("name");

int clsId = Integer.parseInt(form.getFirstValue("clsId"));

int sex = Integer.parseInt(form.getFirstValue("sex"));

student.setClsId(clsId);

student.setName(name);

student.setSex(sex);

return new StringRepresentation(String.valueOf(ResourceHelper.updateStudent(student)));

}

2、测试更新和删除：

1)通过页面修改用户资料

update.jsp页面中加入：

<form action="/RestApplication/student/1?method=put" method="post">

用户名：<input type="text" name="name"><br>

班级:<input type="text" name="clsId"><br>

性别：<input type="text" name="sex"><br>

<input type="submit" value="提交">

</form>

提交后访问，返回1表示修改成功。

访问http://localhost:8085/RestApplication/student/1就会看到名字已经修改了。

2)通过客户端删除用户资料。新建Client类，加入如下代码，执行成功返回1.

public void student_delete(){

try {

ClientResource client = new ClientResource("http://localhost:8085/RestApplication/student/1");

Representation representation =client.delete();

System.out.println(representation.getText());

} catch (Exception e) {

e.printStackTrace();

}

}

这个时候访问 http://localhost:8085/RestApplication/student/1 ，会提示错误。因为找不到这个1的用户。

3、添加一个student，及显示全部student信息

1)StudentResource资源，按照restlet的规范，包含了get put delete方法。所以添加一个student及显示全部student信息我们需要再加入一个资源类StudentsResource，代码如下：

@Get

public Representation get(Representation entity) {

StringBuilder sb = new StringBuilder();

Iterator it = ResourceHelper.students.keySet().iterator();

while(it.hasNext()){

sb.append(ResourceHelper.students.get(it.next()).toString()+"\r\n\r\n");

}

return new StringRepresentation(sb.toString());

}

@Post

public Representation post(Representation entity)

throws ResourceException {

Form form = new Form(entity);

String name = form.getFirstValue("name");

int clsId = Integer.parseInt(form.getFirstValue("clsId"));

int sex = Integer.parseInt(form.getFirstValue("sex"));

Student student = new Student();

student.setClsId(clsId);

student.setName(name);

student.setSex(sex);

ResourceHelper.maxId++;

int id = ResourceHelper.maxId;

student.setId(id);

return new StringRepresentation(String.valueOf(ResourceHelper.addStudent(student)));

}

添加了上面代码后，我们还要在RestSimpleApplication添加下面代码，指定下资源类StudentsResource的访问路径才可以。

router.attach("/student", StudentsResource.class);

2)首先我们添加一个id为2的student对象，client类中加入下面代码，执行成功后返回新添加的studentid：2。

public void student_post(){

try {

Form queryForm = new Form();

queryForm.add("name","steven3");

queryForm.add("clsId","201002");

queryForm.add("sex","2");

queryForm.add("age","12");

ClientResource client = new ClientResource("http://localhost:8085/RestApplication/student");

Representation representation =client.post(queryForm.getWebRepresentation());

System.out.println(representation.getText());

} catch (Exception e) {

e.printStackTrace();

}

}

访问http://localhost:8085/RestApplication/student 如下，返回了全部的student资料：

可以看到我们已经成功添加了一个2的student。

三、使用Component绑定多个Application

我们已经实现了一个student的application。里面包含了2个资源类(StudentResource和 StudentsResource)。如果我们加入一个course的资源类，我们可以按照上面的方式直接建立CourseResource，然后在 RestSimpleApplication中绑定下 router.attach("/course/{courseId}", CourseResource.class)。不过这样处理会把业务逻辑混在一起，并不是很好的方法。因此我们建立一个 RestCourseApplication，然后在这里绑定CourseResource类，来实现业务逻辑的分离。

RestCourseApplication代码如下：

public class RestCourseApplication extends org.restlet.Application{

@Override

public Restlet createInboundRoot() {

Router router = new Router(getContext());

router.attach("/course/{courseId}", CourseResource.class);

return router;

}

}

CourseResource代码如下：

public class CourseResource extends ServerResource{

private int id;

@Override

protected void doInit() throws ResourceException {

id = Integer.valueOf((String) getRequestAttributes().get("courseId"));

}

@Get

public Representation get(Representation entity) {

return new StringRepresentation("course id:"+id);

}

}

现在我们有2个Application了，web.xml中就不能使用org.restlet.application了，必须使用org.restlet.component。

<context-param>

<param-name>org.restlet.application</param-name>

<param-value>org.lifeba.ws.app.RestSimpleApplication</param-value>

</context-param>

把上面的代码改为：

<init-param>

<param-name>org.restlet.component</param-name>

<param-value>component</param-value>

</init-param>

新建RestComponent类，代码如下，因为必须执行路径，所以在访问的时候记得要带上对应的前缀。

public class RestComponent extends org.restlet.Component{

public RestComponent(){

getDefaultHost().attach("/a", new RestSimpleApplication());

getDefaultHost().attach("/b", new RestCourseApplication());

}

}

访问：http://localhost:8085/RestApplication/a/student

访问：http://localhost:8085/RestApplication/b/course/1

四、资源下载

RestApplication工程项目