[来自:http://wenku.baidu.com/view/21274dc7d5bbfd0a795673e3.html]
前两天开始看Web Service方面的资料,项目中使用的是Axis,Axis支持的是JAX-WS的API。现在比较流行RESTful,就顺便学习一下JAX-RS。
选择的框架是Jersey 1.13。比较了一下Apache CXF和Jersey,觉得Jersey比较简洁,符合我带点强迫症的心理。
在让Tomcat支持Annotation的过程中走了不少弯路,Jersey官方文档这方面做得相当糟糕。
主要参考资料:
最终搭建完成时候发现是相当的简单。。。
1.核心功能只用到了4个jar包,将它们放到WEB-INF/lib中:
asm.jar
jersey-core.jar
jersey-server.jar
jersey-servlet.jar
2.在WEB-INF/web.xml中添加
com.sun.jersey.spi.container.servlet.ServletContainer
1
这就是配置的关键。它的作用是“Scanning for root resource and provider classes in the Web app resource paths”,这样代码中的Annotation配置就会生效。
3.实现
JAX-RS 没有定义 Component 或是 VirtualHost,只是用 Application 来存放所有的 REST 资源。
package canghailan.jaxrs;
import java.util.HashSet;
import java.util.Set;
import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;
@ApplicationPath("/services")
public class MyApplication extends Application {
@Override
public Set> getClasses() {
Set> classes = new HashSet<>();
classes.add(HelloWorldService.class);
return classes;
}
}
package canghailan.jaxrs;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
@Path("/")
public class HelloWorldService {
@Path("/welcome/{name}")
@GET
@Produces(MediaType.TEXT_PLAIN)
public String welcome(@PathParam("name") String name) {
return "Welcome, " + name + "!";
}
}
启动Tomcat时,日志输出:“Root resource classes found”。
Welcome, baby!
4.添加json支持
jackson-core-asl.jar
jackson-jaxrs.jar
jackson-mapper-asl.jar
jackson-xc.jar
启动Tomcat时,日志输出:“Provider classes found”。
在Application中添加Provider:
public Set> getClasses() {
Set> classes = new HashSet<>();
classes.add(JacksonJsonProvider.class);
classes.add(HelloWorldService.class);
return classes;
}
在HelloWorldService中添加:
@Path("/auth/{name}")
@GET
@Produces(MediaType.APPLICATION_JSON)
public User auth(@PathParam("name") String name) {
return new User(name, "123456");
}
public class User {
private String name;
private String password;
...
}
访问
http://localhost:8080/jaxrs/services/auth/baby:
{"name":"baby","password":"123456"}
[java rest 实现技术对比:http://news.misuland.com/20080926/1222396399411.html JavaSE/EE执行委员批准了JSR 311 JAX-RS作为支持RESTful web服务的java 应用程序接口。J