JAXRS入门解析.docVIP

JAX-RS入门 第一节、基础 简介 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规范 (以上来自：/wiki/JAX-RS) 装备 本文使用的工具有： Eclipse-jee-helios Java-1.6.0_26 apache-tomcat-6.0.30 SoapUI-3.6 使用到的外部jar包有(必须的部分，需要加到Web容器中) neethi-3.0.2.jar jsr311-api-1.1.1.jar cxf-bundle-2.6.0.jar 使用到的外部jar包有(可选的部分，当且仅当作为一个独立的application运行时) jetty-http-7.5.4.jar jetty-io-7.5.4.jar jetty-server-7.5.4.jar jetty-util-7.5.4.jar jetty-continuation-7.5.4.jar wsdl4j-1.6.2.jar 准备 (以下例子来自： Oreilly - RESTful Java with JAX-RS (12-2009) (ATTiCA).pdf) 创建工程 为了后续顺利进行，首先在eclipse上先创建一个Dynamic Web Project，完成以后，一个符合war结构的工程目录会自动生成，之后可以很简单的导出为war文件，其中需要把以下jar包放到 /WebContent/WEB-INF/lib 里： neethi-3.0.2.jar jsr311-api-1.1.1.jar cxf-bundle-2.6.0.jar 另外，在工程目录下，新建一个 lib 文件夹用来存放以下可选的jar包： jetty-http-7.5.4.jar jetty-io-7.5.4.jar jetty-server-7.5.4.jar jetty-util-7.5.4.jar jetty-continuation-7.5.4.jar wsdl4j-1.6.2.jar 最后一步就是把所有这9个jar都加到工程的build path里去，这样工程就准备好了。 定义服务 这里要实现一个简单的REST服务用于对客户进行管理，包括： 创建客户 查看客户 更新客户 首先给出对应的于这些操作的服务接口： Java代码 import java.io.InputStream; import javax.ws.rs.Consumes; import javax.ws.rs.GET; import javax.ws.rs.POST; import javax.ws.rs.PUT; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.Produces; import javax.ws.rs.core.Response; import javax.ws.rs.core.StreamingOutput; @Path(/customers) public interface CustomerResource { @POS