测试执行服务接口和类

使用测试执行服务接口和类可定制如何运行测试。这些接口和类位于 com.ibm.rational.test.lt.kernel 包中。每个接口和类都在本主题中进行了简短描述,并在 Javadoc 信息中进行了详细描述。

定制代码不会在移动设备上运行,而是从 测试工作台 中提供的已生成的 Java 代码运行。 因此,如果从移动设备启动测试运行,并且测试脚本包含定制代码,那么将不会执行定制代码。要执行移动测试脚本中提供的定制代码,必须从 测试工作台 启动运行。 如果要在两个移动指令之间集成定制代码,必须分割测试脚本。请参阅分割测试。

测试执行服务接口和类的 Javadoc 位于此参考主题中。
测试执行服务接口

接口 描述
ICustomCode2 为测试执行服务定义定制 Java™ 代码。使用该接口可创建所有定制代码。
ITestExecutionServices 提供用于将定制测试执行功能添加到测试的信息。替换 IKLog 接口。 IKLog 中提供的所有方法都包含在 ITestExecutionServices 中,以及几个新公开的对象和接口。该接口是执行服务的主接口。ITestExecutionServices 包含了以下接口:IDataArea、IARM、ILoopControl、IPDLogManager、IStatisticsManager、ITestLogManager、ITime 和 ITransaction。
IDataArea 定义用于存储和访问数据区域中的对象的方法。数据区域是用于保存对象的容器。数据区域的元素类似于程序变量,其范围限定于拥有这些元素的容器。要使用特定于协议的对象,应使用在特定于协议的数据区域中存储且由该协议提供的对象。
IARM 提供有关定义 ARM(应用程序响应测量)规范的信息。如果正在对您的虚拟用户进行采样以用于 ARM 处理,请使用该接口。
ILoopControl 提供对测试或调度中的循环的控制。 例如,可使用该接口在测试中的特定点打破循环。受影响的循环是测试或调度中找到的最近的包含循环。
IPDLogManager 提供日志记录信息,例如问题严重性、位置级别和错误消息。
IStatisticsManager 提供对 ICustomCode2 接口(用于定义定制代码)中的性能计数器的访问权。性能计数器存储在计数器的层次结构中。层次结构中的所有计数器值将定期报告给测试工作台并收集到测试运行结果中,其中这些值可供在报告和图形中使用。层次结构中的每个计数器都有一个类型(在类 StatType 中定义)。 对计数器可用的操作取决于该计数器的类型。
ITestLogManager 将消息和验证点记录到测试日志中。该接口用于处理在期望数据中出现的错误情况、异常或其他需要报告给用户的简要情况,或者用于比较或验证并将其结果报告写入测试日志。ITestLogManager 还可以在完成测试后传达参考或状态消息。
ITime 定义基本时间服务,例如当前系统时间(以毫秒为单位,已经过调整,以便所有系统都与调度控制器同步)、测试开始的时间,以及从测试开始以来耗用的时间。
ITransaction 提供对事务的支持。将针对每个虚拟用户维护指定事务的集合。在可使用定制代码的任何位置都可以启动和停止定制代码中创建的事务。这些事务可跨多个测试。性能计数器保留用于定制代码事务,并出现在报告中。 ITransaction 使用方法的示例如下:为一个虚拟用户(而不是另一个虚拟用户)创建事务,以帮助验证测试中的响应。
IEngineInfo 提供有关测试执行引擎的信息;例如,该引擎中运行的虚拟用户数、已完成的虚拟用户数、部署了测试资产的本地目录,以及运行引擎的计算机的主机名。
ITestInfo 提供有关正在运行的测试的信息;例如,测试名称以及有关该测试的当前问题确定日志级别的信息。
IVirtualUserInfo 提供有关虚拟用户的信息;例如,虚拟用户的名称、问题确定日志级别、TestLog 级别、全局唯一标识和用户组名。
IScalar 提供简单整数性能计数器的方法。它用于 SCALAR 和 STATIC 类型的计数器。 使用该接口可对计数器进行递减和递增。
IStat 定义观察性能计数器。 它定义用于向类型为 RATE、AVERAGE 和 RANGE 的性能计数器提交数据点的方法。
IStatistics 检索与当前统计信息处理器关联的性能计数器树。停止性能计数器的交付。更改统计信息交付线程的优先级。
IStatTree 提供相应方法来检索子计数器、创建用于定义计数器的 XML 片段,以及设置计数器的描述字段。
IText 包含基于文本的性能计数器。不符合任何其他计数器类型的性能计数器可创建为类型 TEXT。没有为 TEXT 计数器分配定义,但是这些计数器会收集到测试结果中。
测试执行服务类

类 描述
DataAreaLockException 只要尝试修改已锁定的 DataArea 键,就将抛出异常。
OutOfScopeException 指示 ITestExecutionServices 创建的对象已在其期望范围之外引用。
TransactionException 误用事务时抛出异常。 以下情况将导致 TransactionException 异常:尝试启动已启动的事务,尝试停止尚未启动的事务,以及获取尚未启动的事务的开始时间或耗用时间。 针对已异常中止的事务的任何操作(除了 abort() 之外)都将抛出 TransactionException 异常。
StatType 提供有效性能计数器类型的列表。性能计数器类型包括:AVERAGE、iAVERAGE、iRANGE、iRATE、iSCALAR、iSTATIC、iSTRUCTURE、iTEXT、RANGE、RATE、SCALAR、STATIC、STRUCTURE 和 TEXT。

反馈