文档章节

JAX-RS 方式的 RESTful Web Service 开发

小致dad
 小致dad
发布于 2016/07/13 14:31
字数 2600
阅读 16
收藏 0
点赞 0
评论 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
粉丝 116
博文 510
码字总数 556749
作品 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
【2016-05-08】Jersey vs. SpringMVC

当前Web Service 常用的风格有两种,RESTful风格和RPC风格。 一、RESTful与RPC简介 RPC的中心是方法,REST的中心是资源。 RPC:其中RPC风格中常见的有XML-RPC和JSON-RPC,JSON以其简洁、传输...

rathan0
2016/05/08
1K
0
Apache Wink 1.3.0 发布,结束孵化过程

Apache Wink 1.3.0 发布了,从此 Wink 结束孵化状态开始成为 Apache 的顶级项目。 Apache Wink是一个是使用简单,稳定的Java框架,用于创建RESTful web services应用程序。Wink包括了一个服务...

oschina
2013/04/14
1K
2
RESTful Web服务创建框架--Apache Wink

Apache Wink是一个是使用简单,稳定的Java框架,用于创建RESTful web services应用程序。Wink包括了一个服务器端模块和一个客户端模块,用于帮助开发者快速高效的开发RESTful Web services应...

匿名
2009/09/08
6.9K
0
最好的8个Java RESTful框架

过去的每一year,涌现出越来越多的Java框架。就像JavaScript,每个人都认为他们知道一个好的框架的功能应该是怎么样的。连我的老祖母现在也使用 一个我从来没有听说过而且可能永远不会使用的...

李景枫
2016/05/03
8.6K
27
Apache Wink 1.2.0-incubating 发布

Apache Wink 已经一年多了,还在孵化阶段,目前发布了 1.2.0 版本,完整的发布详情请下载后查看: http://incubator.apache.org/wink/downloads.html Apache Wink是一个是使用简单,稳定的Jav...

oschina
2012/05/24
647
2

没有更多内容

加载失败,请刷新页面

加载更多

下一页

JavaEE——JavaScript

声明:本栏目所使用的素材都是凯哥学堂VIP学员所写,学员有权匿名,对文章有最终解释权;凯哥学堂旨在促进VIP学员互相学习的基础上公开笔记。 JavaScript 内置对象 String对象方法: date对象...

凯哥学堂
7分钟前
0
0
Git 远程代码回滚master

方式一(推荐): git revert commit-id 方式二(不推荐):不推荐原因:推送到线上后,其它开发人员需要重新clone git reset --hard commit-id git push origin HEAD --force...

浮躁的码农
7分钟前
0
0
Elasticesearch学习(7)—— ES查询与Java API的对应关系

1、普通查询 类型 ES查询语句 Java查询实现 结果 查询格式 { "query": { "bool": { "must": [], "must_not": [], "should": [], "filter": [] } }, "from": 0, "size": 10, "sort": [] } Que......

叶枫啦啦
8分钟前
4
0
getElementsByClassName()与getElementById()区别

1.document.getElementsByClassName() 返回的是数组 使用:document.getElementsByClassName("className")[0].innerText='具体内容' 2.document.getElementById() 返回的是单个元素 使用:d......

botkenni
18分钟前
0
0
MyBatis入门

一、安装 <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>x.x.x</version></dependency> 二、从 XML 中构建 SqlSessionFactory String r......

一个yuanbeth
19分钟前
0
0
聊聊spring cloud的LoadBalancerAutoConfiguration

序 本文主要研究一下spring cloud的LoadBalancerAutoConfiguration RibbonAutoConfiguration spring-cloud-netflix-ribbon-2.0.0.RC2-sources.jar!/org/springframework/cloud/netflix/ribb......

go4it
22分钟前
0
0
【转】使用Lombok来优雅的编码

前言 Lombok 是一种 Java™ 实用工具,可用来帮助开发人员消除 Java 的冗长,尤其是对于简单的 Java 对象(POJO)。它通过注解实现这一目的。 正文 添加依赖 在 pom.xml 文件中添加相关依赖:...

HAVENT
24分钟前
0
0
Dubbo 源码解读 —— 可支持序列化及自定义扩展

一、概述 从源码中,我们可以看出来。目前,Dubbo 内部提供了 5 种序列化的方式,分别为 fastjson、Hessian2、Kryo、fst 及 Java原生支持的方式 。 针对不同的序列化方式,对比内容如下: 名...

Ryan-瑞恩
31分钟前
0
0
MySQL内存设置—— MySQL server has gone away

set global max_allowed_packet=268435456

一梦心草
41分钟前
0
0
推导式

列表、集合和字典推导式 列表推导式是Python最受喜爱的特性之一。它允许用户方便的从一个集合过滤元素,形成列表,在传递参数的过程中还可以修改元素。形式如下: [expr for val in collect...

火力全開
46分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部