用例步骤说明
- 1 单接口用例步骤
- 2 场景用例步骤

用例步骤说明

1 单接口用例步骤

1.1 前置脚本

前置脚本可以添加为请求的子步骤，在请求发送前执行，可以用在修改请求内容、初始化请求需要的参数值等场景。

目前 MeterSphere 支持以下几种语言的前置脚本：

BeanShell
Python2
Groovy
NashornScript
RhinoScript

与 JMeter 一样，脚本在加载前已经内置了部分变量，在脚本中可以直接使用这些变量。

log - [Logger]，用于在脚本执行过程中打印日志

//打印 `Hello World!` 到 info 日志中
log.info("Hello World!");

Label - 前置脚本所属请求的请求名称

SampleResult - 当前请求请求结果 SamplerResult 的指针

//设置请求结果成功或失败
SampleResult.setSuccessful(true/false);
//设置请求返回码
SampleResult.setResponseCode("code");
//设置请求返回消息
SampleResult.setResponseMessage("message");

sampler - 当前请求 sampler 的指针

//获取当前请求名称
sampler.getName();

vars - JMeterVariables，用于操作变量

//获取变量 VAR1 的值
vars.get("VAR1");
//设置变量 VAR2 的值为 value
vars.put("VAR2","value");
//移除变量 VAR3
vars.remove("VAR3");

说明

不同脚本语言语法不同，以上示例仅针对 BeanShell 或 Groovy。

MeterSphere 提供了多种不同类型和范围的标准代码模板，同时还支持用户自定义代码模板。代码模版分为：API测试、自定义变量、项目环境、自定义代码片段、异常处理。

1.1.1 API测试

API定义导入可以直接导入 API 或 CASE 自动生成脚本。点击【API定义导入】

选择任一 API/CASE，点击确定，会在 beanshell 中自动生成脚本

点击【新API测试[json]】可以自动生成 json 请求方式的 API 请求模板。

1.1.2 自定义变量

可自动生成获取变量的脚本，获取提取参数和环境变量等。

可自动生成设置变量的脚本，自定义设置变量。

可自动生成获取响应头、获取响应码、获取响应等脚本，以获取接口调试结果中的响应头、响应码、响应结果等信息。

1.1.3 项目环境

注意

vars.put(${__metersphere_env_id}+”key”,”value”); // 将值存储为环境变量，可在【环境-通用设置】处看到值
vars.put(“key”,”value”)。 // 将值存储为场景变量
存为环境变量的值，在当前请求引用不到，结合存为变量的代码，在当前请求以及之后请求都可引用到

设置环境参数将变量设置为项目环境变量，供当前环境下的所有接口使用。

1.1.4 自定义代码片段

自定义代码片段可直接选择导入项目管理中维护的所有自定义代码片段。

1.1.5 终止测试

可自动生成终止测试线程的脚本，设置终止测试异常条件，接口或场景执行过程中匹配到终止条件则终止该进程。

1.2 后置脚本

后置脚本与前置脚本类似，可以添加为请求的子步骤，在请求发送后执行，可以用于处理响应结果，从中提取变量等场景。

1.3 前置 SQL

在请求发送之前执行 sql 脚本。

界面说明

选择运行环境。
选择数据库。
设置超时时间。
将返回结果的所有字段存储到一个变量中。
直接指定取出返回结果字段的值，列名要和SQL语句中查询返回结果列名对应。只取最后一列数据，可以用逗号作为占位符代替列名，只写出要提取的列名即可。
自定义变量。
SQL脚本编辑。

说明

通过 {phone_n} 进行引用，n为行数，为 phone 列的第一行值。

1.4 后置SQL

后置SQL与前置SQL类似，在请求执行完成后的SQL处理。

1.5 断言规则

断言的主要功能是通过验证响应报文是否满足需求规约来验证接口运行是否正确。

界面说明

断言方式选择。
断言配置区域，根据选择的断言方式不同，展示不同的配置内容。
是否忽略结果状态选项，例如希望进行返回码为 401 的断言时，需要勾选该选项，否则请求仍会被视为失败状态。
添加断言按钮，在同一个断言步骤内可以添加多条断言，断言编辑完成后需要点击 添加 按钮进行添加。
保存按钮，保存当前断言规则步骤内容。
推荐 JSONPath 断言，当请求的响应体是 JSON 格式时，可以使用该功能辅助生成 JSONPath 断言。
清空 JSONPath 断言，清空自动添加的 JSONPath 断言。

目前 MeterSphere 支持以下几种形式的断言规则：

文本
正则
JSONPath
XPath
响应时间
脚本
文档结构校验

1.5.1 文本断言

文本断言直接选择文本内容进行判断即可。

参数说明

对象：希望进行断言的对象，支持选择 Response Code，Response Headers，Response Data 。
条件：断言条件支持选择包含，不包含，等于，以...开始，以...结束 。
值：断言对象需要匹配的值，匹配成功则断言成功，否则断言失败。

示例

请求的响应码：

断言需求：判断响应码等于 200。

断言配置：

对象：Response Code
条件：等于
值：200

1.5.2 正则断言

正则断言较为灵活，适用于请求的响应内容不是 JSON、XML、HTML 等这样的标准且常见的结构化文本时。

参数说明

对象：希望进行断言的对象，支持选择 Response Code，Response Headers，Response Data。
Perl型正则表达式：断言对象需要匹配的正则表达式，匹配成功则断言成功，否则断言失败。

示例

请求的响应体：

id="ddc86657-d402-4c10-b458-2ba2e4604cef"&name="myorg"&description="test org"

断言需求：判断响应体中包含 name="任意文本"。

断言配置：

对象：Response Data
Perl型正则表达式：name=".*?"

1.5.3 JSONPath 断言

JSONPath 断言适用于请求的响应内容是 JSON 格式时，可以方便的通过 JSONPath 表达式定位到特定字段，设定其期望值。

参数说明

JSONPath表达式：JSONPath 表达式，通过该表达式定位到特定字段。
期望值：通过 JSONPath 表达式定位的字段的期望值，支持正则表达式。

示例

请求的响应体：

{
    "success": true,
    "message": null,
    "data": {
        "id": "ddc86657-d402-4c10-b458-2ba2e4604cef",
        "name": "myorg",
        "description": "form api",
        "createTime": 1611154807818,
        "updateTime": 1611154807818
    }
}

断言需求：判断响应体 data 中的 name 字段值为 myorg

断言配置：

- JSONPath 表达式：$.data.name
- 期望值：myorg

1.5.4 XPath 断言

XPath 断言适用于请求的响应内容是 XML、HTML 等格式时，可以方便的通过 XPath 表达式定位到特定字段，设定其期望值。

参数说明

XPath表达式：需要进行匹配的 XPath 表达式

示例

请求的响应体：

<root xmlns:foo="http://www.foo.org/" xmlns:bar="http://www.bar.org">
    <employees>
        <employee id="1">Johnny Dapp</employee>
        <employee id="2">Al Pacino</employee>
        <employee id="3">Robert De Niro</employee>
        <employee id="4">Kevin Spacey</employee>
        <employee id="5">Denzel Washington</employee>
    </employees>
    <foo:companies>
        <foo:company id="6">Tata Consultancy Services</foo:company>
        <foo:company id="7">Wipro</foo:company>
        <foo:company id="8">Infosys</foo:company>
        <foo:company id="9">Microsoft</foo:company>
        <foo:company id="10">IBM</foo:company>
        <foo:company id="11">Apple</foo:company>
        <foo:company id="12">Oracle</foo:company>
    </foo:companies>
</root>

断言需求：判断响应体中的 id 为 10 的公司名称为 IBM

断言配置：

- XPath 表达式：//foo:company[@id=10]='IBM'

1.5.5 响应时间断言

响应时间断言适用于对请求的响应时间有特定要求时。

参数说明

响应时间在…毫秒以内：以毫秒为单位的响应时间期望，当实际响应时间小于等于该值时断言成功。

1.5.6 脚本断言

脚本断言提供了更加强大、灵活的处理能力，通过可以根据自身需求选择合适的语言编写脚本来设定断言结果，适用于常规断言无法满足需求时。

参数说明

编辑按钮：点击弹出脚本断言编辑页面。
添加按钮：脚本编辑完成后，点击添加到断言列表中。
脚本生成工具：针对简单的变量值判断的脚本，可以通过该工具快速生成脚本。
脚本名称：断言脚本的名称。
脚本内容：断言脚本内容。
语言切换及代码模板：切换脚本语言，与前后置脚本一样，目前支持 BeanShell、Groovy、Python 、NashornScript及RhinoScript 脚本语言。

与前后置脚本一样，脚本在加载前已经内置了部分变量，除了在之前已经介绍过的变量外，脚本断言中的脚本还额外提供了以下变量。

AssertionResult - 断言结果对象，可以通过 AssertionResult.setFailure(true) 方法设置断言是否成功，通过 AssertionResult.setFailureMessage("message") 方法设置断言失败提示信息。

1.5.7 文档结构校验

文档结构校验断言目前提供 JSON 和 XML 两种格式的文档。

文档格式选择【JSON/XML】，点击【添加】按钮可直接从响应体信息中选择要断言信息。

点击【+】可以手动添加内容校验。

【跟随API定义】是与 API 响应体设置返回值一致，勾选【跟随API定义】可以自动生成内容校验。

点击【导入】可导入需断言 Json/xml 文件，自动生成文档结构校验元素表格。

1.6 提取参数

参数提取功能主要用于从请求响应中提取特定返回值并存储到变量中，便于在后续的步骤中引用该返回值。

界面说明

提取方式选择。
提取参数区域，根据选择的提取方式不同，展示不同的配置内容。
是否提取多个匹配结果，例如当匹配到多个值时，可以返回 varName_n 形式的多个变量。
添加提取规则按钮，在同一个提取参数步骤内可以添加多条提取规则，提取规则编辑完成后需要点击 添加 按钮进行添加。
保存按钮，保存当前提取参数步骤内容。
推荐JSONPath提取，当请求的响应体是 JSON 格式时，可以使用该功能辅助生成 JSONPath 提取规则。
清空JSONPath提取，清空自动添加的 JSONPath 提取规则。

目前 MeterSphere 支持以下几种形式的提取方式：

正则
JSONPath
XPath

1.6.1 正则提取

正则提取较为灵活，适用于请求的响应内容不是 JSON、XML、HTML 等这样的标准且常见的结构化文本时。

参数说明

对象：希望进行提取的对象，支持选择 Body，Request Headers，Response Headers，URL，Response Code，Response Message 等对象。
变量名：保存提取值的变量名，后续可以通过 ${varName} 形式引用到，如果选择了匹配多个，可以通过 ${varName_matchNr} 获取到匹配的总个数，通过 ${varName_n} 依次获取到每个匹配值。
Perl型正则表达式：提取特定值使用的正则表达式，将提取正则表达式中的第一个组。

示例

请求的响应体：

id="ddc86657-d402-4c10-b458-2ba2e4604cef"&name="myorg"&description="test org"

提取需求1：响应体中 name 字段的值。

提取配置：

对象：Body
变量名：name
Perl型正则表达式：name="(.*?)"

1.6.2 JSONPath 提取

JSONPath 提取适用于请求的响应内容是 JSON 格式时，可以方便的通过 JSONPath 表达式定位到特定字段进行提取。

参数说明

变量名：保存提取值的变量名，后续可以通过 ${varName} 形式引用到，如果选择了匹配多个，可以通过 ${varName_matchNr} 获取到匹配的总个数，通过 ${varName_n} 依次获取到每个匹配值。
JSONPath表达式：JSONPath 表达式，通过该表达式定位到要提取的字段。

示例

请求的响应体：

{
    "success": true,
    "message": null,
    "data": {
        "id": "ddc86657-d402-4c10-b458-2ba2e4604cef",
        "name": "myorg",
        "description": "form api",
        "createTime": 1611154807818,
        "updateTime": 1611154807818
    }
}

提取需求：提取响应体 data 中的 name 字段并存储在 name 变量中。

提取配置：

变量名：name
JSONPath 表达式：$.data.name

1.6.3 XPath 提取

XPath 提取适用于请求的响应内容是 XML、HTML 等格式时，可以方便的通过 XPath 表达式定位到特定字段进行提取。

参数说明

变量名：保存提取值的变量名，后续可以通过 ${varName} 形式引用到，如果选择了匹配多个，可以通过 ${varName_matchNr} 获取到匹配的总个数，通过 ${varName_n} 依次获取到每个匹配值。
XPath表达式：需要进行匹配的 XPath 表达式。

示例

请求的响应体：

<root xmlns:foo="http://www.foo.org/" xmlns:bar="http://www.bar.org">
    <employees>
        <employee id="1">Johnny Dapp</employee>
        <employee id="2">Al Pacino</employee>
        <employee id="3">Robert De Niro</employee>
        <employee id="4">Kevin Spacey</employee>
        <employee id="5">Denzel Washington</employee>
    </employees>
    <foo:companies>
        <foo:company id="6">Tata Consultancy Services</foo:company>
        <foo:company id="7">Wipro</foo:company>
        <foo:company id="8">Infosys</foo:company>
        <foo:company id="9">Microsoft</foo:company>
        <foo:company id="10">IBM</foo:company>
        <foo:company id="11">Apple</foo:company>
        <foo:company id="12">Oracle</foo:company>
    </foo:companies>
</root>

提取需求：提取响应体中的 id 为 3 的员工的姓名，即上述响应中的 Robert De Niro，并存储在 employeeName 变量中。

提取配置：

变量名：employeeName
XPath 表达式：string(//employee[@id=’3’])

2 场景用例步骤

2.1 接口列表导入

通过接口列表导入功能，可以直接添加接口定义功能中已维护好的接口或接口下的用例，减少重复填写接口请求参数的情况。

2.1.1 导入接口

2.1.2 导入用例

说明

导入用例时提供【复制】和【引用】两种方式。通过【复制】方式导入的用例，当原用例发生变化时，场景中导入的用例不会改变；通过【引用】方式导入的用例，当原用例发生变化时，场景中导入的用例也会随之改变。

2.2 自定义请求

通过添加自定义请求，用户可以自由编辑该请求的详细信息，该请求不需要事先存在于接口定义中。目前支持 HTTP、TCP、DUBBO、SQL 等不同类型的请求。

2.3 自定义脚本

自定义脚本与前后置脚本使用方式类似，但是可以独立添加，不需要依赖于某个已有请求作为其子步骤。目前支持的脚本语言及内置变量请参考前置脚本。

2.4 场景导入

用户可以维护一些基础、通用场景，通过场景导入功能，可以直接将已有的场景添加到当前场景中，减少重复工作，提高场景的复用性。

说明

导入场景时提供【复制】和【引用】两种方式。通过【复制】方式导入的场景，当原场景发生变化时，场景中导入的场景不会改变；通过【引用】方式导入的场景，当原场景发生变化时，场景中导入的场景也会随之改变。

2.5 条件控制器

当条件控制器中配置的条件满足时，条件控制器下的子步骤才会执行，否则子步骤会被跳过。

2.6 循环控制器

通过使用循环控制器，可以重复执行循环控制器下的子步骤，目前 MeterSphere 提供了【次数循环】、【ForEach 循环】和【While 循环】三种循环方式。

2.6.1 次数循环

次数循环支持自定义设置循环次数、循环间隔等。

参数说明

循环次数：该循环控制器下的子步骤总共执行的次数。
循环间隔：每次执行间的时间间隔，以毫秒为单位。
成功后是否继续循环：仅循环控制器下存在一个请求时可以关闭。当关闭时，若循环控制器下的请求是成功状态，则立即终止循环，无论有没有达到循环次数。可以用在异步请求后轮询查询执行结果的场景，当查询结果符合预期时终止循环，避免多余的查询操作。

示例

开启【成功后继续循环】，循环总共执行了 5 次。