基于springtestdbunit的Spring单元测试

在基于Spring开发测试的过程中,如果需要对DAO层进行单元测试,可以利用DBUnit来操作数据库,或者基于数据库数据进行测试验证。在Github上开源了一个DBUnit与Spring框架集成的项目,
https://github.com/springtestdbunit
为我们提供了基于注解的DBUnit操作。

springdbunit配置

为了能在Spring的测试中使用DBUnit,需要在测试用例类上做如下的注解,主要是增加 Spring TestExecutionListener.

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = SpringDbunitApplicationTest.class)
@TestExecutionListeners({DependencyInjectionTestExecutionListener.class,
    DirtiesContextTestExecutionListener.class,
    TransactionalTestExecutionListener.class, 
    DbUnitTestExecutionListener.class})
@DatabaseSetups({
    @DatabaseSetup(value = "classpath:company-dataset.xml", type = DatabaseOperation.CLEAN_INSERT),
    @DatabaseSetup(value = "classpath:employee-dataset.xml", type = DatabaseOperation.CLEAN_INSERT)
})
public class SpringDbunitApplicationTests {

Setup and TearDown

在DAO的单元测试中,通常的测试场景是,假定数据库处在某个指定状态(初始化),然后对数据库进行CRUD,并验证操作结果。在完成上述操作后,通过回滚来恢复数据库到操作前状态(重置)。springdbunit提供了两个非常有用的注解 @DatabaseSetup 和 @DatabaseTearDown 来进行数据库的数据初始化和重置。

初始化setup

假设使用 sampleDataSet.xml 作为数据文件,这个文件通常在测试类的同一个包下。
@DatabaseSetup("sampleDataSet.xml")

接下来,我们来看下这个注解的定义。

/**
 * Test annotation which indicates how to put a database into a know state before tests are run. This annotation can be
 * placed on a class or on methods. When placed on a class the setup is applied before each test methods is executed.
 *
 * @see DatabaseTearDown
 * @see ExpectedDatabase
 * @see DbUnitConfiguration
 * @see DbUnitTestExecutionListener
 *
 * @author Phillip Webb
 */
@Documented
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.TYPE, ElementType.METHOD })
@Repeatable(DatabaseSetups.class)
public @interface DatabaseSetup {
    /**
     * Determines the type of {@link DatabaseOperation operation} that will be used to reset the database.
     * @return The type of operation used to reset the database
     */
    DatabaseOperation type() default DatabaseOperation.CLEAN_INSERT;
//略
}

从中我们可以了解到

  1. 这个DatabaseSetup 既可以注释在类上,又可以注释在方法上,与Junit的@BeforeClass和@Before起到类似的作用。
  2. 默认情况下,初始化的时候会进行 CLEAN_INSERT 操作,也就是说 DataSet.xml 中的数据在导入时,会先将所涉及的表的数据清空。
  3. DatabaseSetup可以有多个注解,并由@DatabaseSetups进行组织。具体请见本文的前述案例。

重置 teardown

@DatabaseTearDown 注解用来在测试完成之后重置数据库的上下文。与 @DatabaseSetup 类似,可以使用在类上或方法上,也可以进行嵌套,并指明相应的DBUnit数据操作模式。

断言 @ExpectedDatabase

软件测试的另外一个重要的问题就是断言。springtestdbunit同样提供了一个基于注释的断言。如下面的用例,

    @Test
    @DatabaseSetup("sampleData.xml")
    @ExpectedDatabase("expectedData.xml")
    public void testRemove() throws Exception {
        this.personService.remove(1);
    }

顾名思义,就是在测试用例执行完成后,断言数据库中相应的表中的数据与"expectedData.xml"中的一致。该断言与之前的两个有着相同的属性,可以在类或者方法上注解,还可以使用多个@ExpectedDatabase来组成复杂的断言。
在实际的测试中,可能还需要根据需要进行对断言的方式进行限定。
一般来说,数据库表的断言方式有:
1)包含,即预期结果是整个数据表的一部分,特别是新增时。
2)部分相同,即只比较预期和实际数据库表的部分列。某些如时间戳、ID等数据可能无法比较或者无需比较。
3) 数据相同,但数据的行排序不同。
4)数据完全相同。
以下是一个自定义的断言形式,
@ExpectedDatabase(assertionMode=DatabaseAssertionMode.NON_STRICT,value="expectedData.xml")

根据该工具的源码,可以了解到,

DatabaseAssertionMode.DEFAULT 

整库比较,类似前述比较场景中的4)

DatabaseAssertionMode.NON_STRICT  

类似前述比较场景中的2

     DatabaseAssertionMode.NON_STRICT_UNORDERED 

类似前述比较场景中的2+3
如果是场景1)的话,一般在@DatabaseSetup 会将数据库表清空,这样就可以转换成2/3/4的模式进行比较。另外一种方式是通过DAO 获取数据,在测试用例内部进行断言。

TODO:

@Transactional
@DataLoader

写在最后

本文案例来自:
https://github.com/hainet/spring-test-dbunit-sample

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,128评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,316评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,737评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,283评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,384评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,458评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,467评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,251评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,688评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,980评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,155评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,818评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,492评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,142评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,382评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,020评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,044评论 2 352

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,644评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,796评论 6 342
  • Spring Web MVC Spring Web MVC 是包含在 Spring 框架中的 Web 框架,建立于...
    Hsinwong阅读 22,372评论 1 92
  • 当你看到这句话的时候,也许你很义愤填膺,也许准备了很多词汇来喷我, 如同我10年前的情绪。 那时的我是天涯的常客,...
    挪威阳光阅读 1,851评论 3 6
  • 假 春动了谁的发 随风发芽 夏雨灌溉长大 惊了雷有什么可怕 秋染成霜白的她 收获的何止满皱纹的脸颊 冬雪互映着的发...
    姬二水阅读 196评论 1 2