51Testing软件测试论坛

标题: XLSUnit，面向数据库的单元测试工具 [打印本页]

作者: 海鸥一飞 时间: 2019-2-14 15:53
标题: XLSUnit，面向数据库的单元测试工具
XLSUnit

面向数据库应用的单元测试框架,使用excel,作为输入,以及输出比较,适合大量数据库操作. 如下情况可以使用xlsunit

必须使用Spring或者Spring Boot，因为会利用Spring单元测试事务回滚机制
面向数据库应用，特别是一个业务操作，有多个表的变化。

xlsunit支持Spring 4以上，SpringBoot1.5以上，支持Oracle，MySql，Postgres等数据库

为什么要使用XLSUnit

面向数据应用的单元测试中，最麻烦的地方有俩个

模拟单元测试前的数据
以及单元测试后，比较数据库的数据是否是期望的数据。

Spring的面向数据库单元测试技术技术会有如下问题

用SQL脚本模拟数据库的初始化数据，不够直观，修改起来也费劲
SQL脚本里的数据会在单元测试里使用，只能硬编码，缺少引用SQL脚本里的值办法
单元测试结束后需要比较是否与期望值一致，在Spring里，主要还是得靠写代码比较，会有大量的代码，容易出错，且不直观

DBUnit 是另外款单元测试工具一定程度上弥补了Spring面向数据库单元测试不足地方，通过XML来模拟和比较数据。但是模拟和比较数据都非常不直观，既然是面向数据库单元测试，为什么不能用xls初始化要测试前的数据，并且还用xls来比较单元测试后的期望数据呢？

XLSUnit正是基于这个想法，他可以用一个工作表容易的模拟数据表数据，在单元测试前，导入到一个空数据库，单元测试完毕，可以将数据库里的数据与另外一个工作表的数据做比较，如果只关心部分数据比较，只需要将这部分数据背景用红色填充，XLSUnit会只比较你关心的数据

安装

然后在项目里引用

<dependency>
<groupId>com.ibeetl</groupId>
<artifactId>xlsunit</artifactId>
<version>${version}</version>
<scope>test</scope>
</dependency>

复制代码

编写工作表excel

可以将测试数据写在excel里，或者通过数据库客户端工具粘贴到excel里完成数据的输入。

可以用拥有任意多个excel文件，每个文件概念上都可以包含一个初始化数据的多种测试场景，Excel文件有三部分组成

第一个工作表，这个工作表用来介绍当前excel文件所测试的业务，以及包含一个目录，快捷指向每个场景测试
第二个表示数据库初始化数据，可以包含多个表的初始化数据，也可以在初始化数据定义前，定义一些变量，这些变量可以用在初始化数据，JUnit代码里，以及随后的场景测试里
第三个表以后的每个工作表都是场景测试表，对应了单元测试完毕后，期望的数据库的样子。通常用红色背景标注在表的列名上，这样表示只让XLSUnit比较关心的列。同时，也能提醒阅读者，编写期望值

如下是一些例子

[attach]121853[/attach]

用来初始化数据和变量

[attach]121854[/attach]

场景1,在某个单元测试完毕，按照主键比较数据库的值，红色部分是需要比较的部分

[attach]121855[/attach]

XLSUnit会根据$id的值查询数据库，并与Excel里期望的数据做比较

场景二，比较一系列数据，比如主订单的所有子订单项

[attach]121856[/attach]

表名后下一个单元格是单表查询条件语句，XLSUnit会查询数据库数据，并与下面的excel数据逐一比较

XLSUnit 对excel里的数据的颜色不做限定，你可以使用任何颜色来分块，区分你的数据，除了列名上的红色，这个颜色用来表示期望比较的的列。这在XLSUnit是必须的。

编写变量

符号"##" +小写变量名定义了一组变量，这组变量可以在随后模拟数据库数据的时候使用，也可以在Java代码里复用（解决Spring @Sql的问题)，单元格的类型决定了数据类型。尤其要注意字符和数字的区别

##user

name

age

bir

xiandafu

$fn.date

初始化数据库数据

符号"##"+大写变量名定义了一个表格数据，其下一行是列名字，列名的后面所有行都是数据。

##SYS_USER

NAME

BIR

GENDER

$id

$user.name

$user.bir

分割符号

可以定义多个变量组，还有多个数据库表，用空行分开。

$符号和 # 符号说明

$符号有其特殊含义

用在列名上，表示是一个主键（尽管可以通过数据库MetaData自动判断，但为了好阅读，显示的标注一下还是很好的
用在单元格力，表示这是一个表达式，如 $fn.date, 表示一个当前时间，复杂的表达式要用${}.符合beetl表达式习惯
通常在数据库表里，$id 这样的变量如果不存在，表达的意思是需要回填。比如数据库自增主键，或者通过触发器，其他方式初始化的数据库数据。
${ } 对应于一个表达式，同Beetl，如${user.gender==1?"男" :"女"}
sql语句类似Beetlsql，可以使用变量，比如在批量比较里，使用##符号来引用变量

##SYS_USERNAME=#user.name# order by id ASC

NAME

BIR

GENDER

$id

xiandafu

$id2

joelli

编写场景测试

场景测试同输入是一样的规则，场景测试也可以再次定义一些场景测试的变量，这样在JUnit测试里，可以使用这些变量来测试。比如上图定义了一个变量test.password变量，JUnit可以取出这个变量，来更新用户密码，并做比较

场景里的每个表关心的数据可以用红色背景表示在列名上，这样XLSUnit仅仅比较红色即可，这有助于单元测试维护中几种注意力修改需要比较的关键数据

include

includeSheet指令可以用来导入其他excel文件初始化数据。参数分别是excel文件，以及工作表名称

##includeSheet /common.xlsx userdata

可以将某些测试需要公共初始化的数据放到一个excel文件里，这样维护方便。

fn系列函数

fn.seq: 一个自增长的Long数据，用来模拟数据库序列或者其他Number数据
fn.timestamp: 返回一个java的timestmap时间类型
fn.sqlDate,返回一个java的 sqlDate
fn.date 返回一个java.util.Date

可以自定义扩展，比如

VariableTable vars = new VariableTable();
vars.getFns().put("myTest",new Function(){....});

复制代码

apiVariableTable 变量表

xls里申明的变量或者操作数据库操作后的序列都放到此表里里，可以通过find方法，或者findSocpe获取变量

vars.find("abc.age") 返回值
vars.findInteger("abc.age") 返回整形
vars.findScope("abc") 返回age,date name
vars.find("$A$16"),返回输入表里的16行的A列数据。

XLSParser 用于解析输入。

计算后，与输出比较，包括

init 公共输入
prepare(sheetName, vars),场景的数据准备（这个不是必须调用的）
test(sheetName, vars);将数据库结果与sheetName 描述的数据做对比

例子1

public void testUser1() {
//执行某个测试场景的初始化工作，初始化user表
VariableTable vars = new VariableTable();
userParser.init(vars);
//开始测试，获取userId和password
userParser.prepare("场景1", vars);
Integer id = (Integer) vars.find("id");
String newPassword = vars.findString("test.password");
//调用业务代码，修改用户密码
userSerivce2.modifyUserInfo(id, newPassword);
//比较数据库里的数据跟场景1的数据是否一致
userParser.test("场景1", vars);
}

复制代码

如果比较出错，会有如下提示

java.lang.AssertionError: 比较数据出错，在第2行，位于XLSPoistion [file=测试一.xlsx, sheet=场景2, line =2],错误信息：CompareInfo [colName=PASSWORD, expected=d00$, real=d00$]
at org.junit.Assert.fail(Assert.java:88)
.....

复制代码

作者: Miss_love 时间: 2020-12-31 08:58
支持分享

欢迎光临 51Testing软件测试论坛 (http://bbs.51testing.com/)