文档章节

JAX-RS 方式的 RESTful Web Service 开发

小致dad
 小致dad
发布于 2016/07/13 14:31
字数 2600
阅读 19
收藏 0

Web Service 目前在风格上有两大类,一个是基于 SOAP 协议,一个是完全遵循 HTTP 协议规范的RESTful 风格。 SOAP 方式的 web service 已经很成熟了,应用也很广,已经成为 Web Service 的工业标准。不过 RESTful Web Service 现在势头越来越猛,特别是其灵活性以及与 Ajax 的完美结合,让人爱不释手,很有必要了解一下。 RESTful 就是一种架构风格,是对 HTTP 协议的完全遵循。像是人们经历了无止境的对 HTTP 引申、扩展之路后的一种回归,让 web service 开发者重新做回 HTTP 协议的信徒。 RESTful 倡导用 HTTP 协议中的 verb 与实际数据操作的增删改查相对应,如 HTTP 中的 PUT 、 GET 、 POST 、DELETE 分别对应 web 系统中数据的改、查、增、删的操作。当然 RESTful 支持的 http verb 还不仅限于上述 4 个,还有像其他的 HEAD,OPTION ……等,不过上述 4 个已经够我们日常使用了。

目前 Web Service 的框架很多,不过我只用过 CXF ,所以我还是以 apache-cxf2.2.2 为例介绍一下 RESTful Web Service 的开发。

比较常见的 RESTful Web Service 的发布有 JAX-RS 风格、 Provider 方式、 Servlet 方式、 HTTPBinding ,也许还有其他方式,不过我只知道这些了。总的感觉最偷懒的方式是采用 Servlet 方式发布 Web Service ,说是 Web Service 发布,其实就是转换下对 Servlet 的认识, Servlet 本身就支持对 HTTP 请求中各种动作的支持,所以 Servlet 原生就是一种 RESTful Web Service 。不过这种方式我觉得有些不够时尚。 Povider 的方式我了解了一下,需要实现 Provider 接口,感觉很受拘束。正在我对 RESTful 丧失兴趣的时候,发现了 JAX-RS 风格, JAX-RS 就像是一个清纯 MM ,服务端配置完成,而且配置非常的清秀。而且也非常的平易近人,客户端调用方式很灵活。接下来我就把她介绍给大家。

1.      环境搭建

在本示例中采用了 Web Project 的方式, Web 工程建立的过程就不再赘述了,只列举一下环境需要的 jar包。如下:

下面是我本地工程中的 jar ,仅供参考。

环境信息

注:如果要在 RESTful 服务中直接返回 json 数据格式的话, jsr311-api-1.0.jar 必不可少。

2.      服务开发

我们以简单的一个客户信息服务为例进行介绍。服务的业务实现大家不用太在意,关注服务开发的过程就好了。

2.1   开门见山

首先我们先构造一个客户的 VO 。

package com.harvey.cxf.demo.rest.rs.vo;  
  
import javax.xml.bind.annotation.XmlAccessType;  
import javax.xml.bind.annotation.XmlAccessorType;  
import javax.xml.bind.annotation.XmlRootElement;  
  
@XmlRootElement(name = "Customer")  
@XmlAccessorType(XmlAccessType.FIELD)  
public class Customer {  
    private long id;  
    private String name;  
  
    public long getId() {  
        return id;  
    }  
  
  
    public void setId(long id) {  
        this.id = id;  
    }  
  
    public String getName() {  
        return name;  
    }  
  
    public void setName(String name) {  
        this.name = name;  
    }  
}  

接下来以 CustomerService 作为客户服务的实现类

先以最常见的查询某一客户信息为例,如下:

@Path("/")  
public class CustomerService {  
    ……  
   //普通路径参数方式GET请求  
    @GET  
    @Path("/customers/{id}")  
    public Customer getCustomer(@PathParam("id") String id) {  
        ……  
    }  
}  

假设我们的服务最终发布地址为 http://127.0.0.1:8080/customerservice 的话,如果要查询某一客户的信息的话,我们只需发送 GET 请求 http://127.0.0.1:8080/customerservice/customers/123 ,或者直接在浏览器中输入该 url就可直接访问该服务。其中 url 中传入的 123 会自动适配到服务中的 {id} 参数。这样一个简单的处理 GET 请求的RESTful Web service 就开发完了。

2.2 参数处理

在上面的例子中我们看到, client 在服务请求时传递参数是通过的请求路径的方式传入的。如之前的http://127.0.0.1:8080/customerservice/customers/123 , 客户 ID123 作为了路径一部分。对应的服务器端的参数配置采用了 @PathParam ( "id" ) String id 。 
除了支持路径传递的方式之外,我们还可以在请求时的查询参数中指定。比如还是查询某一客户的信息,server 端代码可以如下:

……  
@GET  
    @Path("/customers/getCustomerById")  
    public Customer getCustomerByQueryString(@QueryParam("id") String id){  
       ……  
    }  

此时该服务访问 url 则为:

http://127.0.0.1:8080/customerservice/customers/getCustomerById?id=123

说着这,也许会有听众要问了(也许没人问):之前提到的都是简单参数,这个容易,那么对于一些复杂bean 参数该怎么处理呢?

这个问题问得好,接下来我就举例说明下。说例子之前再重复一遍啊,看例子时千万不要纠结于代码的业务逻辑,只看技术实现方式。

……  
@GET  
    @Path("/customers/getCust")  
    public Customer getCustomer(@QueryParam("")Customer cust) {  
        ……  
}  

这个例子中需要传入之前声明的客户信息类作为参数。参数处理方式为 QueryParam ,所以这时候我们访问url 格式类似以下:

http://127.0.0.1:8080/customerservice/customers/getCust?id=123&name=xiaoming

如果参数 bean 还包括其他属性,用 & 符号依次追加就好了。还通常的 web 访问没什么区别。

如果你觉得上述用查询字串的方式不够个性的话,可以采用另外一种: @MatrixParam

Server 端代码如下:

……  
@GET  
    @Path("/customers/getCustByMat")  
    public Customer getCustomerByMat(@MatrixParam("")Customer cust) {  
        ……  
}  

这时候我们再访问时就可以用下面的形式了:

http://127.0.0.1:8080/customerservice/customers/getCustByMat;id=123;name=xiaoming

如果 cusmomer 还有其他属性,直接在后面追加就可以了,参数之间用 ; 分隔 .

以上我们用到的参数虽然采用的处理方式的注解各不相同,但是都是有注解的。接下来出场的这个就属于特殊人物了。有请 body 参数出场……

……  
@POST  
    @Path("/addCustomer")  
    public Customer addCustomer(String body) {  
    ……  
}  

这个 body 参数是 JAX-RS 中比较特殊的,它前面没有任何注解,它代表的是请求的 body 内容或者请求的inputstream ,自动解析映射为字符串参数。因为之前我们的例子都是 GET 请求,消息中是没有 body 的,所以细心的听众可能会发现我们这次的服务的 verb 配置为了 @POST 。

2.3 请求、应答数据格式

之前的示例中我们的方法都返回了 Customer ,但是我们的系统是一个 RESTful web service 啊,客户端接收到的肯定是一个 HTTP 的 response 消息,那么返回的 Customer 是怎样的一个消息内容呢?

默认情况下 reponse 消息的 Customer 会以 xml 的格式返回。类似于:

<Customer><id>123</id><name>skdjl</name></Customer>

客户端调用 server 端服务,得到上述的 xml 字串结果,然后进行后续处理。

既然这说的默认情况,言外之意就是说还有很多其他情况了,不过需要配置一下。就不得不说下@Produces注解了。@Produces就是表示server端返回的数据格式类型,具体包括application/xml, application/json, application/text……,其实就是我们常见的web端的content-type中的类型。如果我们设置为application/json,自然返回的数据格式为json形式。另一个注解:@Consumes,就是与@Produces相对应的。@Consumes是设定的客户端发送的请求数据的格式,对应支持的类型与@Produces相同。具体配置如下:

……  
@POST  
    @Path("/addCustomerUseBean")  
    @Produces("application/json")  
    @Consumes("application/xml")  
    public Customer addCustomerUseBean(Customer cust) {  
        ……  
    }  

 这个例子的意思是客户端传入 Customer 作为参数,传递格式为 xml 风格, server 端应答的数据格式为json 风格。我们当然也可以在类注解中加入 @Produces 和 @Consumes 作为服务整体的 request 和 response风格,具体服务方法如果不设定的话采用类的 @Produces 和 @Consumes 的设定。

3        服务配置

服务开发完成之后,我们要做的就是把服务发布出去。发布方式也很灵活,可以采用编码的方式,也可以和spring 结合用配置的方式。在下面的例子中我们采用后者。配置的内容不再做过多的解释,大家看一下就能明白。

3.1   web.xml 的配置

<?xml version="1.0" encoding="UTF-8"?>  
  
<web-app version="2.4"  
         xmlns="http://java.sun.com/xml/ns/j2ee"  
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee  
         http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  
  
         <display-name>DEMO</display-name>  
         <context-param>  
                   <param-name>contextConfigLocation</param-name>  
                   <param-value>classpath*:/applicationContext*.xml</param-value>  
         </context-param>  
  
         <listener>  
                  <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
         </listener>  
  
         <listener>  
         <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>  
         </listener>  
  
         <servlet>  
                 <servlet-name>CXFServlet</servlet-name>  
                 <servlet-class>  
                          org.apache.cxf.transport.servlet.CXFServlet  
                 </servlet-class>  
                 <load-on-startup>1</load-on-startup>  
          </servlet>  
  
         <servlet-mapping>  
                 <servlet-name>CXFServlet</servlet-name>  
                 <url-pattern>/services/*</url-pattern>  
          </servlet-mapping>  
  
  <welcome-file-list>  
    <welcome-file>index.jsp</welcome-file>  
  </welcome-file-list>  
</web-app>  

3.2   spring 配置文件

<?xml version="1.0" encoding="UTF-8"?>  
  
<beans  
         xmlns="http://www.springframework.org/schema/beans"  
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
         xmlns:aop="http://www.springframework.org/schema/aop"  
         xmlns:cxf="http://cxf.apache.org/core"  
    xmlns:jaxws="http://cxf.apache.org/jaxws"  
    xmlns:jaxrs="http://cxf.apache.org/jaxrs"  
  
         xsi:schemaLocation="  
         http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
         http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd  
         http://cxf.apache.org/jaxrs http://cxf.apache.org/schemas/jaxrs.xsd  
         http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd">  
  
         <import resource="classpath:META-INF/cxf/cxf.xml" />  
         <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />  
         <import resource="classpath:META-INF/cxf/cxf-servlet.xml" />  
         <import resource="classpath:META-INF/cxf/cxf-extension-jaxrs-binding.xml"/>  
  
   <jaxrs:server id="customerService" address="/customerservice">  
                   <jaxrs:serviceBeans>  
          <ref bean="customerServiceBean"/>  
        </jaxrs:serviceBeans>  
   </jaxrs:server>  
   <bean id="customerServiceBean" class="com.harvey.cxf.demo.rest.rs.server.CustomerService"/>  
</beans>  

然后启动我们的 web 程序,服务就发布完成了。可以在浏览器中敲入:

http://127.0.0.1:8080/customerservice/customers/1 测试服务是否正常。

从上面的例子也许你能发现,我们虽然是做的RESTful的例子,但是具体提供的服务verb中很多都是带有动作的成分比如getCustomer,addCustomer等等,这些词汇的存在预示着我们的服务虽然采用了RESTful的技术,但是并没有遵循ROA(面向资源的架构)的理念,真正的ROA信徒看到上面的例子可能会非常不爽。因为毕竟RESTful和ROA才是青梅竹马。不过正如前面提到的,大家值关注技术实现就好了。

4        客户端调用

我们的服务发布完成了,接下来我们可以做一个测试 client 程序进行 测试。对于 RESTful 的调用方式很多,可以用 java 的 Connect 方式,也可以用 apche 的 httpclint ,另外还可以用 cxf 提供的 WebClient 进行,等等。后面的 client 代码中分别采用几种调用方式,在这里我们不必拘泥,可以任意选用自己熟悉的方式。

© 著作权归作者所有

共有 人打赏支持
小致dad
粉丝 133
博文 533
码字总数 580132
作品 0
济南
技术主管
基于SOA 思想下的WebService实战资料分享

跟大家分享基于SOA 思想下的WebService实战(电子商务需求,分析,架构全涉及,百万数据优化) 课程讲解内容涵盖: 第1章 CXF框架快速起步(2课时) Webservice技术规则 Java-WebService技术规范...

abcfhl
2013/06/24
1K
7
Jersey - RESTful Web Services in Java.

Developing RESTful Web services that seamlessly support exposing your data in a variety of representation media types and abstract away the low-level details of the client-serve......

火龙战士
2015/07/14
0
0
Jersey : Java规范下REST风格Web Service开发框架

Sun正在致力于建立RESt风格Web服务的规范, 规范如下 JSRs: Java Specification Requests JSR 311: JAX-RS: The JavaTM API for RESTful Web Services 链接:http://jcp.org/en/jsr/detail?......

hans汉斯
2010/01/13
0
0
使用 Jersey 和 Apache Tomcat 7 构建 JAX-RS 环境

前两天开始看Web Service方面的资料,项目中使用的是Axis,Axis支持的是JAX-WS的API。现在比较流行RESTful,就顺便学习一下JAX-RS。 选择的框架是Jersey 1.13。比较了一下Apache CXF和Jerse...

canghailan
2012/08/10
0
0
java web service索引

正规军: 基于SOAP的JAX-RPC , JAX-WS, 基于RESTful的JAX-RS 杂牌:Apache系列。 书 RESTful Java with JAX-RS 2.0 RESTful Web Services with Dropwizard 以下这篇博客就是使用了JAX RS ht......

cyper
2014/06/11
0
0

没有更多内容

加载失败,请刷新页面

加载更多

一次由HandlerInterceptor进行的深入思考

HandlerInterceptor 是SpringFramework为我们提供的拦截器,一般我们可以用来鉴权或者日志记录等。 它是一个interface,主要方法有: /** * Intercept the execution of a handler. Called...

kipeng300
28分钟前
1
0
cmd中查询mysql表出现中文乱码

问题:在pycharm中正常的fetchall拉取数据,能够正常显示,而在cmd中直接select却出现中文乱码。 解决思路:右键查看cmd命令窗口属性得到,cmd窗口默认编码是gbk(如下图所示),而设置的mys...

fang_faye
54分钟前
2
0
centOS 安装Python3与python2并存

centOS 安装Python3与python2并存 如果本机安装了python2,尽量不要管他,使用python3运行python脚本就好,因为可能有程序依赖目前的python2环境, 比如yum!!!!! 不要动现有的python2环...

MedivhXu
今天
2
0
Spring JdbcTemplate模板模式与回调结合分析

在看Spring的JdbcTemplate的时候,看到其将模板模式和回调模式结合使用的实现,可以精妙的解决很多的问题。详见Spring中涉及的设计模式总结中的关于模板模式和回调模式结合的具分析,本文利用...

宸明
今天
1
0
docker update:更新一个或多个容器的配置

更新容器的配置 docker update:更新一个或多个容器的配置。 具体内容请访问:https://docs.docker.com/engine/reference/commandline/update/#options 语法:docker update [OPTIONS] CONTA...

lwenhao
今天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部