‘动善时’JMeter基础 — 51、使用JMeter测试WebService接口

因为我之前对WebSocket接口也不是很了解,所以本篇文章先简单的概括的说明一下WebService的相关概念。在文章的后半部分,进行测试WebSocket接口的步骤说明。

1、什么是WebService

(1)先说说什么是服务

想要理解WebService,必须先理解什么是Service(服务)。

传统上,我们把计算机后台程序(Daemon)提供的功能,称为”服务”(Service)。比如,让一个杀毒软件在后台运行,它会自动监控系统,那么这种自动监控就是一个”服务”。通俗地说,”服务”就是计算机可以提供的某一种功能。

根据来源的不同,”服务”又可以分成两种:

一种是“本地服务”:使用同一台机器提供的服务,不需要网络。

另一种是”网络服务”:使用另一台计算机提供的服务,必须通过网络才能完成。

举例来说:

  • 我现在有一批图片,需要把它们的大小缩小一半。那么,我们可以把”缩放图片”看成是一种服务。你可以使用”本地服务”,在自己计算机上用软件缩小图片,也可以使用”网络服务”,将图片上传到某个网站,让服务器替你缩小图片,完成后再通过网络送回给你。
  • 再比如,一件事你可以自己做,也可以交给另一个人去做。肚子饿了,你可以自己做饭,也可以打电话去订一份比萨,让店家替你做好送上门。

(2)什么是WebService

WebService直译就是网络服务的意思。”网络服务”的本质,就是通过网络调用其他网站的资源。

WebService服务的标准解释:WebService是一种跨编程语言和跨操作系统平台远程调用技术。

解释说明

  • 所谓跨编程语言:就是说服务端程序采用Java编写,客户端程序则可以采用其他编程语言编写,反之亦然!
  • 所谓跨操作系统平台:则是指服务端程序和客户端程序可以在不同的操作系统上运行。
  • 所谓远程调用:就是通过网络,一台计算机A上的一个程序可以调用到另外一台计算机B上的一个服务接口。

总结

  • WebService就是一个应用程序向外界暴露出一个能通过Web进行调用的API,也就是说能用编程的方法通过Web来调用这个应用程序。
  • 我们把调用这个WebService服务的应用程序叫做客户端,而把提供这个WebService服务的应用程序叫做服务端。
  • WebService是建立可互操作的分布式应用程序的一个平台,是一套标准。它定义了应用程序如何在Web上实现互操作性,可以用任何你喜欢的语言,在任何你喜欢的平台上写Web service ,只要我们可以通过Web service标准对这些服务进行查询和访问。

也就是说WebService是一个平台,是一个标准,实现跨编程语言和跨操作系统平台远程调用服务。

并且WebService规范实施的应用之间, 无论它们所使用的语言、 平台或内部协议是什么, 都可以相互交换数据。

2、WebService和SOAP的关系

可以简单的理解:WebService=SOAP+WSDL

(1)SOAP请求协议介绍

SOAP(Simple Object Access Protocol):简单对象访问协议。(也就是需要遵守的规则)

SOAP传输协议使用的就是HTTP协议,SOAP请求是HTTP中POST请求的一个专用版本,也可以说成是对HTTP中POST请求的一种封装。遵循一种特殊的XML消息格式,请求头属性Content-type设置为text/xml的时候,任何数据都可以XML化。

SOAP请求的内容

# 请求头内容
POST /WebServices/WeatherWebService.asmx HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 2.0.50727.3603)
Content-Type: text/xml; charset=utf-8
SOAPAction: "//WebXml.com.cn/getSupportCity"
Host: www.webxml.com.cn
Content-Length: 348
Expect: 100-continue
Connection: Keep-Alive

# 请求体内容
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="//schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="//www.w3.org/2001/XMLSchema-instance" xmlns:xsd="//www.w3.org/2001/XMLSchema">

<soap:Body>
    <getSupportCity xmlns="//WebXml.com.cn/">
        <byProvinceName>广东</byProvinceName>
    </getSupportCity>
</soap:Body>

</soap:Envelope>

说明

  • 可以看到,一个SOAP请求其实就是一个HTTP请求,但为了表明内容是SOAP的数据,需要加入上面请求头中SOAPAction: "//WebXml.com.cn/getSupportCity"部分来以示区别。
  • 也就是说,如果请求头中有SOAPAction属性,那么请求会被当作SOAP的内容来处理而不会当作HTML来解析。
  • 当然可以用上面指定SOAPAction头来表示内容是SOAP的内容,也可以指定 Content-Type: application/soap+xml 来表示内容是SOAP的内容。
  • SOAP请求中最后的那段XML数据,这个就是请求的具体内容,这个就是SOAP规定的请求数据格式。

(2)SOAP请求的数据格式

上面知道了SOAP请求是通过HTTP协议的POST方法来传输数据的,只不过是请求的Header中加了一些标识来说明自己是一个SOAP请求。

而发送数据的具体格式,如下所示:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="//www.w3.org/2003/05/soap-envelope" xmlns:web="//WebXml.com.cn/">

    <soap:Header>
      <m:Trans xmlns:m="//www.w3schools.com/transaction/"
      soap:mustUnderstand="1">234
      </m:Trans>
    </soap:Header>

    <soap:Body>
        <getSupportCity xmlns="//WebXml.com.cn/">
            <byProvinceName>广东</byProvinceName>
        </getSupportCity>
    </soap:Body>

</soap:Envelope>

逐个解释里面的元素

  • Envelope:SOAP的请求内容必须以Envelope做为根节点。
    xmlns:soap="//www.w3.org/2003/05/soap-envelope"不能修改,否则会出错。
  • Header:这个是可选的,如果需要添加Header元素,那么它必须是Envelope的第一个元素。
    Header的内容并没有严格的限制,我们可以自己添加一些和应用程序相关的内容,但是客户端一定要记得处理这些Header元素,可以加上mustUnderstand强制进行处理。
  • Body:这个就是请求的主题内容了,请求什么函数,参数是什么类型等等都在这里面指定。
    用标签表示一个函数,然后用子元素表示它的参数。
    在调用时不需要指定参数和返回类型,因为提供服务的一方已经规定好了数据类型,在调用时指定数据类型没有任何意义。
  • <soap:Body>里面的内容:就是请求的内容,请求的方法为getSupportCity,该方法有一个名为byProvinceName的参数,参数的值为“广东”这个字符串。

再看一下返回的内容

<?xml version="1.0" encoding="utf-8"?>

<soap:Envelope xmlns:soap="//schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="//www.w3.org/2001/XMLSchema-instance" xmlns:xsd="//www.w3.org/2001/XMLSchema">
  <soap:Body>
    <getSupportCityResponse xmlns="//WebXml.com.cn/">
      <getSupportCityResult>
        <string>广州 (59287)</string>
        <string>深圳 (59493)</string>
        <string>珠海 (59488)</string>
        <string>汕头 (59316)</string>
        <string>佛山 (59279)</string>
      </getSupportCityResult>
    </getSupportCityResponse>
  </soap:Body>
</soap:Envelope>

3、什么是WSDL

(1)WSDL的定义:WSDL(Web Services Description Language)指网络服务描述语言 。是基于 XML 的用于描述 WebServices 以及如何访问 WebServices 的语言。

(2)WSDL的作用:WSDL 是一种使用 XML 编写的文档,这种文档可描述某个 WebService服务。它可规定服务的位置,以及此服务提供的操作(或方法)。

具体的解释说明

1)WSDL到底是什么?

好比我们去商店买东西,首先要知道商店里有什么东西可买,然后再来购买,商家的做法就是张贴广告海报。

同理WebServices也一样,WebServices客户端要调用一个WebServices服务,首先要有知道这个服务的地址在哪,以及这个服务里有什么方法可以调用。

所以,WebServices务器端首先要通过一个WSDL文件,来说明自己家里有啥服务可以对外调用。

比如:

服务是什么:服务中有哪些方法,方法接受的参数是什么,返回值是什么。

服务的网络地址用哪个URL地址表示。

服务通过什么方式来调用。

2)WSDL的作用是什么?

WSDL就是一个基于XML的语言,用于描述WebServices及其函数、参数和返回值。

它是WebServices客户端和服务器端都能理解的标准格式。

因为是基于XML的,所以WSDL既是机器可阅读的,又是人可阅读的,这将是一个很大的好处。

一些最新的开发工具,既能根据你的WebServices生成WSDL文档,又能导入WSDL文档,生成调用相应WebServices的代理类代码。

3)WSDL文件存在的位置?

WSDL文件保存在Web服务器上,通过一个URL地址就可以访问到它。

客户端要调用一个WebServices服务之前,要知道该服务的WSDL文件的地址。例如我们访问://www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl,我们就可以看到这个接口下有什么方法和参数。

WebServices服务提供商可以通过两种方式来暴露它的WSDL文件地址:

1、注册到UDDI服务器,以便被人查找;

2、直接告诉给客户端调用者。

所以总结来说

  • WebServices是一个平台,是一个标准,是一个规范,不是实实在在的东西,简单的说是通过SOAP请求协议和WSDL语言构成的,但总体呈现出来的效果,也可以称之为一种技术。
  • SOAP是一种访问协议,具体的技术。
  • WSDL是一种网络服务描述语言,具体的技术。

4、测试WebService接口前的准备

(1)如何判断是WebService接口

  1. 询问开发可知。
  2. 通过地址查看可知。如果接口URL地址最后有WSDL,表示该接口为WebService接口。
  3. 通过浏览器展示的信息可知。在浏览器中访问该接口URL地址,如果返回如下图所示的内容,说明该接口就是一个WebService接口。
    image

(2)如何获取WebService接口相关信息

  1. 查看接口文档(上上策)。
  2. 通过浏览器展示的信息可知。
  3. 通过工具查看可知(这里推荐SoapUI工具)。

如果我们要调用远程的WebService接口,就必定要告诉对方,我们要调用的是一个什么方法,以及这个方法的参数的值等等。

我们以一个查询城市天气预报的地址//www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl为例,访问这个接口,我们就可以看到这个接口下有什么方法和参数。

1)访问WebService接口的地址

就是上面的地址,//www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl

2)如何获取请求参数

也就是如何表示数据,用什么格式去表示函数以及它的参数。

我经常使用SoapUI工具来解析WebService接口内容,可以获取到接口的地址,接口的个数,和接口的参数。

上面访问的地址解析后,如下图所示:

image

说明:我们要查询天气,就需要调用getSupportCity方法,后边红框中就是请求中的内容。

5、使用JMeter测试WebService接口示例

查询天气的WebService服务的WSDL文档访问地址://www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl

(1)测试计划内包含的元件

添加元件操作步骤

  1. 创建测试计划。
  2. 创建线程组:选中“测试计划”右键 —> 添加 —> 线程(用户) —> 线程组
  3. 在线程组中,添加配置元件HTTP信息头管理器组件:选中“线程组”右键 —> 添加 —> 配置元件 —> HTTP信息头管理器
  4. 在线程组中,添加取样器“HTTP请求”组件:选中“线程组”右键 —> 添加 —> 取样器 —> HTTP请求
  5. 在线程组中,添加监听器“察看结果树”组件:选中“线程组”右键 —> 添加 —> 监听器 —> 察看结果树

最终测试计划中的元件如下:

image

点击运行按钮,会提示你先保存该脚本,脚本保存完成后会直接自动运行该脚本。

(2)HTTP信息头管理器内容

前面说过SOAP传输协议是一种封装的HTTP中的POST请求,并且请求头属性Content-type设置为text/xml的时候,任何数据都可以XML化。

所需我们需要在请求的请求头信息中,添加Content-type=text/xml

如下图所示:

image

(3)HTTP请求界面内容

在JMeter中,并没有发送SOAP请求的取样器,又因为SOAP传输协议是一种封装的HTTP中的POST请求,所示我们创建一个HTTP请求取样器,来发送SOAP请求即可。(请求方式POST)

编辑完的界面内容如下:

image

说明

  1. 接口基本信息部分,就是分解这个//www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl地址。
  2. 而请求发送的参数,就是上面用SoapUI工具来解析WebService接口,如下:
    <soap:Envelope xmlns:soap="//www.w3.org/2003/05/soap-envelope" xmlns:web="//WebXml.com.cn/">
       <soap:Header/>
       <soap:Body>
          <web:getSupportCity>
             <!--Optional:-->
             <web:byProvinceName>山东</web:byProvinceName>
          </web:getSupportCity>
       </soap:Body>
    </soap:Envelope>
    

    这种格式的数据,只能放在消息体数据选项页中。

(4)运行查看结果

结果如下图所示:

image

和在SoapUI工具中请求的数据一样,如下图:

image

这就说明我们使用JMeter访问WebService接口成功了。

参考: