探索JUnit4扩展：假设机制（Assumption）

一.假设机制（Assumption）概述
        理想情况下，写测试用例的开发人员可以明确的知道所有导致他们所写的测试用例不通过的地方，但是有的时候，这些导致测试用例不通过的地方并不是很容易的被发现，可能隐藏得很深，从而导致开发人员在写测试用例时很难预测到这些因素，而且往往这些因素并不是开发人员当初设计测试用例时真正目的，他们的测试点是希望测试出被测代码中别的出错地方。

        比如，一个测试用例运行的 locale（如：Locale.US）与之前开发人员设计该测试用例时所设想的不同（如：Locale.UK），这样会导致测试不通过，但是这可能并不是开发人员之前设计测试用例时所设想的测试出来的有用的失败结果（测试点并不是此，比如测试的真正目的是想判断函数的返回值是否为 true，返回 false 则测试失败），这时开发人员可以通过编写一些额外的代码来消除这些影响（比如将 locale 作为参数传入到测试用例中，每次运行测试用例时，明确指定 locale），但是花费时间和精力来编写这些不是测试用例根本目的的额外代码其实是种浪费，这时就可以使用 Assumption 假设机制来轻松达到额外代码的目的。编写该测试用例时，首先假设 locale 必须是 Locale.UK，如果运行时 locale 是 Locale.UK，则继续执行该测试用例函数，如果是其它的 locale，则跳过该测试用例函数，执行该测试用例函数以外的代码，这样就不会因为 locale 的问题导致测试出错。

        JUnit 4.4 结合 Hamcrest 库提供了assumeThat 语句，开发人员可以使用其配合匹配符 Matcher 设计所有的假设条件（语法和 assertThat 一样）。同样为了方便使用，JUnit 4.4 还专门提供了assumeTrue，assumeNotNull 和assumeNoException 语句。

 

二.假设机制（Assumption）的优点
        优点1：通过对 runtime 变量进行取值假设，从而不会因为一个测试用例的不通过而导致整个测试失败而中断（the test passes），使得测试更加连贯。

        开发人员编写单元测试时，经常会在一个测试中包含若干个测试用例函数，这时若是遇到某个测试用例函数不通过，整个单元测试就会终止。这将导致测试不连贯，因为开发人员往往希望一次能运行多个测试用例函数，不通过的测试用例函数不要影响到剩下的测试用例函数的运行，否则会给 debug 调试带来很大的难度。

        开发人员编写单元测试时，有时是预测不了传入到单元测试方法中的变量值的，而且这些值有时并不是开发人员所期望的，因为他们会导致测试用例不通过并中断整个测试，所以开发人员需要跳过这些导致测试用例函数不通过的异常情况。

如下所示假设机制优点1的实例：

//@Test 注释表明接下来的函数是 JUnit4 及其以后版本的测试用例函数
@Test
public void testAssumptions() {
    //假设进入testAssumptions时，变量i的值为10，如果该假设不满足，程序不会执行assumeThat后面的语句
    assumeThat( i, is(10) );
    //如果之前的假设成立，会打印"assumption is true!"到控制台，否则直接调出，执行下一个测试用例函数
    System.out.println( "assumption is true!" ); 
}

        优点2：利用假设可以控制某个测试用例的运行时间，让其在自己期望的时候运行（run at a given time）。

如下所示假设机制优点2的实例：

@Test
//测试用例函数veryLongTest()执行需要很长时间，所以开发人员不是每次都想运行它，可以通过判断是否定义了
//”DEV”环境变量来选择性地执行该测试用例
public void veryLongTest() throws Exception {
    //假设环境变量”DEV”为空，即如果之前通过System.setProperty定义过”DEV”环境变量（不为空），则自动跳过
    //veryLongTest中假设后剩下的语句，去执行下一个JUnit测试用例，否则执行假设后接下来的语句
    assumeThat( System.getProperty( "DEV" ), nullValue() );
    
    System.out.println("running a long test");
    Thread.sleep( 90 * 1000 );
}

 

三.如何使用 Assumption 假设机制
        开发人员可以使用 assumeThat 并配合 hamcrest 的匹配符 Matcher，对即将被传入到单元测试用例函数中的 runtime 变量值做精确的假设，如果假设不正确（即当前 runtime 变量的取值不满足所假设的条件），则不会将该变量传给该测试用例中假设后面的语句，即程序会从该 assumeThat 所在的 @Test 测试函数中直接自动跳出（test automatically quietly passes，values that violate assumptions are quietly ignored），去执行下一个 @Test 函数，使得本来会中断的测试现在不会中断。

        使用假设机制必须得注意以下几点：

        a.由于 JUnit 4.4 引用了 Hamcrest 匹配符库，所以使用 assumeThat 就可以编写所有的假设语句。但是为了方便使用，JUnit 4.4 除 assumeThat 之外，还提供了 assumeTrue，assumeNotNull 和 assumeNoException 语句。

        b.要使用 assume* 假设语句，必须得 import static org.junit.Assume.*;。

        c.如果引用了第三方 hamcrest 的匹配符库，必须得 import static org.hamcrest.Matchers.*;，如果引用 JUnit 4.4 自带的匹配符库，需要 import static org.hamcrest.CoreMatchers.*;。

        如下是假设机制的使用举例：
实例1：

@Test 
public void filenameIncludesString() {
    //如果文件分隔符不是’/’(forward slash)，则不执行assertThat断言测试，直接跳过该测试用例函数
    assumeThat(File.separatorChar, is('/'));
    //判断文件名fileName是否含有字符串"developerWorks"
    assertThat( fileName, containsString( "developerWorks" ) );
}

实例2：

@Test 
public void filenameIncludesString() {
    //bugFixed不是JUnit4.4的函数，是开发人员自己工程中定义的函数，表示判断指定的defect是否
    //被修正了，如果被修正，则返回true，否则返回false。这里假设缺陷13356被修正后才进行余下单元测试
    assumeTrue( bugFixed("13356") ); 
    //判断文件名fileName是否含有字符串"developerWorks"
    assertThat( fileName, containsString( "developerWorks" ) );
}

 

文章来源：http://www.ibm.com/developerworks/cn/java/j-lo-junit44/