使用Jersey和Jetty开发RESTful Web service
Jersey RESTful 框架是开源的RESTful框架, 实现了JAX-RS (JSR 311 & JSR 339) 规范,是JAX-RS的参考实现,并且提供了更多的特性和工具,简化了RESTful service 和 client 的开发。
Jetty 是开源的servlet容器,它为基于Java的web组件例如JSP和servlet提供运行环境。用Java编写,它的API以一组JAR包的形式发布。开发人员可以将Jetty容器实例化成一个对象内嵌在应用中,从而为独立运行(stand-alone)的Java应用提供网络和web连接。
故Servlet是两者组合使用的桥梁,下面是个简单的测试代码:
POM:
<jetty.version>8.1.9.v20130131</jetty.version> <!--jersey--> <dependency> <groupId>org.glassfish.jersey.containers</groupId> <artifactId>jersey-container-servlet</artifactId> <version>2.9</version> </dependency> <dependency> <groupId>org.glassfish.jersey.core</groupId> <artifactId>jersey-client</artifactId> <version>2.9</version> </dependency> <dependency> <groupId>org.glassfish.jersey.media</groupId> <artifactId>jersey-media-json-jackson</artifactId> <version>2.9</version> </dependency> <!-- jetty --> <dependency> <groupId>org.eclipse.jetty.aggregate</groupId> <artifactId>jetty-webapp</artifactId> <version>${jetty.version}</version> </dependency> <dependency> <groupId>org.eclipse.jetty</groupId> <artifactId>jetty-jsp</artifactId> <version>${jetty.version}</version> </dependency>
---
WS实现类Hello.java
@Path("/hello") public class Hello { /** * 接收HTTP的GET请求 * * @return 返回text/plain响应 */ @GET @Produces(MediaType.TEXT_PLAIN) public String hello() { return "hello world!"; } //访问路径 /hello/text/name123 @GET @Path("/text/{name}") @Produces(MediaType.TEXT_PLAIN) public String hello(@PathParam("name") String name) throws Exception { return "hello, " + name; } //访问路径 /hello/json/name123 @GET @Path("/json/{name}") @Produces(MediaType.APPLICATION_JSON) public String hello2(@PathParam("name") String name) throws Exception { return "hello, " + name; } //访问路径 /hello/xml/name123 @GET @Path("/xml/{name}") @Produces(MediaType.APPLICATION_XML) public String hello3(@PathParam("name") String name) throws Exception { return "hello, " + name; } }
---
Jetty启动类JerseyTest.java
public class JerseyTest { public static void main(String[] args) throws Exception { Server server = new Server(); SelectChannelConnector serverConnector = new SelectChannelConnector(); serverConnector.setPort(8080); ResourceConfig resourceConfig = new ResourceConfig(Hello.class); //Jersey类ServletContainer从HttpServlet继承,故可传入Jetty类ServletContextHandler.addServlet方法 ServletContainer servletContainer = new ServletContainer(resourceConfig); server.addConnector(serverConnector); ServletContextHandler servletContextHandler = new ServletContextHandler(); servletContextHandler.addServlet(new ServletHolder(servletContainer), "/*"); server.setHandler(servletContextHandler); server.start(); server.join(); } }
---
浏览器访问路径: http://localhost:8080/hello/text/Likai
附
JAX-RS常用注解:
@GET
@PUT
@POST
@DELETE
@Path uri路径 定义资源的访问路径,client通过这个路径访问资源。如:@Path("user")
@Produces 指定返回MIME格式 资源按照那种数据格式返回,如:@Produces(MediaType.APPLICATION_XML)
@Consumes 接受指定的MIME格式 只有符合这个参数设置的请求再能访问到这个资源。比如@Consumes("application/x-www-form-urlencoded")
@PathParam uri路径参数 写在方法的参数中,获得请求路径参数。比如:@PathParam("username") String userName
@QueryParam uri路径请求参数 写在方法的参数中,获得请求路径附带的参数。比如:@QueryParam("desc") String desc
@DefaultValue 设置@QueryParam参数的默认值 如果@QueryParam没有接收到值,就使用默认值。比如:@DefaultValue("description") @QueryParam("desc") String desc
@FormParam form传递的参数 接受form传递过来的参数。比如:@FormParam("name") String userName
@BeanParam 通过Bena的形式传递参数 接受client传递的bean类型的参数,同时这个bean可以在属性上配置@FormParam用以解决client的属性名称和bean的属性名称不一致的问题。比如:@BeanParam User user
@Context 获得一些系统环境信息 通过@Context可以获得以下信息:UriInfo、ServletConfig、ServletContext、HttpServletRequest、HttpServletResponse和HttpHeaders等
@XmlRootElement 将bean转换为xml 如果要将bean以xml或json的格式返回,必须要这个注解。比如:@XmlRootElement public class User{...}
@XmlElements
@XmlElement
参考
end