JUnit - パラメータ化されたテスト

JUnit –パラメーター化されたテスト

JUnitでは、次のメソッドを介してユニットテストメソッドにパラメータを渡すことができます:

  1. コンストラクタ

  2. @Parameterによるフィールド注入

P.S Tested with JUnit 4.12

1. MatchUtils –複数のパラメーターを使用したテスト

簡単な追加操作。

MathUtils.java

package com.example.examples;

public class MathUtils {

    public static int add(int a, int b) {
        return a + b;
    }

}

1.2 MatchUtils – Parameterized via Constructor

パラメーターは、コンストラクターを介してテストメソッドに渡されます。

ParameterizedTest.java

package com.example;

import com.example.examples.MathUtils;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters;

import java.util.Arrays;
import java.util.Collection;

import static org.hamcrest.CoreMatchers.is;
import static org.junit.Assert.assertThat;

@RunWith(value = Parameterized.class)
public class ParameterizedTest {

    private int numberA;
    private int numberB;
    private int expected;

    // Inject via constructor
    // for {8, 2, 10}, numberA = 8, numberB = 2, expected = 10
    public ParameterizedTest(int numberA, int numberB, int expected) {
        this.numberA = numberA;
        this.numberB = numberB;
        this.expected = expected;
    }

    // name attribute is optional, provide an unique name for test
    // multiple parameters, uses Collection
    @Parameters(name = "{index}: testAdd({0}+{1}) = {2}")
    public static Collection data() {
        return Arrays.asList(new Object[][]{
                {1, 1, 2},
                {2, 2, 4},
                {8, 2, 10},
                {4, 5, 9},
                {5, 5, 10}
        });
    }

    @Test
    public void test_addTwoNumbes() {
        assertThat(MathUtils.add(numberA, numberB), is(expected));
    }

}

1.3 MatchUtils – Parameterized via Field Injection

パラメータは、フィールドインジェクションを介してテストメソッドに渡されます。

ParameterizedTest.java

package com.example;

import com.example.examples.MathUtils;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters;
import org.junit.runners.Parameterized.Parameter;

import java.util.Arrays;
import java.util.Collection;

import static org.hamcrest.CoreMatchers.is;
import static org.junit.Assert.assertThat;

@RunWith(value = Parameterized.class)
public class ParameterizedTest {

    //default value = 0
    @Parameter(value = 0)
    public int numberA;

    @Parameter(value = 1)
    public int numberB;

    @Parameter(value = 2)
    public int expected;

    @Parameters(name = "{index}: testAdd({0}+{1}) = {2}")
    public static Collection data() {
        return Arrays.asList(new Object[][]{
                {1, 1, 2},
                {2, 2, 4},
                {8, 2, 10},
                {4, 5, 9},
                {5, 5, 10}
        });
    }

    @Test
    public void test_addTwoNumbes() {
        assertThat(MathUtils.add(numberA, numberB), is(expected));
    }

}

Note
@Parametersの場合、「name」属性はオプションであり、一意の名前を指定することで個々のテストケースを識別するのに役立ちます。

What is {0}, {1} and {2}?
パラメータが「\ {3、4、7}」の場合、{0} = 3、{1} = 4、{2} = 7です。

出力

junit-parameterized-1

2. DomainUtils –単一のパラメーターでテストする

別の単純なクラス、ドメイン名を検証します。

DomainUtils.java

package com.example.examples;

import java.util.regex.Pattern;

public class DomainUtils {

    private static final String DOMAIN_NAME_PATTERN = "^((?!-)[A-Za-z0-9-]{1,63}(?

2.1 DomainUtils Parameterized Test

パラメータは、フィールドインジェクションを介してテストメソッドに渡されます。

ParameterizedTest.java

package com.example;

import com.example.examples.DomainUtils;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameter;
import org.junit.runners.Parameterized.Parameters;

import static org.hamcrest.CoreMatchers.is;
import static org.junit.Assert.assertThat;

@RunWith(value = Parameterized.class)
public class Parameterized2Test {

    //default value = 0
    @Parameter
    public String domainName;

    //Single parameter, use Object[]
    @Parameters(name = "{index}: testDomain - {0}")
    public static Object[] data() {
        return new Object[]{
                "google.com",
                "example.com",
                "twitter.com"
        };
    }

    @Test
    public void test_valid_domain() {
        assertThat(DomainUtils.isValid(domainName), is(true));
    }

}

出力

junit-parameterized-2

Note
TestNGは、パラメーターを単体テストに渡す方法がより柔軟です。このTestNG parameter testをお読みください。