章节目录：

概要

Asynchronous Socket Transport 基于 Netty 构建，提供多种模式。

安装

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

UI 安装

  1. 选择 Parasoft > 首选项并点击系统属性
  2. 点击添加 JARs 并选择 com.parasoft.soavirt.transport.asynchronous.socket-1.0.0.jar文件。一旦此 jar 文件添加到 SOAtest classpath 中，则将加载所有必需的依赖项。
  3. 重启 SOAtest。

命令行安装

将 com.parasoft.soavirt.transport.asynchronous.socket-1.0.0.jar 文件添加到设置属性文件中的 system.properties.classpath 属性。例如：

system.properties.classpath=<path to jar>/com.parasoft.soavirt.transport.asynchronous.socket-1.0.0.jar 

classpath 更改完成后，将加载所有必需的依赖项。

使用说明

Asynchronous Socket Transport 主要用于消息传送客户端工具。该传输在消息传送客户端的传输选项卡中配置。从传输下拉菜单中选择，然后配置可用选项。

配置

您可以配置以下选项。

Connection

Host

指定运行应用程序的主机。您可以指定一个固定值，也可以通过编程方式指定主机，方法是选择脚本化并点击编辑脚本访问脚本编辑器。更多信息，请参阅扩展和脚本基础。

默认为 localhost 

Port指定客户端发送信息的主机端口。您可以指定一个固定值，也可以通过编程方式指定端口号，方法是选择脚本化并点击编辑脚本访问脚本编辑器。更多信息，请参阅扩展和脚本基础。
Character Set

指定用于消息编码的字符集。您可以指定一个固定值，也可以通过编程方式指定字符集，方法是选择脚本化并点击编辑脚本访问脚本编辑器。更多信息，请参阅扩展和脚本基础。

默认为 UTF-8 

Read Mode

指定读取消息的模式。

  • 针对大小始终相同的定长消息指定 fixed。
  • 针对消息开头有 int（4 字节）长度前缀的消息指定 prefixed。
  • 针对有一系列字符串数字的消息指定 prefixed-string。
  • 针对以结束字符或 Unicode 序列分隔的消息指定 token。

您可以指定一个固定值，也可以通过编程方式指定读取模式，方法是选择脚本化并点击编辑脚本访问脚本编辑器。更多信息，请参阅扩展和脚本基础。

默认为 prefixed 

Fixed Length

在 Fixed Length [default: 1024] 字段中指定固定消息的大小.

例如，如果消息的大小始终为 4 字节，客户端可能会发送以下请求

[0, 0, 0, 0] 

例如，传输会发回大小相同的响应，例如：

[1, 1, 1, 1] 

来自客户端的每一条四字节消息都将被视为一条消息。

Token Delimited

Token Delimiter [default: byte "23", End-Of-Transmission-Block]

指定分隔消息的令牌。

默认为 byte "23", End-Of-Transmission-Block 

Token Type [string, hex, byte] [default: hex]

指定从令牌获取字节时使用的转换类型。

  • 指定 string，传输将使用 getBytes 和配置的字符集来转换为字节
  • 指定 hex，字符串将被解析为十六进制值序列。例如，0a 0d 将转换为字节 10 13 
  • 指定 byte，传输会将字符串解析为以空格分隔的十进制值的字节序列，如 10 13 

默认为 hex 

前缀可变长度（数字）

本节中的设置仅适用于读取模式设置为 prefixed 的情况。 

Length of the Length Field (1, 2, 3, 4, or 8) [default: 4, int]确定长度字段的长度。将读取所需的字节数并转换成数字，以确定消息的长度。默认读取 4 个字节并将其转换为整数。
Include Prefix in Length [true, false] [default: true] 

表示从前缀读取的长度是否也应包括前缀的长度。

例如，如果启用该选项，4 字节的消息将发送值为 8 的前缀。这是因为 int 前缀为 4 字节，并会添加到消息体长度中。 

默认为 true

前缀可变长度（字符串）

本节中的设置仅适用于读取模式设置为 prefixed-string 的情况。

String Prefix Length [the number of string digits to read in] [default: 4]指定消息长度前缀的大小。要读取的字节数根据转换成字节的数字位数计算。传输将 0 编码为字节，并乘以该字段提供的数字。
Include Prefix in Length [true, false] [default: true]

表示从前缀读取的长度是否也应包括前缀的长度。

默认为 true

SSL

将 SSL Enabled [ default:false ] 设置为 true，以便通过 SSL 进行监听。 

日志

指定 Log Level 字段。此设置为可选设置。

默认为 3 

连接管理

您可以启用保持连接或测试执行之后关闭连接选项。