Junit 的 @RunWith()：Runner，即Junit的运行器

Posted 2022-10-30 我爱烤冷面

什么是Runner,@RunWith()到底有什么用？
Runner是Junit的运行器，即运行测试用例的工具。
我们可以在测试类之上，使用@RunWith()注解为这个类指定一个特定的Runner。当我们没有指定@RunWith()的时候，会自动使用Junit的默认Runner——BlockJunit4ClassRunner。

常用的Runner：
Suite:测试套件 ；Category:按种类区分的套件；Parameterized:参数化测试; Theories:排列组合。

利用 Runner，可以解决哪些问题？
1.当一个测试方法，存在多种可能的情况时，为了避免重复代码， Junit提出了“参数化测试”的概念，只写一个测试函数，把这若干种情况作为参数传递进去，一次性的完成测试。
2.当有很多测试类的时候，一次性的跑完所有测试类，或者跑完指定模块的多个测试类，或者跑完指定类的某些测试方法。

关于问题1，可以比较一下，使用和不使用参数化测试的区别：
不使用：

@Test
public void test_getSalaryCodeMonth() throws Exception 

    String result = salaryUtil.getSalaryCodeMonth("1500以下");
    assertEquals("0-1500", result);

    result = salaryUtil.getSalaryCodeMonth("100000及以上");
    assertEquals("100000-", result);

    result = salaryUtil.getSalaryCodeMonth("1500-1999");
    assertEquals("1500-1999", result);

使用后：

@Parameterized.Parameters
public static Collection params()
    return Arrays.asList(new Object[][] 
             "1500以下", "0-1500",  "100000及以上", "100000-" ,  "1500-1999", "1500-1999"
    );

@Test
public void test_getSalaryCodeMonth() 
    String result = salaryUtil.getSalaryCodeMonth((String) input);
    assertEquals(expected, result);

上面的案例，虽然代码量上面没有很大的变化，但是可以考虑一下，当需要测试的情况非常多，远大于3个的时候，使用参数化进行测试，会使得代码看起来简洁，可维护性高。
下面简单介绍一下Parameterized，参数化的用法。
（1）使用 @RunWith(Parameterized.class)修饰类
（2）指定参数，这里有两种方案，一种是注解注入，一种是构造器注入：

    //方案1 注解注入
    @Parameterized.Parameter()
    public Object input;
    @Parameterized.Parameter(1)
    public Object expected;

    public BaseSalaryUtilTest()
    //方案2 构造器注入
//    public BaseSalaryUtilTest(Object input, Object expected)
//        this.input = input;
//        this.expected =expected;
//    

（3）构造参数列表方法，该方法需要用@Parameterized.Parameters修饰，方法需要为 public static 修饰，返回Collection类型

@Parameterized.Parameters
public static Collection params()
    return Arrays.asList(new Object[][] 
             "1500以下", "0-1500",  "100000及以上", "100000-" ,  "1500-1999", "1500-1999"
    );

（4）接下来就可以直接使用 input 、expected这两个参数了，测试用例在运行的时候会根据参数一一匹配执行。
关于解决的问题2：
当然你可以直接在包名上右击，然后选择执行全部的测试用例。还有一种方法就是使用Suite运行器，指定所有你想执行的测试类。
如下，定义个类，使用**@RunWith(Suite.class)修饰，并使用@Suite.SuiteClasses**指定想要同时执行的测试类。这个类可以没有内容，在执行的时候，会把所有指定的类内的测试用例全部执行一遍。

@RunWith(Suite.class)
@Suite.SuiteClasses(GetSalaryCodeMonth.class, GetSalaryCodeYear.class, GetMonthSalaryStringUnit.class,
        GetTextShowSalary.class, GetSalaryStringE.class, GetSalaryCodeE.class, GetUnit.class,
        GetMonthSalaryString.class, GetNormSalaryString.class, GetLocationStringTest.class, GetLocationStringCustomTest.class)
public class DoSalaryUtilTest 

当你的需求是，针对同一个测试类里面的不同方法需要进行分类测试时，可以使用Category运行器，Category继承于Suite。在一个测试类中，可以给不同的测试方法使用不同的@Category(AFun.class) 来修饰，比如@Category(AFun.class)、@Category(BFun.class)。
执行的时候，使用**@RunWith(Categories.class)修饰类，代表执行Category运行器，同样需要使用@SuiteClasses指定要执行哪个类，然后通过@IncludeCategory(AFun.class)**来执行被标记为@Category(AFun.class)的方法。

@RunWith(Categories.class)
@SuiteClasses(GetSalaryCodeMonth .class)
@IncludeCategory(AFun.class)