...
| Table of Contents | ||
|---|---|---|
|
REST 客户端迁徙（从 9.7.x 及更早版本）
REST 客户端工具在版本 9.8 中进行了重新设计，以方便配置过程并提供额外的灵活性。
...
当执行具有不受支持的映射的遗留工具时，该工具将会失败，因为有一个映射问题的质量任务。
Resource 选项卡
在 Resource 选项卡中，指定资源为要发送的消息。默认服务定义模式（不受约束）允许指定访问服务的 URL 和查询。如果服务定义（OpenAPI/Swagger、RAML、WADL）可用，则可以将其更改为其中一个受约束的配置模式。
大多数可用控件将随服务定义字段设置的内容不同而有所变化：
- None：如 REST 客户端 Unconstrained Configuration中所述。
- OpenAPI/Swagger: 如 REST 客户端OpenAPI/Swagger Configuration中所述。
- RAML: 如 REST 客户端 RAML Configuration中所述。
- WADL: 如 REST 客户端 WADL Configuration中所述。
参数可在 Path 和 Query 选项卡中配置，如 REST 客户端 Parameter Configuration中所述。
| Anchor | ||||
|---|---|---|---|---|
|
不受约束的模式（该模式在 Service Definition 设置为 None时启用）允许指定 URL 作为文字字符串，它可以是一个固定值、参数化值或脚本化值。此外，调用的方法也可以指定为固定值、参数化值或脚本化值。 更多详情
...
参数可在 Path 和 Query 选项卡中配置，如 REST 客户端 Parameter Configuration中所述。URL 中的任何变更将自动传播给 Path/Query 表。同时，URL 将自动更新将任何更改映射给 Path/Query 表。
| Anchor | ||||
|---|---|---|---|---|
|
RAML 配置模式允许指定不同的 URL 参数，如下所示：
...
参数可在 Path 和 Query 选项卡中配置，如 REST 客户端 Parameter Configuration中所述。URL 将自动更新将任何更改映射给 Path/Query 表。
| Anchor | ||||
|---|---|---|---|---|
|
OpenAPI/Swagger 配置模式允许指定不同的 URL 组件，如下所示：
...
参数可在 Path 和 Query 选项卡中配置，如 REST 客户端Parameter Configuration中所述。URL 将自动更新将任何更改映射给 Path/Query 表。
| Anchor | ||||
|---|---|---|---|---|
|
WADL 配置模式允许指定不同的 URL 组件，如下所示：
...
参数可在 Path 和 Query 选项卡中配置，如 REST 客户端Parameter Configuration中所述。URL 将自动更新将任何更改映射给 Path/Query 表。
切换视图
如果将受约束的模式（Service Definition 设置为 RAML, OpenAPI/Swagger, 或 WADL））切换为不受约束的模式（Service Definition 设置为 None），则将可以选择使用受约束视图中的值自动填充不受约束的视图。
...
如果选择了从 WADL 视图填充不受约束的视图，则将得到以下内容：
| Anchor | ||||
|---|---|---|---|---|
|
在所有模式中（受约束的和不受约束的），参数都可以在 Path 和 Query 选项卡中进行配置。
模板参数
Paths 选项卡允许为当前选择的操作配置模板参数。例如，路径“/parabank/services/bank/accounts/{accountId}”只有一个路径参数："accountId"。
...
在受约束的模式中，参数设置为固定、参数化、自动生成或者脚本化。
查询参数
Query 选项卡允许为当前选择的操作配置 URL 查询参数。可以添加固定的、参数化的或脚本化的值。
...
如果希望使用不同的格式，则查询参数也可以直接在工具端点 URL（而不是查询参数部分中）末尾指定。例如，以下内容也可以指定为 http://host:8080/path?a=1&b=2&c=3
矩阵参数
矩阵参数可以通过直接将它们追加到资源 URL 最后一个路径段末尾进行配置。例如，以下参数也可以指定为 http://host:8080/path;jsessionid=12345
Payload 选项卡
如果正使用某个方法发送数据（如。PUT、POST、DELETE），则 Payload 选项卡允许为将发送的消息指定有效负荷。
...
指定有效负荷之后，可以从 Input Mode 下拉列表中选择输入模式。REST 客户端工具将与其他客户端工具共享 Input Mode 选项。有关共享选项的更多详情，请查阅 输入模式Input Modes。
关于与模式相关的 XML 或 JSON，根据定义和编辑中的值自动填充的可用表单视图将受到限制，以确保该消息遵循指定模式。例如，你将无法对树节点进行插入、删除、重命名、复制或粘贴操作。
HTTP Options 选项卡
HTTP 选项允许确定使用哪个协议（HTTP 1.0 或 1.1）发送请求，以及与协议（安全、数据头、cookie等）相关的各种选项。
...
Virtualize
Misc 选项卡
以下选项可以在 REST 客户端工具的 Success Criteria 选项卡中使用。
- 有效的 HTTP 响应码：允许自定义工具行为，以便它成功地处理了 2xx 范围之外的 HTTP 响应码。将单个代码和/或代码范围指定为逗号分隔的列表。例如，如果使用
"302, 500-599"，则将接受302码或5xx范围内的任何码。 如果正在使用参数化值，则请保证数据源中的值使用与之相同的格式（如，"302, 500-599"）。 超时时间（以毫秒为单位）：指定 FTP、telnet 或 HTTP 请求“超时后应该延迟的长度（以毫秒为单位）。Default 设置对应于首选项面板的超时设置。Custom 设置允许输入超时时间。可以输入一个负超时值，表示指定无限的超时。
- 因超时导致测试失败：如果希望工具在指定超时时间内完成任务，则选择该选项。
- 只在发生超时时才通过测试：如果发生指定的超时（如，测试在指定的时间内没有完成执行），请选择此选项让工具通过。
Outgoing Message Encoding: 从下拉菜单中选择 Custom ，然后输出消息选择编码。默认使用在最接近父测试套件中配置的编码 （请查阅 Specifying Client Options）。也可以在 Parasoft 首选项 Misc 设置中全局指定该选项。（请查阅 Additional Preference Settings）。
相关教程
以下教程演示如何使用这个工具：