本文件内容：

关于该消息监听器

Equifax Message Listener 是 Parasoft Virtualize 的自定义扩展。该扩展用于虚拟化 Equifax 信用报告服务而设计。您可以创建模拟外部 Equifax 服务行为的虚拟资产——通过移除测试和开发环境中对第三方服务的依赖优化开发和测试工作。Equifax 虚拟性能允许您扩大测试覆盖率，更好地管理响应数据，在不影响实际 Equifax 服务的情况下执行性能和负载测试。

Equifax Message Listener 的实现使您可以在创建和配置虚拟资产时使用消息构造表单（表单输入和表单 XML）、数据源参数化和消息关联技术（XPaths）。如要启用该选项，扩展将 Equifax 请求消息转换到和从 XML 转换为 XMl。

安装

可以通过 UI 或命令行安装该工具。

UI 安装

  1. 前往 Parasoft > 首选项。
  2. 在系统属性首选项页面，点击添加 JARs。
  3. 在文件选择器中，查找并选择 com.parasoft.virtulaize.listener.equifax<version>.jar。
  4. 重启 SOAtest/Virtualize。

命令行安装

将 com.parasoft.virtualize.listener.equifax<version>.jar 文件添加到设置属性文件中的 system.properties.classpath 属性。例如：

system.properties.classpath=<path to jar>/com.parasoft.virtualize.listener.equifax-1.0.0.jar

使用说明

要设置 Equifax Message Listener，请在 Virtualize 服务器上添加 Parasoft Virtual Asset（PVA），然后双击 PVA，前往传输选项卡下的自定义子选项卡并配置监听器，如果安装了多个监听器，则必须先从实现下拉菜单中选择 com.parasoft.virtualize.listener.equifax.EquifaxMessageListener。

路径

选项说明
Equifax Input/Output Log File Path定义用于记录日志的文件路径。输入/输出日志文件包含 Equifax Message Listener 的传入和传出请求。它们有助于验证 Equifax 解析器是否已配置并正常运行。
Custom Equifax Request Properties File Path

定义请求属性文件的路径。属性文件包含传入请求中每个字段的位置和长度。它允许 Equifax Message Listener 将传入请求解析为 XML 格式用于关联。该文件的配置示例与此扩展一同放在 examples/ 目录中，名为 EquifaxRequestExample.properties。

注意：如果留空，将使用默认的 Equifax 请求格式，该格式包含在 examples/ 目录中，名为 equifax.xsd。

端口配置

选项说明
Equifax Incoming Message Port定义监听 Equifax 传入消息的端口。如果为空，监听器将不会启动。
Out Going Message Host定义发送 Equifax 响应时使用的主机。
Equifax Out Going Message Port定义发送 Equifax 响应时使用的端口。

请求属性

选项说明
ASCII Decimal
Representation For
Start of Response
Marker (Optional)		定义 ASCII 字符，用于指定响应消息的起始部分。
ASCII Decimal
Representation For
End of Response
Marker (Optional)		定义 ASCII 字符，用于指定响应消息的结束部分。

配置消息响应器

定义关联性

为 Equifax 指定关联性时需注意，Equifax 的请求消息会转换为 XML。使用请求的 XML 版本，可以构建 XPath 表达式来执行关联。下面是一个 XML 转换请求的示例：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<subjectFirstName>Frank</subjectFirstName>
<subjectLastName>Park</subjectLastName>
. .
</SOAP-ENV:Envelope>


如果要设置 XPath 表达式，以便对 subjectFirstName 值进行关联，可以使用：

/*[local-name(.)="Envelope"]/*[local-name(.)="subjectFirstName"]/text()

该元素的路径从根节点开始，一直到 subjectFirstName 元素。然后，此文本值将用于该关联。可通过事件详情视图查看 XML 转换请求，以便更好地构建 Xpaths；更多信息，请参阅 Parasoft Virtualize 用户指南> 使用 > 使用虚拟资产 > 部署虚拟资产 > 获得对服务器事件的可见性。

定义响应

有几种方法可以用所需的 Equifax 响应消息来配置消息响应器。为确保 Equifax 解析器能够成功将 XML 格式的响应转换为 Equifax 标准响应，您需要在 XML 响应示例文件中的所有段和字段中使用 XML 格式。

  • 如果您有现有的 Equifax 响应消息（从应用程序日志或其他来源获取），您可以利用 Virtualize 的 XML 转换功能。这样，您就可以将现有的 Equifax 响应复制到字面量视图中，然后通过切换到表单 XML 视图再切换回来，将其转换为 XML。这样就能通过数据源对所需的 Equifax 响应进行脚本化或参数化。
    • 请注意，该 Equifax 解析器实现使用了扩展框架中已弃用的 ICustomMessageConverter 接口，以实现 XML 转换。详情请参阅 Extensibility API 文档。
  • 如果您有多个现有的响应消息，并了解如何将它们与请求消息相关联，那么请使用响应器中的多响应选项，并将各响应消息粘贴到每个响应的消息选项卡区域中。需要设置每个响应的匹配标准（如定义关联性中所述）。此外，请参阅 Parasoft Virtualize > 引用 > 可用工具 > 消息响应器视图 > 多响应视图选项，了解有关输入多响应的通用信息。
  • 如果您没有现有的 Equifax 消息，或者您更倾向于从头开始建模（例如，应用程序尚不存在、尚未准备就绪，或者您无法获取样例），那么请使用 examples/listeners 文件夹中的 schema 来构建表单输入，然后配置字段。这种方法有助于对可用（有效）字段的认识，并能使用数组数据源等高级功能（请参阅 Parasoft Virtualize 用户指南 > Virtualize 基础 > 使用数据源值、变量和提取值的参数化工具）。



  • No labels

Need assistance? Visit our support page