[转贴]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