第10章 JAX-RS概述.ppt

tomcat6要写一个配置文件。Web.xml * 请求实例改写方法。接口collection（set不可重复，list可以）；map特殊，名值对 HashSet（）TreeSet（） * 基于JAX-RS的RESTful Web服务的构建 REST风格Web服务的构建框架 建立基于REST风格的Web服务可以采用一些技术框架简化构建过程，常用的技术框架包括： WCF 微软提供的基于.NET技术的RESTful Web服务构架的框架，可以使用.NET支持的各种语言编写服务实现代码。 JAX-RS规范 由Java标准化组织JCP（）制定的构建RESTful风格的Web服务的技术规范，目前最新的规范版本是2.1(JSR370)。 SpringFramework 是Spring的生态圈中对REST风格Web服务的实现。 JAX-RS规范和Jersey实现 从JavaEE6规范开始，已经包含了JAX-RS作为RESTful Web Service的规范。 作为JavaEE规范参考实现的开源项目GlassFish，它的子项目Jersey实现了JAX-RS规范。可以从下载最新的版本。另外，很多JavaIDE例如NetBeans也集成了Jersey，用于对JAX-RS规范的支持。 JAX-RS规范要求必须在Java 5（JDK1.5和JRE5.0）以上开发和部署，只支持注解的开发方式。 JAX-RS服务的部署 利用JAX-RS规范开发的Web服务是Java Web程序（WAR文件）的一部分，可以直接部署在支持JavaEE6或者JavaEE7全部功能的服务器中（例如GlassFish3.x或者4.x版本），也可以部署在仅支持Servlet/JSP及规范的服务器中（例如Tomcat）。 当在Servlet/JSP容器中部署时，需要在Web程序中添加对应的JAX-RS实现类库（例如Jersey）。如果需要使用JAX-RS的服务端事件（SSE）,则要求容器必须支持Servlet3.0规范（例如，Tomcat7.x及以上版本）;否则只要求容器支持Servlet2.5规范即可（例如，Tomcat6.x版本）。 资源类和资源方法 如前所述，ROA中的资源就是可以用URI描述的信息，在JAX-RS中，资源就是部署在Web程序中，可通过URI请求到的资源类实例。 资源类 使用@javax.ws.rs.Path注解定义其URI的公开类，JAX-RS也允许使用接口（interface）的实例作为资源。 资源方法 资源类或接口中能够处理诸如GET、POST等不同请求方式的公开方法。 资源类和资源方法的注解 @javax.ws.rs.Path 标注资源类的URI，该注解也可以用于类中的资源方法。 @javax.ws.rs.GET 标注该资源类中处理HTTP协议中GET请求的资源方法，经常用于查询。该资源方法应做到幂等。 @javax.ws.rs.POST 标注该资源类中处理HTTP协议中POST请求的资源方法，通常用于资源的创建，资源标识由服务器端产生。 @javax.ws.rs.PUT 标注该资源类中处理HTTP协议中PUT请求的资源方法，经常用于更新，有时也用于资源的创建，但创建资源所需的标识应由客户端提供。该资源方法应做到幂等。 资源类和资源方法的注解 @javax.ws.rs.DELETE 标注该资源类中处理HTTP协议中DELETE请求的资源方法，通常用于资源删除。该资源方法应做到幂等。 @javax.ws.rs.HEAD 标注该资源类中处理HTTP协议中HEAD请求的资源方法，通常用于资源中元数据的获取。 @javax.ws.rs.OPTIONS 标注该资源类型中处理HTTP协议中OPTIONS请求的资源方法，通常用于查询可用于资源的操作。 资源类示例 import javax.ws.rs.PATH; import javax.ws.rs.GET; //PATH注解使用String类型的value参数，设定资源类的URI @Path(/hello) //value参数名可以省略 public class Hello{//资源类必须是公开的 //GET标注的资源方法必须也是公开的，处理GET请求 @GET public String sayHello(){ return hello,world!; } } 资源类的实例化 如前所述，JAX-RS服务是Web程序的一部分，当用户请求到来的时候，容器将建立资源类的实例，建立的方式有两种： 请求实例 这种方式是每接到用户请求，都将建立对应的资源类的实