Android单元测试（四）：JUnit介绍

JUnit是java开发人员的一个主要的测试工具，做Android开发同样是离不开java的，所以Android单元测试依然可以基于JUnit来写测试。但是JUnit只能运行在纯java环境上，前面我们介绍过MVP架构下，可以将View层隔离开来，单独针对Presenter层、Model层来测试。

4.1 JUnit4配置

在build.gradle中加入依赖配置，采用JUnit4框架。

testCompile 'junit:junit:4.12'

JUnit文件夹在工程中的位置，工程创建后，在app -> src目录下，会有3个文件夹：androidTest, main, test。test文件目录就是JUnit单元测试默认的目录。



创建工程时，默认会生成一个单元测试例子ExampleUnitTest.java，且看看一个最简单的Junit单元测试是怎么写的：

public class ExampleUnitTest {
    @Test
    public void addition_isCorrect() throws Exception {
        assertEquals(4, 2 + 2);
    }
}

里面只有一个测试方法，方法上有一个@Test注解，选中方法名，右键选中“Run 'addition_isCorrect()'”执行单元测试，会出现执行结果：



“OK”表示单元测试运行通过，到这里我们已经在Android上执行了一次单元测试。

4.2 JUnit4基础方法注解

JUnit3是通过对测试类和测试方法的命名来确定是否是测试，如测试方法必须以test开头。而在JUnit4中，是通过注解来确定的。

  • @Test
    说明该方法是测试方法。测试方法必须是public void，可以抛出异常。
  • @Before
    它会在每个测试方法执行前都调用一次。
  • @After
    与@Before对应，它会在每个测试方法执行完后都调用一次。
  • @BeforeClass
    它会在所有的测试方法执行之前调用一次。与@Before的差别是：@Before注解的方法在每个方法执行前都会调用一次，有多少个测试方法就会掉用多少次；而@BeforeClass注解的方法只会执行一次，在所有的测试方法执行前调用一次。注意该注解的测试方法必须是public static void修饰的。
  • @AfterClass
    与@BeforeClass对应，它会在所有的测试方法执行完成后调用一次。注意该注解的测试方法必须是public static void修饰的。
  • @Ignore
    忽略该测试方法，有时我们不想运行某个测试方法时，可以加上该注解。
    以上这些注解都是针对测试方法而言的，并且是一些常用的注解，我们会频繁用到。我们写个测试类来运行一下，看看具体的执行顺序，代码如下：
public class TestJUnitLifeCycle {

    @BeforeClass
    public static void init() {
        System.out.println("------init()------");
    }

    @Before
    public void setUp() {
        System.out.println("------setUp()------");
    }

    @After
    public void tearDown() {
        System.out.println("------tearDown()------");
    }

    @AfterClass
    public static void finish() {
        System.out.println("------finish()------");
    }

    @Test
    public void test1() {
        System.out.println("------test1()------");
    }

    @Test
    public void test2() {
        System.out.println("------test2()------");
    }
}

执行后打印结果如下：

------init()------
------setUp()------
------test1()------
------tearDown()------
------setUp()------
------test2()------
------tearDown()------
------finish()------

4.3 JUnit4常用断言

JUnit提供了一些辅助函数，他们用来帮助我们确定被测试的方法是否按照预期正常执行，这些辅助函数我们称之为断言(Assertion)。JUnit4所有的断言都在org.junit.Assert类中，Assert类包含了一组静态的测试方法，用于验证期望值expected与实际值actual之间的逻辑关系是否正确，如果不符合我们的预期则表示测试未通过。

  • assertEquals([message], expected, actual)
    验证期望值与实际值是否相等，如果相等则表示测试通过，不相等则表示测试未通过，并抛出异常AssertionError。message表示自定义错误信息，为可选参数，以下均雷同。
  • assertNotEquals([message], unexpected, actual)
    验证期望值与实际值不相等。
  • assertArrayEquals([message], expecteds, actuals)
    验证两个数组是否相同
  • assertSame([message], expected, actual)
    断言两个引用指向同一个对象。
  • assertNotSame([message], expected, actual)
    断言两个引用指向不同的对象。
  • assertNull([message], object)
    断言某个对象为null。
  • assertNotNull([message], object)
    断言对象不为null。
  • assertTrue([message], condition)
    断言条件为真。
  • assertFalse([message], condition)
    断言条件为假。

4.4 Hamcrest与assertThat

Hamcrest是一个表达式类库，它提供了一套匹配符Matcher，且看其官网的说明：

Hamcrest is a library of matchers, which can be combined in to create flexible expressions of intent in tests. They've also been used for other purposes.

前面提到的那些断言方法，大家使用起来会可能会碰到一个问题：

  • 断言通常必须使用一个固定的expected值，如果测试数据稍微有一点变化，测试就可能不通过，这使得测试非常脆弱。例如我们断言assertEquals(0, code)，只能判断code是不是为0，如果code不等于0则测试失败，如果code = 0或者 code = 1都是符合我的预期的呢？那又该如何测试。

JUnit4结合Hamcrest提供了一个全新的断言语法：assertThat，结合Hamcrest提供的匹配符，可以表达全部的测试思想，上面提到的问题也迎刃而解。
使用gradle引入JUnit4.12时已经包含了hamcrest-core.jar、hamcrest-library.jar、hamcrest-integration.jar这三个jar包，所以我们无需额外再单独导入hamcrest相关类库。
assertThat定义如下：

public static <T> void assertThat(String reason, T actual,
            Matcher<? super T> matcher)
4.4.1 字符串相关匹配符
  • startsWith
  • endsWith
  • containsString
  • equalToIgnoringCase
  • equalToIgnoringWhiteSpace
4.4.2 数值相关匹配符
  • closeTo
  • greaterThan
  • lessThan
  • lessThanOrEqualTo
  • greaterThanOrEqualTo
4.4.3 集合相关匹配符
  • hasEntry
  • hasKey
  • hasValue
  • hasItem
  • hasItems
  • hasItemInArray
4.4.4 对象相关匹配符
  • notNullValue
  • nullValue
  • sameInstance
  • instanceOf
  • hasProperty
4.4.5 组合等逻辑匹配符
  • allOf
  • anyOf
  • both
  • either
  • is
  • isA
  • not
  • any
  • anything
//文本
assertThat("android studio", startsWith("and"));
assertThat("android studio", endsWith("dio"));
assertThat("android studio", containsString("android"));
assertThat("android studio", equalToIgnoringCase("ANDROID studio"));
assertThat("android studio ", equalToIgnoringWhiteSpace(" android studio "));

//数字
//测试数字在某个范围之类，10.6在[10.5-0.2, 10.5+0.2]范围之内
assertThat(10.6, closeTo(10.5, 0.2));
//测试数字大于某个值
assertThat(10.6, greaterThan(10.5));
//测试数字小于某个值
assertThat(10.6, lessThan(11.0));
//测试数字小于等于某个值
assertThat(10.6, lessThanOrEqualTo(10.6));
//测试数字大于等于某个值
assertThat(10.6, greaterThanOrEqualTo(10.6));

//集合类测试
Map<String, String> map = new HashMap<String, String>();
map.put("a", "hello");
map.put("b", "world");
map.put("c", "haha");
//测试map包含某个entry
assertThat(map, hasEntry("a", "hello"));
//测试map是否包含某个key
assertThat(map, hasKey("a"));
//测试map是否包含某个value
assertThat(map, hasValue("hello"));
List<String> list = new ArrayList<String>();
list.add("a");
list.add("b");
list.add("c");
//测试list是否包含某个item
assertThat(list, hasItem("a"));
assertThat(list, hasItems("a", "b"));
//测试数组是否包含某个item
String[] array = new String[]{"a", "b", "c", "d"};
assertThat(array, hasItemInArray("a"));

//测试对象
//测试对象不为null
assertThat(new Object(), notNullValue());
Object obj = null;
//测试对象为null
assertThat(obj, nullValue());
String str = null;
assertThat(str, nullValue(String.class));
obj = new Object();
Object obj2 = obj;
//测试2个引用是否指向的通一个对象
assertThat(obj, sameInstance(obj2));
str = "abc";
assertThat(str, instanceOf(String.class));

//测试JavaBean对象是否有某个属性
assertThat(new UserInfo(), hasProperty("name"));
assertThat(new UserInfo(), hasProperty("age"));

//-------组合逻辑测试--------
//两者都满足，a && b
assertThat(10.4, both(greaterThan(10.0)).and(lessThan(10.5)));
//所有的条件都满足，a && b && c...
assertThat(10.4, allOf(greaterThan(10.0), lessThan(10.5)));
//任一条件满足，a || b || c...
assertThat(10.4, anyOf(greaterThan(10.3), lessThan(10.4)));
//两者满足一个即可，a || b
assertThat(10.4, either(greaterThan(10.0)).or(lessThan(10.2)));
assertThat(10.4, is(10.4));
assertThat(10.4, is(equalTo(10.4)));
assertThat(10.4, is(greaterThan(10.3)));
str = new String("abc");
assertThat(str, is(instanceOf(String.class)));
assertThat(str, isA(String.class));
assertThat(10.4, not(10.5));
assertThat(str, not("abcd"));

assertThat(str, any(String.class));
assertThat(str, anything());

4.5 测试方法执行顺序

当我们运行一个测试类里的所有测试方法时，测试方法的执行顺序并不是固定的，JUnit4提供@ FixMethodOrder注解来配置执行顺序，其可选值有：MethodSorters.NAME_ASCENDING、MethodSorters.DEFAULT、MethodSorters.JVM

@FixMethodOrder(MethodSorters.NAME_ASCENDING)
public class TestExecOrder {

    @Test
    public void testD() {
        System.out.println("DDDDD");
    }

    @Test
    public void testA() {
        System.out.println("AAAAA");
    }

    @Test
    public void testB() {
        System.out.println("BBBBB");
    }

    @Test
    public void testC() {
        System.out.println("CCCCC");
    }
    
}

@FixMethodOrder(MethodSorters.NAME_ASCENDING)执行结果（按名称升序排列）：
AAAAA
BBBBB
CCCCC
DDDDD

@FixMethodOrder(MethodSorters.JVM)执行结果（每次执行可能都不一样）：
CCCCC
DDDDD
AAAAA
BBBBB

4.6 小结

本文介绍了JUnit4在android开发中怎样配置，JUnit的基本用法，JUnit常用的断言机制，以及与Hamcrest结合起来的强大的assertThat断言，这些功能基本上能满足我们绝大部分的单元测试编写。
接下来还会再介绍JUnit里更好玩的、更高级的用法。

系列文章：
Android单元测试（一）：前言
Android单元测试（二）：什么是单元测试
Android单元测试（三）：测试难点及方案选择
Android单元测试（四）：JUnit介绍
Android单元测试（五）：JUnit进阶
Android单元测试（六）：Mockito学习
Android单元测试（七）：Robolectric介绍
Android单元测试（八）：怎样测试异步代码

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,293评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,604评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,958评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,729评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,719评论 5赞 366
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,630评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,000评论 3赞 397
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,665评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,909评论 1赞 299
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1赞 330
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,400评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,986评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2赞 342