Android 单元测试第三篇（异常、超时测试）

除了常规的给定输入数据、判断输出数据之外，还有两个场景我们也会经常遇到，那就是异常和超时

一、准备一个被测试类

public class Sample3 {

    public void nullMsgInvoke(String content) {
        int length = content.length();
        System.out.print(length);
    }

    public void nullFileOpen() throws IOException{
        FileReader reader = new FileReader("a.txt");
    }

    public void complexOpr() throws InterruptedException {
        Thread.sleep(400);
    }
}

二、生成对应的测试类

public class Sample3Test {

    private Sample3 _sample3;

    @Before
    public void setUp() throws Exception {
        _sample3 = new Sample3();
    }

    @Test(expected = NullPointerException.class)
    public void nullMsgInvoke() throws Exception {
        _sample3.nullMsgInvoke(null);
    }

    @Test(timeout = 1000) //单个测试方法超时测试，会被全局覆盖
    public void complexOpr() throws Exception {
        _sample3.complexOpr();
    }
}

三、通过@Test 的参数实现测试

通过查看@Test 标注的定义，我们可以看到它可以接收两个参数

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Test {
    //期望的异常类
    Class expected() default None.class;
    //超时时间
    long timeout() default 0L;
}

所以我们可以给欲测试的方法添加对应的参数，如下

@Test(expected = NullPointerException.class) //这样当抛出的异常是这个异常类型或其子类，则测试通过，否则测试失败
public void nullMsgInvoke() throws Exception {
    _sample3.nullMsgInvoke(null);
}

@Test(timeout = 1000)  //超时时间，单位为毫秒，表示设定时间内方法没有执行完则表示测试不通过
public void complexOpr() throws Exception {
    _sample3.complexOpr();
}

四、通过 TestRule 手段

上面通过@Test 的参数的手段有个问题，那就是抛出的异常匹配规则过于单一，如果遇到一个方法内可能抛出多种异常，那么这种方法就行了。我们需要一种更加灵活的方式，最好是可以用参数化测试的手段，给不同的测试用例指定不同的异常。这个时候就轮到ExpectedException登场了。
实现步骤如下

1. 为测试类添加如下字段

@Rule
public ExpectedException _expectedEx = ExpectedException.none();

2. 为测试方法添加异常类设置，还可以通过设置 expectMessage(String|Matcher)更进一步匹配异常信息

@Test
public void nullFileOpen() throws Exception {
    _expectedEx.expect(FileNotFoundException.class);
    _expectedEx.expectMessage("No such file or directory");
    _sample4.nullFileOpen();
}

如果要实现不同测试用例抛出不同的异常，那么只需要将上述测试方法中写死的异常类型提取为类字段，通过参数化测试的手段构造多组测试用例，每组测试用例包含特定的异常类型即可，还可以添加详细的异常信息匹配哦。

注意通过 TestRule 设置异常信息和通过 @Test 的方式不能同时作用于一个测试方法，否则会抛出异常。

至于超时时间，如果我们需要对所有的测试方法都进行同一时间规格的限制，那么我们没必要在每个测试方法的@Test 添加超时时间限制，而是可以通过 TestRule 的方式统一设置。
为测试类添加如下字段：

@Rule
public Timeout _timeOut = new Timeout(timeOut, TimeUnit.MILLISECONDS); //全局超时限制

同理，如果不同测试用例运行的超时时间不一样，那么也可以提取设置时间为字段，通过参数化测试的方式提供多组测试用例。

注意，如果通过使用了 TestRule 的方式和@Test 中设置超时的方法，那么后者会被前者覆盖，但是不会抛出异常。
所以并没办法通过这样的手段去用 TestRule实现10个方法超时时间为1000毫秒， 用 @Test实现1个方法超时时间为2000毫秒的方式，当然也可能是我姿势有误，欢迎知道的小伙伴指正。