jersey框架创建的jax-rs规范的接口(参考网页1-4).doc

Jersey框架建jax-rs规范的webservice 概述 JAX-RS是一套用java实现REST服务的规范，提供了一些标注将一个资源类，一个POJOJava类，封装为Web资源。标注包括： @Path，标注资源类或方法的相对路径 @GET，@PUT，@POST，@DELETE，标注方法是用的HTTP请求的类型 @Produces，标注返回的MIME媒体类型 @Consumes，标注可接受请求的MIME媒体类型 @PathParam，@QueryParam，@HeaderParam，@CookieParam，@MatrixParam，@FormParam,分别标注方法的参数来自于HTTP请求的不同位置，例如@PathParam来自于URL的路径，@QueryParam来自于URL的查询参数，@HeaderParam来自于HTTP请求的头信息，@CookieParam来自于HTTP请求的Cookie。 目前JAX-RS的实现包括： Apache CXF，开源的Web服务框架。 Jersey， 由Sun提供的JAX-RS的参考实现。 RESTEasy，JBoss的实现。 Restlet，由Jerome Louvel和Dave Pawson开发，是最早的REST框架，先于JAX-RS出现。 Apache Wink，一个Apache软件基金会孵化器中的项目，其服务模块实现JAX-RS规范 Myeclipse2013+tomcat7+jdk1.7 软件自带的jersey框架 新建项目 File=New=Web Service Project。 project name: 项目名称，eg：rest，jaxRS... ,选择REST(JAX-RS) 下一步。 勾选core,jaxb,client,json然后下一步。 其中，jaxb(Java Architecture for XML Binding)可以将java class序列号成xml 新建项目中，有一项配置servlet，运行容器的选项 servlet display-nameJAX-RS REST Servlet/display-name servlet-nameJAX-RS REST Servlet/servlet-name servlet-classcom.sun.jersey.spi.container.servlet.ServletContainer/servlet-class //jersey运行容易，默认 load-on-startup1/load-on-startup /servlet servlet-mapping servlet-nameJAX-RS REST Servlet/servlet-name url-pattern/services/*/url-pattern //路径，默认jaxrs，可根据自己情况自己填 /servlet-mapping 需要的jar有jaxb，jax-rs的包，myeclipse已经提供完整，不需要额外的包，至此项目新建完毕 编写运行的基本类与方法配置 点击使用eclipse创建Rest 图标创建webservice,选择restblog工程，Framework选择REST(JAX-RS) 通过以上的操作可以配置方法的路径，参数类型，反馈类型，get或者post方法 （另外，在Java文件上右键菜单=MyEclipse=Add REST Method，跟上文一样配置服务方法） 也可以直接手动写资源注入，具体含义再次列举 @Path，标注资源类或方法的相对路径 @GET，@PUT，@POST，@DELETE，标注方法是用的HTTP请求的类型 @Produces，标注返回的MIME媒体类型 @Consumes，标注可接受请求的MIME媒体类型 @PathParam，@QueryParam，@HeaderParam，@CookieParam，@MatrixParam，@FormParam,分别标注方法的参数来自于HTTP请求的不同位置，例如@PathParam来自于URL的路径，/category/{id}中的id就是PathParam @QueryParam来自于URL的查询参数，@HeaderParam来自于HTTP请求的头信息，@CookieParam来自于HTTP请求的Cookie。 详解下资源注入： 举例：一般的资源注入，直接 @Path(/path1**/{id}) @GET @Produces(application/xml) Public ...(@PathParam(“id”) String id){} Path是访问路径，在最初的类开头也可以有path “/”或者”jaxRs”都可以 G