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的设定：<!–定义Jersey的拦截器 –>
<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><!– 之所以我定义为com.mirrors.action就是说明此包中类的作用类似于struts中action层类的作用–!>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>JerseyServlet</servlet-name>
<url-pattern>/new/*</url-pattern><!–项目服务总体前缀 –>
</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