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

目录

• 1、什么是WebService
• 2、WebService和SOAP的关系
• 3、什么是WSDL
• 4、测试WebService接口前的准备
  • （1）如何判断是WebService接口
  • （2）如何获取WebService接口相关信息
• 5、使用JMeter测试WebService接口示例
  • （1）测试计划内包含的元件
  • （2）HTTP信息头管理器内容
  • （3）HTTP请求界面内容
  • （4）运行查看结果

因为我之前对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: "http://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="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

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

</soap:Envelope>

说明：

• 可以看到，一个SOAP请求其实就是一个HTTP请求，但为了表明内容是SOAP的数据，需要加入上面请求头中SOAPAction: "http://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="http://www.w3.org/2003/05/soap-envelope" xmlns:web="http://WebXml.com.cn/">

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

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

</soap:Envelope>

逐个解释里面的元素：

• Envelope：SOAP的请求内容必须以Envelope做为根节点。
  
  xmlns:soap="http://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="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <getSupportCityResponse xmlns="http://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文件的地址。例如我们访问：http://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接口。
   
   

（2）如何获取WebService接口相关信息

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

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

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

1）访问WebService接口的地址

就是上面的地址，http://www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl。

2）如何获取请求参数

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

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

上面访问的地址解析后，如下图所示：

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

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

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

（1）测试计划内包含的元件

添加元件操作步骤：

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

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

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

（2）HTTP信息头管理器内容

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

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

如下图所示：

（3）HTTP请求界面内容

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

编辑完的界面内容如下：

说明：

1. 接口基本信息部分，就是分解这个http://www.webxml.com.cn/webServices/WeatherWebservice.asmx?wsdl地址。
2. 而请求发送的参数，就是上面用SoapUI工具来解析WebService接口，如下：

   <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:web="http://WebXml.com.cn/">
      <soap:Header/>
      <soap:Body>
         <web:getSupportCity>
            <!--Optional:-->
            <web:byProvinceName>山东</web:byProvinceName>
         </web:getSupportCity>
      </soap:Body>
   </soap:Envelope>
   

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

（4）运行查看结果

结果如下图所示：

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

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

参考：

• https://www.ruanyifeng.com/blog/2009/08/what_is_web_service.html
• https://blog.csdn.net/weixin_39113426/article/details/78677872