Jersey （软件框架）介绍

Jersey RESTful 框架是开源的RESTful框架, 实现了JAX-RS (JSR 311 & JSR 339) 规范。它扩展了JAX-RS 参考实现，提供了更多的特性和工具，可以进一步地简化 RESTful service 和 client 开发。尽管相对年轻，它已经是一个产品级的 RESTful service 和 client 框架。与Struts类似，它同样可以和hibernate,spring框架整合。

jersey1.X使用的是sun的com.sun.jersey

jersey2.X使用的是glassfish的org.glassfish.jersey

由于Struts2+hibernate+spring整合在市场的占有率太高，所以很少一部分人去关注Jersey。所以网上有关于Jersey的介绍很少。但是它确实是一个非常不错的框架。对于请求式服务，对于GET,DELETE请求，你甚至只需要给出一个URI即可完成操作。

举个简单的例子：如果你想获得服务器数据库中的所有数据；那么你可以在浏览器或者利用Ajax的GET方法，将路径设置好；例如：localhost:8080/Student(项目名称)/studentinfo(项目服务总体前缀)/student(处理student对象的签注)/getStudentInfo(最后前缀)。这样就可以获取所有学生信息。你可以选择GET获取的数据的返回类型：JSON,XML,TEXT_HTML(String)..获取之后，你可以通过JS将这些数据塞到html或者jsp页面上。

下面是详解：

web.xml的设置：

<servlet>
　　<servlet-name>JerseyServlet</servlet-name>
　　<servlet-class>
　　com.sun.jersey.spi.spring.container.servlet.SpringServlet
　　</servlet-class>
　　<init-param>
　　<param-name>com.sun.jersey.config.property.packages</param-name>
　　
　　<param-value>com.mirrors.action</param-value>
　　</servlet-mapping>
　　<welcome-file-list>
　　<welcome-file>index.jsp</welcome-file>
　　</welcome-file-list>

StudentAction.java一些代码：

@Component
　　@Path("/student")//处理student对象的签注
　　public class StudentAction
　　{
　　private StudentDao studentdao;
　　public void setStudentdaoStudentDao studentdao)
　　{
　　this.studentdao =studentdao;
　　}
　　@GET//获取方式
　　@Path("getStudentInfo")//最后前缀

@Produces({ MediaType.APPLICATION_JSON })//返回类型为一个Student对象的JSON数组
　　public List<Student> getTrade()

{
　　return studentdao.getStudent();
　　}

}

这样一个GET方式的处理就结束了，接下来就是前台提取方式，你可以通过JS控制JSON数组在页面的呈现方式。

Jersey共计有4中处理方式，即：@GET,@POST,@DELETE,@PUT。由于Jersey中文资料较少。想学习的可以通过官网API学习。

jersey常用注解解释：

Annotation	作用	说明
@GET	查询请求	相当于数据库的查询数据操作
@PUT	更新请求	相当于数据库的更新数据操作
@POST	插入请求	相当于数据库的插入数据操作
@DELETE	删除请求	相当于数据的删除数据操作
@Path	uri路径	定义资源的访问路径，client通过这个路径访问资源。比如：@Path("user")
@Produces	指定返回MIME格式	资源按照那种数据格式返回，可取的值有：MediaType.APPLICATION_XXX。比如：@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	通过Bean的形式传递参数	接受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