Android单元测试 - 验证函数参数、返回值的正确姿势

前言

读者有没发觉我写文章时，喜欢有个前言、序?真相是，一半用来装逼凑字数，一半是因为不知道接下来要写什么，先闲聊几句压压惊^_^ 哈哈哈......该说的还是要说。

上一篇《Android单元测试 - Sqlite、SharedPreference、Assets、文件操作 怎么测?》 讲了一些DAO(Data Access Object)单元测试的细节。本篇讲解参数验证。

验证参数传递、函数返回值，是单元测试中十分重要的环节。笔者相信不少读者都有验证过参数，但是你的单元测试代码真的是正确的吗?笔者在早期实践的时候，遇到一些问题，积累了一点心得，本期与大家分享一下。

1.一般形式

Bean

1. public class Bean { 
2.     int    id; 
3.     String name; 
4.  
5.     public Bean(int id, String name) { 
6.         this.id = id; 
7.         this.name = name; 
8.     } 
9.     // getter and setter 
10.     ...... 
11. }  

DAO

1. public class DAO { 
2.     public Bean get(int id) { 
3.         return new Bean(id, "bean_" + id); 
4.     } 
5. }  

Presenter

1. public class Presenter { 
2.  
3.     DAO dao; 
4.  
5.     public Presenter(DAO dao) { 
6.         this.dao = dao; 
7.     } 
8.  
9.     public Bean getBean(int id) { 
10.         Bean bean = dao.get(id); 
11.  
12.         return bean; 
13.     } 
14. }  

单元测试PresenterTest(下文称为“例子1”)

1. public class PresenterTest { 
2.  
3.     DAO       dao; 
4.     Presenter presenter; 
5.  
6.     @Before 
7.     public void setUp() throws Exception { 
8.         dao = mock(DAO.class); 
9.         presenter = new Presenter(dao); 
10.     } 
11.  
12.     @Test 
13.     public void testGetBean() throws Exception { 
14.         Bean bean = new Bean(1, "bean_1"); 
15.  
16.         when(dao.get(1)).thenReturn(bean); 
17.  
18.         Bean result = presenter.getBean(1); 
19.  
20.         Assert.assertEquals(result.getId(), 1); 
21.         Assert.assertEquals(result.getName(), "bean_1"); 
22.     } 
23. }  

这个单元测试是通过的。

2.问题：对象很多变量

上面的Bean只有2个参数，但实际项目，对象往往有很多很多参数，例如，用户信息User ：

1. public class User { 
2.     int    id; 
3.     String name; 
4.  
5.     String country; 
6.     String province; 
7.     String city; 
8.     String address; 
9.     int    zipCode; 
10.  
11.     long birthday; 
12.  
13.     double height; 
14.     double weigth; 
15.  
16.     ... 
17. }  

单元测试：

1. @Test 
2.    public void testUser() throws Exception { 
3.        User user = new User(1, "bean_1"); 
4.        user.setCountry("中国"); 
5.        user.setProvince("广东"); 
6.        user.setCity("广州"); 
7.        user.setAddress("天河区临江大道海心沙公园"); 
8.        user.setZipCode(510000); 
9.        user.setBirthday(631123200); 
10.        user.setHeight(173); 
11.        user.setWeigth(55); 
12.        user.setXX(...); 
13.  
14.        ..... 
15.  
16.        User result = presenter.getUser(1); 
17.  
18.        Assert.assertEquals(result.getId(), 1); 
19.        Assert.assertEquals(result.getName(), "bean_1"); 
20.        Assert.assertEquals(result.getCountry(), "中国"); 
21.        Assert.assertEquals(result.getProvince(), "广东"); 
22.        Assert.assertEquals(result.getCity(), "广州"); 
23.        Assert.assertEquals(result.getAddress(), "天河区临江大道海心沙公园"); 
24.        Assert.assertEquals(result.getZipCode(), 510000); 
25.        Assert.assertEquals(result.getBirthday(), 631123200); 
26.        Assert.assertEquals(result.getHeight(), 173); 
27.        Assert.assertEquals(result.getWeigth(), 55); 
28.        Assert.assertEquals(result.getXX(), ...); 
29.        ...... 
30.    }  

一般形式的单元测试，有10个参数，就要set()10次，get()10次，如果参数更多，一个工程有几十上百个这种测试......感受到那种蛋蛋的痛了吗?

这里有两个痛点：

1. 生成对象必须 调用所有setter() 赋值成员变量
2. 验证返回值，或者回调参数时，必须 调用所有getter() 获取成员值

3.equals()对比对象，可行吗?

直接调用equals()

这时同学A举手了：“不就是比较对象吗，用equal()还不行?”

为了演示方便，还是用回Bean做例子：

1. @Test 
2.     public void testGetBean() throws Exception { 
3.         Bean bean = new Bean(1, "bean_1"); 
4.  
5.         when(dao.get(1)).thenReturn(bean); 
6.  
7.         Bean result = presenter.getBean(1); 
8.  
9.         Assert.assertTrue(result.equals(bean)); 
10.     }  

运行一下：

诶，还真通过了!第一个问题解决了，鼓掌..... 稍等，我们把Presenter代码改改，看还能不能凑效：

1. public class Presenter { 
2.  
3.     public Bean getBean(int id) { 
4.         Bean bean = dao.get(id); 
5.  
6.         return new Bean(bean.getId(), bean.getName()); 
7.     } 
8. }  

再运行单元测试：

果然出错了!

我们分析一下问题，修改前的Presenter.getBean()方法， dao.get()得到的Bean对象，直接作为返回值，所以PresenterTest中Assert.assertTrue(result.equals(bean));通过测试，因为bean和result是同一个对象;修改后，Presenter.getBean()里，返回值是dao.get()得到的Bean的深拷贝，bean和result是不同对象，因此result.equals(bean)==false，测试失败。如果我们使用一般形式Assert.assertEquals(result.getXX(), ...);，单元测试是通过的。

无论是直接返回对象，深拷贝，只要参数一致，都符合我们期望的结果。所以，仅仅调用equals()解决不了问题。

重写equals()方法

同学B：“既然只是比较成员值，重写equals()!”

1. public class Bean { 
2.     @Override 
3.     public boolean equals(Object obj) { 
4.         if (obj instanceof Bean) { 
5.             Bean bean = (Bean) obj; 
6.  
7.             boolean isEquals = false; 
8.  
9.             if (isEquals) { 
10.                 isEquals = id == bean.getId(); 
11.             } 
12.  
13.             if (isEquals) { 
14.                 isEquals = (name == null && bean.getName() == null) || (name != null && name.equals(bean.getName())); 
15.             } 
16.  
17.             return isEquals; 
18.         } 
19.  
20.         return false; 
21.     } 
22. }  

再次运行单元测试Assert.assertTrue(result.equals(bean));：

稍等，这样我们不是回到老路，每个java bean都要重写equals()吗?尽管整个工程下来，总体代码会减少，但这真不是好办法。

反射比较成员值

同学C：“我们可以用反射获取两个对象所有成员值，并逐一对比。”

哈哈哈，同学C比同学A、B都要聪明点，还会反射!

1. public class PresenterTest{ 
2.     @Test 
3.     public void testGetBean() throws Exception { 
4.         ... 
5.         ObjectHelper.assertEquals(bean, result); 
6.     } 
7. }  

1. public class ObjectHelper { 
2.  
3.     public static boolean assertEquals(Object expect, Object actual) throws IllegalAccessException { 
4.         if (expect == actual) { 
5.             return true; 
6.         } 
7.  
8.         if (expect == null && actual != null || expect != null && actual == null) { 
9.             return false; 
10.         } 
11.  
12.         if (expect != null) { 
13.             Class clazz = expect.getClass(); 
14.  
15.             while (!(clazz.equals(Object.class))) { 
16.                 Field[] fields = clazz.getDeclaredFields(); 
17.  
18.                 for (Field field : fields) { 
19.                     field.setAccessible(true); 
20.  
21.                     Object value0 = field.get(expect); 
22.                     Object value1 = field.get(actual); 
23.  
24.                     Assert.assertEquals(value0, value1); 
25.                 } 
26.  
27.                 clazz = clazz.getSuperclass(); 
28.             } 
29.         } 
30.  
31.         return true; 
32.     } 
33. }  

运行单元测试，通过!

用反射直接对比成员值，思路是正确的。这里解决了“对比两个对象的成员值是否相同，不需要get()n次”问题。不过，仅仅比较两个对象，这个单元测试还是有问题的。我们先讲第4节，这个问题留在第5节给大家说明。

4.省略不必要setter()

在testUser()中，第一个痛点：“生成对象必须 调用所有setter() 赋值成员变量”。 上一节同学C用反射方案，把对象成员值拿出来，逐一比较。这个方案提醒了我们，赋值也可以同样方案。

ObjectHelper:

1. public class ObjectHelper { 
2.  
3.     protected static final List numberTypes = Arrays.asList(int.class, long.class, double.class, float.class, boolean.class); 
4.  
5.     public static  T random(Class clazz) throws IllegalAccessException, InstantiationException { 
6.         try { 
7.             T obj = newInstance(clazz); 
8.  
9.             Class tClass = clazz; 
10.  
11.             while (!tClass.equals(Object.class)) { 
12.  
13.                 Field[] fields = tClass.getDeclaredFields(); 
14.  
15.                 for (Field field : fields) { 
16.                     field.setAccessible(true); 
17.  
18.                     Class type      = field.getType(); 
19.                     int   modifiers = field.getModifiers(); 
20.  
21.                     // final 不赋值 
22.                     if (Modifier.isFinal(modifiers)) { 
23.                         continue; 
24.                     } 
25.  
26.                     // 随机生成值 
27.                     if (type.equals(Integer.class) || type.equals(int.class)) { 
28.                         field.set(obj, new Random().nextInt(9999)); 
29.                     } else if (type.equals(Long.class) || type.equals(long.class)) { 
30.                         field.set(obj, new Random().nextLong()); 
31.                     } else if (type.equals(Double.class) || type.equals(double.class)) { 
32.                         field.set(obj, new Random().nextDouble()); 
33.                     } else if (type.equals(Float.class) || type.equals(float.class)) { 
34.                         field.set(obj, new Random().nextFloat()); 
35.                     } else if (type.equals(Boolean.class) || type.equals(boolean.class)) { 
36.                         field.set(obj, new Random().nextBoolean()); 
37.                     } else if (CharSequence.class.isAssignableFrom(type)) { 
38.                         String name = field.getName(); 
39.                         field.set(obj, name + "_" + (int) (Math.random() * 1000)); 
40.                     } 
41.                 } 
42.                 tClass = tClass.getSuperclass(); 
43.             } 
44.             return obj; 
45.         } catch (Exception e) { 
46.             e.printStackTrace(); 
47.         } 
48.         return null; 
49.     } 
50.  
51.     protected static  T newInstance(Class clazz) throws IllegalAccessException, InvocationTargetException, InstantiationException { 
52.  
53.         Constructor constructor = clazz.getConstructors()[0];// 构造函数可能是多参数 
54.  
55.         Class[] types = constructor.getParameterTypes(); 
56.  
57.         List