RESTEasy 入门实例

[img]http://www.jboss.org/dms/resteasy/images/resteasy-banner-1180px.png[/img]

[size=x-large][b]1. 在Eclipse中建立Maven工程[/b][/size]

1.1 新建Maven工程
[img]http://dl2.iteye.com/upload/attachment/0086/1865/a8d1e4a7-4845-3fc4-9ca4-adcd3010b43d.png[/img]

1.2 选择默认工作空间
[img]http://dl2.iteye.com/upload/attachment/0086/1867/0eaa78ad-7250-30f1-8206-58795713670a.png[/img]

1.3 选择 maven-archetype-webapp Archetype
[img]http://dl2.iteye.com/upload/attachment/0086/1869/7d43617a-77dc-3099-badf-35e995fa9b34.png[/img]

1.4 填写Group id，Artifact id，package
[img]http://dl2.iteye.com/upload/attachment/0086/1873/05ac1157-daa8-333c-8371-c0ca17009d51.png[/img]

1.5 生成的web工程初始目录结构
[img]http://dl2.iteye.com/upload/attachment/0086/1875/df9930b1-f3b6-3959-98cb-3eb0cd23a227.png[/img]

[size=x-large][b]2. 添加工程依赖[/b][/size]
2.1 用Maven POM Editor 打开pom.xml文件，在Dependencies中添加依赖包
[img]http://dl2.iteye.com/upload/attachment/0086/1879/ae936160-21d4-360a-97fd-2af1494b9e92.png[/img]

2.2 在查询栏中输入“resteasy-jaxrs”,在查询结果中选择版本3.0.0
[img]http://dl2.iteye.com/upload/attachment/0086/1881/f3d6aa7e-2e6a-3e42-8e26-e7a75b21bc3f.png[/img]

2.3 保存pom.xml后，manvn从中央代码仓库自动下载依赖包
[img]http://dl2.iteye.com/upload/attachment/0086/1897/265f6733-90f6-33b0-bb28-676bcbb4b085.png[/img]

[size=x-large][b]3. REST Service[/b][/size]

package com.example.rest.resteasy.service;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.core.Response;

@Path("/hello")
public class HelloWorldRestService {

	@GET
	@Path("/{param}")
	public Response getName(@PathParam("param") String name) {
		String result = "RESTEasy Hello World : " + name;
		return Response.status(200).entity(result).build();
	}
}

[size=x-large][b]4. Rest Application[/b][/size]

package com.example.rest.resteasy.app;

import java.util.HashSet;
import java.util.Set;
import javax.ws.rs.core.Application;
import com.example.rest.resteasy.service.HelloWorldRestService;

public class HelloWorldApplication extends Application {
	private Set<Object> singletons = new HashSet<Object>();

	public HelloWorldApplication() {
		singletons.add(new HelloWorldRestService());
	}

	@Override
	public Set<Object> getSingletons() {
		return singletons;
	}
}

[size=x-large][b]5. web.xml[/b][/size]

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
	<display-name>Archetype Created Web Application</display-name>

	<servlet>
		<servlet-name>resteasy-servlet</servlet-name>
		<servlet-class>
			org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher
		</servlet-class>
		<init-param>
			<param-name>javax.ws.rs.Application</param-name>
			<param-value>com.example.rest.resteasy.app.HelloWorldApplication</param-value>
		</init-param>
	</servlet>

	<servlet-mapping>
		<servlet-name>resteasy-servlet</servlet-name>
		<url-pattern>/*</url-pattern>
	</servlet-mapping>
</web-app>

[size=x-large][b]6. Run AS -> run jetty[/b][/size]
在这个例子中，web请求“http://localhost:8080/resteasy-example/hello”将匹配HelloWorldRestService，“http://localhost:8080/resteasy-example/hello/{任意值}”将匹配到方法参数@PathParam 参数
[img]http://dl2.iteye.com/upload/attachment/0086/1899/1b6a1dce-fa77-3d43-9421-5ad2b536c037.png[/img]