Android で Parameterized テスト（JUnit4, Robolectric）を行う

JUnit4

https://github.com/googlesamples/android-testing/tree/master/runner/AndroidJunitRunnerSample
にサンプルがあります。

具体的には CalculatorAddParameterizedTest.java がテストクラスで、
テスト対象のクラスは Calculator.java です。

上記のサンプルを見ればだいたいわかるのですが、Kotlinで書いた以下のFizzBazzをテストしてみたいと思います。

view plainprint?

1. class FizzBazz {  
2.   
3.     fun fizzbazz(value: Int): String {  
4.         return when {  
5.             value % 15 == 0 -> "fizzbazz"  
6.             value % 3 == 0 -> "fizz"  
7.             value % 5 == 0 -> "bazz"  
8.             else -> value.toString()  
9.         }  
10.     }  
11. }  

class FizzBazz { fun fizzbazz(value: Int): String { return when { value % 15 == 0 -> "fizzbazz" value % 3 == 0 -> "fizz" value % 5 == 0 -> "bazz" else -> value.toString() } } }

• 1. テストクラスに @RunWith アノテーションで Parameterized を指定する。
• 2. Parameterized テストで使う値をコンストラクタの引数として受け取り保持する。
• 3. @Parameters アノテーションをつけた static メソッドを用意する（つまり @JvmStatic が必要）。このメソッドではコンストラクタ引数に対応した値の配列のIterableを返す。
• 4. 保持した値を使ってテストする。

view plainprint?

1. /** 
2.  * @RunWith で Parameterized を指定する 
3.  * 
4.  * Parameterized テストで使う値をコンストラクタの引数として受け取る 
5.  * ここでは fizzbazz() に渡す値と、fizzbazz()の戻り値の期待値の2つを引数として受け取る 
6.  */  
7. @RunWith(Parameterized::class)  
8. class FizzBazzParameterizedTest(  
9.         private val value: Int,  
10.         private val expected: String  
11. ) {  
12.   
13.     private lateinit var fizzBazz: FizzBazz  
14.   
15.     @Before  
16.     fun setUp() {  
17.         fizzBazz = FizzBazz()  
18.     }  
19.   
20.     @Test  
21.     fun testFizzBazz() {  
22.         assertThat(fizzBazz.fizzbazz(value)).isEqualTo(expected)  
23.     }  
24.   
25.     companion object {  
26.   
27.         /** 
28.          * @Parameters と @JvmStatic をつける 
29.          * @return [Iterable] コンストラクタに渡す値のIterableを返す 
30.          */  
31.         @Parameters  
32.         @JvmStatic  
33.         fun data(): Iterable<Array<Any>> {  
34.             return listOf(  
35.                     arrayOf(1, "1"),  
36.                     arrayOf(2, "2"),  
37.                     arrayOf(3, "fizz"),  
38.                     arrayOf(4, "4"),  
39.                     arrayOf(5, "bazz"),  
40.                     arrayOf(15, "fizzbazz")  
41.             )  
42.         }  
43.     }  
44. }  

/** * @RunWith で Parameterized を指定する * * Parameterized テストで使う値をコンストラクタの引数として受け取る * ここでは fizzbazz() に渡す値と、fizzbazz()の戻り値の期待値の2つを引数として受け取る */ @RunWith(Parameterized::class) class FizzBazzParameterizedTest( private val value: Int, private val expected: String ) { private lateinit var fizzBazz: FizzBazz @Before fun setUp() { fizzBazz = FizzBazz() } @Test fun testFizzBazz() { assertThat(fizzBazz.fizzbazz(value)).isEqualTo(expected) } companion object { /** * @Parameters と @JvmStatic をつける * @return [Iterable] コンストラクタに渡す値のIterableを返す */ @Parameters @JvmStatic fun data(): Iterable<Array<Any>> { return listOf( arrayOf(1, "1"), arrayOf(2, "2"), arrayOf(3, "fizz"), arrayOf(4, "4"), arrayOf(5, "bazz"), arrayOf(15, "fizzbazz") ) } } }

テスト結果

Robolectric

BlockJUnit4ClassRunnerWithParameters を継承した Runner であれば、@Parameterized.UseParametersRunnerFactory でその Runner を返す ParametersRunnerFactory を指定することで、その Runner で Parameterized テストを実行することができます。

RobolectricTestRunner は SandboxTestRunner を継承しているためこの方法は使えません。 代わりに Robolectric には ParameterizedRobolectricTestRunner が用意されています。


TextUtils を使った次の EmptyChecker をテストしてみます。

view plainprint?

1. class EmptyChecker {  
2.   
3.     fun isEmpty(value: String?): Boolean {  
4.         return TextUtils.isEmpty(value)  
5.     }  
6. }  

class EmptyChecker { fun isEmpty(value: String?): Boolean { return TextUtils.isEmpty(value) } } 使い方は Parameterized とほぼ同じです。
違いは @RunWith に ParameterizedRobolectricTestRunner を指定することと、@ParameterizedRobolectricTestRunner.Parameters を使うことです。

view plainprint?

1. /** 
2.  * @RunWith で ParameterizedRobolectricTestRunner を指定する 
3.  * 
4.  * Parameterized テストで使う値をコンストラクタの引数として受け取る 
5.  * ここでは isEmpty() に渡す値と、isEmpty()の戻り値の期待値の2つを引数として受け取る 
6.  */  
7. @RunWith(ParameterizedRobolectricTestRunner::class)  
8. class EmptyCheckerParameterizedTest(  
9.         private val value: String?,  
10.         private val expected: Boolean  
11. ) {  
12.   
13.     private lateinit var emptyChecker: EmptyChecker  
14.   
15.     @Before  
16.     fun setUp() {  
17.         emptyChecker = EmptyChecker()  
18.     }  
19.   
20.     @Test  
21.     fun testFizzBazz() {  
22.         assertThat(emptyChecker.isEmpty(value)).isEqualTo(expected)  
23.     }  
24.   
25.     companion object {  
26.   
27.         /** 
28.          * @ParameterizedRobolectricTestRunner.Parameters と @JvmStatic をつける 
29.          * @return [Iterable] コンストラクタに渡す値のIterableを返す 
30.          */  
31.         @ParameterizedRobolectricTestRunner.Parameters  
32.         @JvmStatic  
33.         fun data(): Iterable<Array<Any?>> {  
34.             return listOf(  
35.                     arrayOf<Any?>(null, true),  
36.                     arrayOf<Any?>("", true),  
37.                     arrayOf<Any?>("a", false)  
38.             )  
39.         }  
40.     }  
41. }  

/** * @RunWith で ParameterizedRobolectricTestRunner を指定する * * Parameterized テストで使う値をコンストラクタの引数として受け取る * ここでは isEmpty() に渡す値と、isEmpty()の戻り値の期待値の2つを引数として受け取る */ @RunWith(ParameterizedRobolectricTestRunner::class) class EmptyCheckerParameterizedTest( private val value: String?, private val expected: Boolean ) { private lateinit var emptyChecker: EmptyChecker @Before fun setUp() { emptyChecker = EmptyChecker() } @Test fun testFizzBazz() { assertThat(emptyChecker.isEmpty(value)).isEqualTo(expected) } companion object { /** * @ParameterizedRobolectricTestRunner.Parameters と @JvmStatic をつける * @return [Iterable] コンストラクタに渡す値のIterableを返す */ @ParameterizedRobolectricTestRunner.Parameters @JvmStatic fun data(): Iterable<Array<Any?>> { return listOf( arrayOf<Any?>(null, true), arrayOf<Any?>("", true), arrayOf<Any?>("a", false) ) } } }

テスト結果