Parallel test threads(并行测试线程)¶
并行测试线程:
是与主序列并行运行的 test step 序列
也称为并发 test case
运行期间可通过交换消息彼此通信
Start and End(启动与结束)¶
Start(启动)
并行测试线程通过并行调用 Package(也称异步调用)启动。这一操作通过测试步骤 parallel package reference 完成。
与经典的 Package 引用类似,parallel package reference 可通过 Workspace 资源管理器的上下文菜单命令插入到 test case 中。
经典的 Package 调用也称为同步调用。
与同步调用一样,可以向被调用的 Package 传递参数。在调用方中,还可以定义目标变量,用于写入被调用 Package 的返回值。
Runtime and termination(运行与结束)
异步调用的 Package 会在以下情况下结束:
执行完由控制流确定的最后一个测试步骤后
执行测试步骤 return 后
发生测试中止时
除测试中止外,异步调用的 Package 不能被调用方强制终止;它们总是自行结束。不过,可以向其发送结束请求(参见 Exchange of messages between parallel test threads(并行测试线程之间的消息交换))。
注意:如果异步调用的 Package 又启动了并行子 Package,那么在执行完自身最后一个测试步骤后,除情况 c) 外,它会等待所有子 Package 结束后才返回。这意味着并行执行的子 Package 的生命周期不会长于其上级父 Package。这种行为称为 Package 与其子 Package 的隐式 join。
Synchronization and access to return values of an asynchronously called package(异步调用 Package 的同步与返回值访问)
Package 的返回值在其执行结束前不可用,只有结束后才会写入调用方的目标变量。因此,并行 Package 的调用方必须等待该 Package 结束后,才能访问其返回值。当调用方中的某个测试步骤读取这些目标变量之一时,或者在执行 stop trace 步骤时作为用于 Trace 分析的变量转储的一部分访问这些变量时,这一等待会自动发生。此时,读取访问会阻塞调用方,直到子 Package 结束(这也称为 Package 与其子 Package 的显式 join)。
只要子 Package 的异步执行尚未结束,对目标变量的写访问就会失败。同样,在第一次异步调用尚未结束之前,第二次异步调用也无法重新给该目标变量赋值。
Reporting(报告)¶
在 test report 中,异步 Package 调用的显示方式与同步调用基本相同,但调用的颜色标记不同。此外,由于并行执行的子 Package 与父 Package 在时间上重叠,因此它们不能以内联方式显示(即不能与父 Package 的测试步骤交错显示)。
Exchange of messages between parallel packages(并行 Package 之间的消息交换)¶
并行 Package 之间可以交换消息。消息可以是任意类型的 Python 对象(数字、字符串等)。发送消息需要所谓的 outbox,接收消息则需要 inbox。这些都是可以在 Package 变量容器中创建的特殊变量。与参数和返回值赋值类似,inbox 和 outbox 在测试步骤 parallel package reference 的对话框中组合成单向通信通道。消息只能通过测试步骤 Read from inbox 和 Write to outbox 发送与接收。
Outbox and test step “Write to outbox”(Outbox 与测试步骤“Write to outbox”)¶
Outbox 是两个并行 Package 之间单向通信通道中发送端的端点。与普通变量一样,可以通过 variable manager(变量管理器) 将 Outbox 添加到 Package 中。当尝试通过未与某个 Inbox 相连的 Outbox 发送消息时,选项 Discard messages if not connected 就会生效。如果该选项未激活(默认),会导致错误;如果激活,则待发送的消息会被直接丢弃,且不会出现错误消息。
需要特别注意的是,要在 variable manager(变量管理器) 中通过相应复选框将 Outbox 标记为 OUT 参数。该标记决定了可建立的连接方式(参见章节 Relays(Relays))。
消息通过测试步骤 Write to outbox 发送,该步骤位于测试步骤标签页的 Data operations 类别中。必须在字段 Outbox 中插入或选择相应的 Outbox。在字段 Message 中可以输入任意 Python 表达式,其求值结果会在执行时作为消息发送出去。
注意:消息只能通过测试步骤 Write to outbox 发送。不能对 Outbox 变量进行普通赋值。
Inbox and “Read from inbox”(Inbox 与“Read from inbox”)¶
Inbox 是两个并行 Package 之间单向通信通道中接收端的端点。它按 FIFO 原则工作:最先到达 Inbox 的消息会最先被取出。与普通变量一样,可以通过 variable manager(变量管理器) 将 Inbox 添加到 Package 中。Inbox 具有以下专用参数:
Size(大小):Inbox 在不溢出的情况下可缓冲的消息数量。
Standard time-out(标准超时):当调用空 Inbox 时,等待传入消息的标准时间,单位为毫秒。如果在该时间内没有消息到达,调用将返回 ~not present~。该标准超时可在测试步骤 Read from inbox 中覆盖。
Inbox 的两个选项决定了其在溢出时的行为。当消息数量超过箱体大小时,Inbox 会立即溢出。如果激活选项 Delete the oldest message(s) in case of an overflow,则会恰好删除最旧的若干条消息,使 Inbox 在新消息到达时重新回到未溢出状态。如果同时激活 Report panel size overflows,则在丢弃消息前会向控制台发送警告。若仅激活 Report panel size overflows,也会发出警告,但消息不会丢失,因为 Inbox 的大小会超过设定上限继续增长,以便仍能缓冲新到达的消息。如果这两个选项都未激活,消息投递将以硬错误失败。
提示:将 Value 设为 1,并启用选项 Delete the oldest message(s) in case of an overflow,就可以生成一种“实时返回值”,调用 Package 可以立即访问,并且会由并行 Package 持续更新。
还需要特别注意的是,要在 variable manager(变量管理器) 中通过相应复选框将 Inbox 标记为 IN 参数。该标记决定了可建立的连接方式(参见章节 Relays(relays))。
消息通过测试步骤 Read from inbox 从 Inbox 中取出,该步骤位于测试步骤标签页的 Data operations 类别中。该测试步骤有两种模式:Collect 和 Check。在 Collect 模式下,会从 Inbox 中取出最旧的消息;在 Check 模式下,消息保留在箱体中。Check 模式通过选项 Keep message in inbox 激活(警告:如果旧消息一直不被取出,就无法访问较新的消息,并且 Inbox 可能会溢出)。
除输入和/或选择 Inbox 外,该测试步骤还允许定义当 Inbox 为空时等待传入消息的超时时间(毫秒)。超时后,调用将返回 ~not present~。可用的超时选项包括 Default time-out(按 Inbox 变量中的参数设置)、Unlimited time-out,以及在 Read from inbox 中为相应测试步骤单独设置的特殊超时。
该测试步骤还提供了对已检查消息进行求值和保存的设置。这些设置与读取类测试步骤或 calculation test step(计算测试步骤) 的设置类似。
注意:消息只能通过测试步骤 Read from inbox 获取。对 Inbox 变量进行普通访问(例如使用 Python 表达式)会导致错误。
Linking inboxes and outboxes(Inbox 与 Outbox 的连接)¶
为确保通过 Outbox 发送的消息能传递到 Inbox,必须在发送前先将 Outbox 连接到 Inbox。这一操作在测试步骤 Parallel package reference 的编辑对话框中的 Inboxes and outboxes 标签页上完成。左侧列显示被调用 Package 的 Inbox 和 Outbox,右侧列则可通过下拉菜单调出调用方的 Inbox 和 Outbox 并进行分配。
要确保被调用 Package 的 Inbox 显示在左侧,必须激活 IN 参数选项。对于被调用 Package 的 Outbox 也是类似条件;若希望它们显示在左侧,就必须激活 OUT 参数选项。
分配给调用方的 Inbox 和 Outbox 必须遵循以下规则:只有在未激活 IN 和 OUT 参数选项时,这些箱体才会出现在选择列表中。如果之后再启用或禁用 IN/OUT 标记而破坏该规则,就会产生运行时错误。
之所以有这条严格规则,是因为 IN/OUT 参数标记会将相应的 Inbox 和 Outbox 声明为对应 Package 的接口,而它们之间的连接应由调用方完成。若尝试由被调用 Package 建立连接,则必然会出错,因为此时这些箱体已经在使用中。
注意:一个 Outbox 始终只能连接一个 Inbox,反之亦然(这一点由参数化保证)。在后续异步 Package 调用中,可以重复使用 Outbox 和 Inbox。不过,在新的调用中将 Inbox/Outbox 连接到另一个并行 Package 之前,当前并行 Package 必须先结束,否则会出现运行时错误。
Relays - Exchange of messages between parallel subpackages(Relays - 并行子 Package 之间的消息交换)¶
到目前为止,我们只讨论了 Inbox 和 Outbox 之间的直接连接。但这种方式只能建立调用方与被调用 Package 之间的通信通道。更复杂的通信结构需要使用 Relay。Relay 是用于连接的中间件,两端分别为 IN 端和 OUT 端。IN 端可以连接到 Outbox,OUT 端可以连接到 Inbox;此外,这两端也可以继续连接到其他 Relay。这样就会形成如下几种可能的连接结构:
outbox–>IN-relay-OUT–>inbox,
outbox–>IN-relay1-OUT–>IN-relay2-OUT–>inbox
etc.
例如,如果主 Package H 的两个并行子 Package S1 和 S2 之间要交换消息,那么主 Package 需要一个 Relay R(H),子 Package S1 需要一个 Inbox In(S1),子 Package S2 需要一个 Outbox Out(S2)。调用 S1 时,会将其 Inbox In(S1) 连接到 Relay R(H);随后调用 S2 时,也会将其 Outbox Out(S2) 连接到 Relay R(H)。这样就形成了 Out(S2) –> R(H) –> In(S1) 的结构,从而使子 Package S2 能向子 Package S1 发送消息。
与 Inbox 和 Outbox 一样,Relay 也是可添加到变量容器中的特殊变量。它专门用于转发消息,因此既不能读取,也不能写入。Relay 与 Inbox 一样具有消息缓冲区。当 Relay 已连接到某个 Outbox,但尚未连接到 Inbox,而发送方已经在发送消息时,该缓冲区就用于临时存储这些消息。消息缓冲区大小及其在溢出时的行为,都可以在变量设置对话框中配置。如果停用选项 Error at overflow,则只会在控制台显示警告,而不会触发硬错误。在这种情况下,不会丢失消息,因为缓冲区会动态扩容。
与 Inbox 和 Outbox 一样,Relay 是否被标记为 IN/OUT 参数同样至关重要。对于异步调用的 Package,其 Relay 会根据标记显示在 Inbox 或 Outbox 区域左侧,作为 IN 或 OUT 参数。未标记的 Relay 不能由调用方建立连接,因此不会显示出来。
对调用方 Package 的 Relay,在右侧列选择列表中的登记也有限制。如果某个 Relay 被标记为 OUT 参数,则其 OUT 端不能由该 Package 自身连接,因此不会出现在 Inbox 区域的选择列表中。标记为 IN 参数时也是类似情况:该 Relay 会从 Outbox 区域的选择列表中移除。如果某个 Relay 同时标记为 IN 和 OUT 参数,它就不会出现在任何选择列表中。
Event-oriented message treatment (REACT test step)(面向事件的消息处理)¶
在包含多个并行测试线程的 test case 中,常见需求是同时、反复等待不同事件发生(例如来自不同并行 Package 的消息到达)。此外,还需要根据发生的事件类型执行特定测试步骤。这正是 REACT 测试步骤的用途。它使 test case 设计者不必在循环中按顺序轮询所有目标事件源,并且可以非常紧凑地组织每个事件发生时要执行的测试步骤。REACT 测试步骤位于测试步骤标签页的 Control flow 类别中。
Edit 对话框显示的是 REACT 测试步骤要等待的事件和/或条件列表。初始时该列表为空。可以通过按钮 add 定义新事件。用户可以等待以下情况:
Inbox 中有消息到达(Inbox 条件),
异步调用的 Package 返回值到达(future 条件),或
超时时间到期(after 条件)。
根据所选条件,第二列中必须指定以下内容之一:
相关 Inbox 的名称,
Package 返回值目标变量的名称,
或用于超时的 Python 表达式。
事件源的检查顺序可以通过 up/down 按钮确定。已发生的事件会按顺序处理,也就是说,在处理一个事件期间,其他事件不会同时处理;不过这些事件会被保存,留待后续处理。
对于 REACT 对话框中定义的每个事件,test case 中都会在 REACT 测试步骤下方生成一个带相应标记的容器测试步骤。发生对应事件时要执行的其他测试步骤,都可以插入到该容器测试步骤中。
使用 BREAK test step(BREAK 测试步骤) 结束事件处理并退出 REACT 测试步骤。该选项可以包含在事件处理测试线程中。如果没有 BREAK(或 RETURN),REACT 测试步骤以及外围 Package 将永远不会结束。BREAK 测试步骤同样位于测试步骤标签页的 Control flow 类别中。