扩展功能

自定义引擎各个阶段

可以在测试脚本中或者基类中重写 ActsTestBase 提供的 API。

1. 重写 prepare，execute，check，clear 等。可以通过在 super.prepare() 之前或者之后进行某些操作。
2. 重写 process 方法，在 super.process() 之前或之后进行操作。可将整个脚本重新编排，例如在现有的清理 -> 准备 -> 执行 -> 校验流程中增加一些个性化的步骤。
3. 重写 beforeActsTest、afterActsTest，可以在每一个用例运行前后做一些个性化的操作，如准备上下文、缓存刷新等。

参数化

在结果期望和数据库期望中可以使用 $变量名 来标识某个值是变量，测试脚本中可以把值设置进去； 支持范围：入参、返回结果、数据库表字段，支持类型：目前仅支持 String 的参数化。

使用方法：

（1）界面以 $ 开头定义变量

（2）代码中给变量赋值

@Override
public void beforeActsTest(ActsRuntimeContext actsRuntimeContext) {
    actsRuntimeContext.paramMap.put("roleId", "123");
    actsRuntimeContext.refreshDataParam();
}

在写 DB 数据期望的时候，也可以通过 = 符号来进行赋值，表示这个值来自于查询结果，后面的表就可以使用这个变量作为值。

假设接口会向 2 张表插入数据。

查询的时候要先通过接口返回的 A 表的 id_A 查到 value_A, 然后把 value_A 作为 B 表的查询条件，在插件上面可以这样写：

上面操作说明：

1. =param2 和 $param2 的操作，表示框架会先从 A 表查出 value_A 然后 select from B where id_B = value_A，进而得到全部 B 表的属性值；
2. $param1 表示可以在代码中对 id_A 赋值，代码形如：

actsRuntimeContext.paramMap.put("param1","123");

表示对变量 param1 赋值 123，上述代码可以写到脚本的 beforeActsTest 里面，这样在查询 A 表之前，框架就会将 123 赋值给 id_A。

参数组件化

目前仅支持 String 的组件化

如果属性是需要动态生成的字符串，例如某些 ID，可以通过 @ 符号来调用一个组件生成这个属性，组件要放在跟 test 同级的 component 包下，即：com.corpname.appname.acts.component (这里appname是系统名，corpname是公司名，如alipay)。

public class MyComponent {
    @TestComponent(id = "test")
    public String test(String param) {
        return param+"123";
    }
}

并通过 acts-config.properties 配置指明参数化组件使其生效，多个组件使用英文逗号 , 分隔，末尾注意不必要的空格。

param_components=IdGenerateComponent,NoGenerateComponent

如上图 alis_value 值为 @test?param=123 则在用例运行时会自动替换 alis_value 的取值。

组件的 ID 要保证唯一，否则默认调用第一个，如果声明了一个无参组件方法，调用方式为 @test 即可，同时支持组件化参数通过变量传入：@test?param=$id，实际执行时会替换 $id 的值为实际值。

脚本中也可以通过代码调用：

ActsComponentUtil.run("@test?param=123");

自定义组件多个参数的场景使用 & 分割参数，如 @test?param1=xxx&param2=yyy

DB 工具类

1. 指定数据源进行 DB 表访问

框架 ActsDBUtils 中提供了 DB 的指定数据源访问，用于个性化 DB 操作。例如某张表的某条纪录不是准备数据也不是校验数据，但是需要在运行后删掉或更新，此时就需要用到该工具操作 DB 数据。

使用前配置

使用指定数据源方式需要在 acts-config.properties 文件中首先将要指定的数据源进行配置，配置例子如下：

datasource_bean_name_exampleDataSource=com.alipay.example.dal;exampleDataSource

#整体配置的格式为：datasource_bean_name_xxx(数据源名字)=yyy(数据源所在 Module);xxx(数据源名字)

指定数据源方法

ActsDBUtils 工具类中指定数据源方法说明：

public static int getUpdateResultMap(String sql,String tableName,String dbConfigKey);

该方法用于指定数据源进行表的增、删和改的操作。sql 为标准 sql 语句，tableName 为逻辑表名，dbConfigKey 为该 表所在的逻辑数据源配置，与 acts-config.properties 配置的 xxx（数据源名字）相同。

public static List<Map<String, Object>> getQueryResultMap(String sql, String tableName,String dbConfigKey);

该方法用于指定数据源进行表的查询操作，以上两个方法都是原子化的 DB 表的操作，如果有其他的 DB 需求可以在上面进行 封装。

2. 不指定数据源进行 DB 表访问

该方式下 ACTS 框架默认根据表名搜索数据源，工具方法的使用步骤如下：

使用前配置

datasource_bundle_name=com.alipay.example.common.dal
ds_exampleDataSource=table1,tabal2

#整体配置的格式为
#datasource_bundle_name=数据源所在模块名
#ds_数据源名字=该数据源下的逻辑表名

不指定数据源方法

public static int getUpdateResultMap(String sql, String tableName);

该方法用于指定数据源进行表的增、删和改的操作。sql 为标准 sql 语句，tableName 为逻辑表名。

public static List<Map<String, Object>> getQueryResultMap(String sql, String tableName);

该方法用于指定数据源进行表的查询操作。

ACTS 各阶段注解扩展

被打上注解的自定义方法，可以在注解标示的不同阶段扩展个性化操作。

@BeforeClean
public void beforeClean(ActsRuntimeContext actsRuntimeContext) {
    System.out.println("数据清理前执行!!");
}

@AfterClean
public void afterClean(ActsRuntimeContext actsRuntimeContext) {
    System.out.println("数据清理后执行!!");
}

@BeforePrepare
public void beforePrepare(ActsRuntimeContext actsRuntimeContext) {
    System.out.println("数据准备前执行!!");
}

@AfterPrepare
public void afterPrepare(ActsRuntimeContext actsRuntimeContext) {
    System.out.println("数据准备后执行!!");
}

@BeforeCheck
public void beforeCheck(ActsRuntimeContext actsRuntimeContext) {
    System.out.println("数据check前执行!!");
}

@AfterCheck
public void afterCheck(ActsRuntimeContext actsRuntimeContext) {
    System.out.println("数据check之后执行!!");
}

使用中只需在想要执行的方法上打上如上注解即可，被注解方法的参数需要符合上述示例中的参数，框架会自动传递 ActsRuntimeContext 供被注解方法使用。