计算机系统应用教程网站

网站首页 > 技术文章 正文

Spring系列:Spring集成junit,太好用了

btikc 2024-09-02 17:15:39 技术文章 9 ℃ 0 评论

通常我们写完代码之后,为了确保代码的正确性,都需要自己测试一遍,看一下代码的运行结果和我们期望的结果是不是一样的,也就是我们常说的单元测试,java中最常用的单元测试框架是junit,本文主要介绍3个内容:

1、玩转junit

2、spring集成junit

3、开发工具中使用junit

1、背景

我们写了一个工具类,有2个方法

package com.javacode2018.junit.demo1; public class MathUtils {    /**     * 获取最大的数字     *     * @param args     * @return     */    public static int max(int... args) {        int result = Integer.MIN_VALUE;        for (int arg : args) {            result = result > arg ? result : arg;        }        return result;    }     /**     * 获取最小的数字     *     * @param args     * @return     */    public static int min(int... args) {        int result = Integer.MAX_VALUE;        for (int arg : args) {            result = result < arg ? result : arg;        }        return result;    } }

然后我们想测试这两个方法,下面我们来写测试代码,如下,测试一下max方法和min方法的结果和我们期望的结果是否一致,不一致的时候,输出一段文字

package com.javacode2018.junit.demo1; public class MathUtilsTest1 {    public static void main(String[] args) {        testMax();        testMin();    }     public static void testMax() {        int result = MathUtils.max(1, 2, 3);        if (result != 3) {            System.out.println(String.format("max 方法有问题,期望结果是3,实际结果是%d", result));        }    }     public static void testMin() {        int result = MathUtils.min(1, 2, 3);        if (result != 1) {            System.out.println(String.format("min 方法有问题,期望结果是3,实际结果是%d", result));        }    }}

上面我们要测试的方法就2个,若需测试的方法很多的时候,咱们需要写大量的这种测试代码,工作量还是蛮大的,而junit做的事情和上面差不多,都是用来判断被测试的方法和期望的结果是否一致,不一致的时候给出提示,不过junit用起来更容易一些,还有各种开发用到的ide(eclipse、idea)结合的更好一些,用起来特别的顺手。

2、junit用法详解

2.1、使用步骤

1)、添加junit maven配置,这里我们就用4.13,你们也可以用最新的

<dependency>    <groupId>junit</groupId>    <artifactId>junit</artifactId>    <version>4.13</version></dependency>

2)、写测试用例,在写好的测试方法上面添加@Test注解,比如我们需要对上面案例中的max方法进行测试,通常我们会新建一个测试类,类名为被测试的类加上Test后缀,即:MathUtilsTest,然后在这个类我们需要写max方法的测试方法,如下,需要我们在max方法上面加上@Test注解

package com.javacode2018.junit.demo1; import org.junit.Assert;import org.junit.Test; public class MathUtilsTest {    @Test    public void max() throws Exception {        int result = MathUtils.max(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 3);    }}

3、运行测试用例,现在测试代码都写好了,下面我们写个类来启动测试用例,这里需要使用JUnitCore.runClasses方法来运行测试用例,如下:

package com.javacode2018.junit.demo1; import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.notification.Failure; public class Demo1TestRunner {    public static void main(String[] args) {        //使用JUnitCore.runClasses方法传入测试用例的类,然后获取测试用例的运行结果        Result result = JUnitCore.runClasses(MathUtilsTest.class);        //获取失败的用例        for (Failure failure : result.getFailures()) {            System.out.println(failure);        }        //获取所有测试用例是否执行成功        System.out.println(result.wasSuccessful());    }}

2.2、同时运行多个测试用例

可以一个测试类中写多个测试方法,每个方法上加上@Test注解就可以了,然后通过JUnitCore来执行就可以,下面代码中我们写2个方法对MathUtils中的max和min方法都进行测试,我们故意将执行结果和期望结果搞成不一致的,运行下面代码,然后看看运行结果。

package com.javacode2018.junit.demo2; import com.javacode2018.junit.demo1.MathUtils;import org.junit.Assert;import org.junit.Test;import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.manipulation.Ordering;import org.junit.runner.notification.Failure; public class MathUtilsTest2 {    @Test    public void max() throws Exception {        int result = MathUtils.max(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 1);    }     @Test    public void min() throws Exception {        int result = MathUtils.min(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 3);    }     public static void main(String[] args) {        Result result = JUnitCore.runClasses(MathUtilsTest2.class);         System.out.println("失败用例个数:" + result.getFailures().size());        for (Failure failure : result.getFailures()) {            System.out.println(failure);        }        System.out.println("运行测试用例个数:" + result.getRunCount());        System.out.println("运行测试用例总耗时(ms):" + result.getRunTime());        System.out.println("测试用例是否都成功了:" + result.wasSuccessful());    }}

运行输出如下,运行了2个用例,失败了2个,测试的详细信息都被输出了

失败用例个数:2max(com.javacode2018.junit.demo2.MathUtilsTest2): expected:<3> but was:<1>min(com.javacode2018.junit.demo2.MathUtilsTest2): expected:<1> but was:<3>运行测试用例个数:2运行测试用例总耗时(ms):11测试用例是否都成功了:false

2.3、使用断言

什么是断言?

断言是用来判断程序的运行结果和我们期望的结果是不是一致的,如果不一致,会抛出异常,断言中有3个信息比较关键

1、被测试的数据

2、期望的数据

3、抛出异常

断言提供的方法将被测试的数据和期望的数据进行对比,如果不一样的时候,将抛出异常,程序可以捕获这个异常,这样就可以知道测试失败了。

junit中的org.junit.Assert类中提供了大量静态方法,用来判断被测试的数据和期望的数据是否一致,不一致,将抛出异常,这里随便列几个大家看一下吧

//判断condition如果不是true,将抛出异常,异常的提示信息是messagepublic static void assertTrue(String message, boolean condition)  //判断expected和actual是否相等,如果不相等,将抛出异常public static void assertEquals(Object expected, Object actual)

用法,如:

int result = MathUtils.max(1, 2, 3);//判断测试结果和我们期望的结果是否一致Assert.assertEquals(result, 1);

2.4、测试套件:批量运行测试用例

到目前为止,我们还只能一次运行一个测试类,如下

JUnitCore.runClasses(MathUtilsTest2.class)

但是在实际项目中,我们可能会有很多测试类,需要批量运行。

比如我们有下面2个测试类

MathUtilsTest3001.java

package com.javacode2018.junit.demo3; import com.javacode2018.junit.demo1.MathUtils;import org.junit.Assert;import org.junit.Test; public class MathUtilsTest3001 {    @Test    public void max() throws Exception {        int result = MathUtils.max(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 3);    }     @Test    public void min() throws Exception {        int result = MathUtils.min(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 1);    }}

MathUtilsTest3002.java

package com.javacode2018.junit.demo3; import com.javacode2018.junit.demo1.MathUtils;import org.junit.Assert;import org.junit.Test;import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.notification.Failure; public class MathUtilsTest3002 {    @Test    public void max() throws Exception {        int result = MathUtils.max(100, 99, 200);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 200);    }     @Test    public void min() throws Exception {        int result = MathUtils.min(1, -1, 10);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, -1);    }}

现在我们希望同时运行上面2个测试类,我们可以这么做,创建一个AllTest.java类,注意这个类上有2个注解比较特殊,都是junit提供的,@RunWith表示这是一个测试套件类,需要批量运行测试类,具体要运行哪些测试类呢,通过@Suite.SuiteClasses来指定

package com.javacode2018.junit.demo3; import org.junit.runner.RunWith;import org.junit.runners.Suite; @RunWith(Suite.class)@Suite.SuiteClasses({MathUtilsTest3001.class, MathUtilsTest3002.class})public class AllTest {}

下面来个启动类,将AllTest传递给JUnitCore.runClasses

package com.javacode2018.junit.demo3; import com.javacode2018.junit.demo1.MathUtilsTest;import com.javacode2018.junit.demo2.MathUtilsTest2;import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.notification.Failure; public class Demo3TestRunner {    public static void main(String[] args) {        //@1:传入AllTest        Result result = JUnitCore.runClasses(AllTest.class);         System.out.println("失败用例个数:" + result.getFailures().size());        for (Failure failure : result.getFailures()) {            System.out.println(failure);        }        System.out.println("运行测试用例个数:" + result.getRunCount());        System.out.println("运行测试用例总耗时(ms):" + result.getRunTime());        System.out.println("测试用例是否都成功了:" + result.wasSuccessful());    }}

运行输出

失败用例个数:0运行测试用例个数:4运行测试用例总耗时(ms):12测试用例是否都成功了:true

测试套件中不仅可以包含基本的测试类,而且可以包含其它的测试套件,这样可以很方便的分层管理不同模块的单元测试代码,比如下面代码,Module2Test和Module2Test都是测试套件

@RunWith(Suite.class)@Suite.SuiteClasses({Test1.class, Test2.class})public class Module2Test {} @RunWith(Suite.class)@Suite.SuiteClasses({Test1.class, Test2.class})public class Module2Test {} @RunWith(Suite.class)@Suite.SuiteClasses({Module2Test.class, Module2Test.class, Test3.java})public class AllTest {} //运行AllTestJUnitCore.runClasses(AllTest.class);

2.5、Junit常用注解

1)@Test注解

@Test:将一个普通方法修饰成一个测试方法

@Test(excepted=xx.class):xx.class 表示异常类,表示测试的方法抛出此异常时,认为是正常的测试通过的

@Test(timeout = 毫秒数):测试方法执行时间是否符合预期

2)@BeforeClass

会在所有的方法执行前被执行,static 方法 (全局只会执行一次,而且是第一个运行)

3)@AfterClass

会在所有的方法执行之后进行执行,static 方法 (全局只会执行一次,而且是最后一个运行)

4)@Before

会在每一个测试方法被运行前执行一次

5)@After

会在每一个测试方法运行后被执行一次

6)@Ignore

所修饰的测试方法会被测试运行器忽略

7)@RunWith

可以更改测试运行器 org.junit.runner.Runner

下面的案例,基本上用到了上面所有的注解,大家结合输出理解一下。

package com.javacode2018.junit.demo4; import com.javacode2018.junit.demo1.MathUtils;import org.junit.*;import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.notification.Failure; import java.util.concurrent.TimeUnit; public class MathUtilsTest4 {     @BeforeClass    public static void bc() {        System.out.println("@BeforeClass");        System.out.println("-----------------");    }     @AfterClass    public static void ac() {        System.out.println("@AfterClass");    }     @Before    public void bf() {        System.out.println("@Before:" + this);    }     @After    public void af() {        System.out.println("@After:" + this);        System.out.println("##################");    }     @Test    public void max() throws Throwable {        System.out.println("max():" + this);        int result = MathUtils.max(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 3);    }     @Test    public void min() throws Exception {        System.out.println("min():" + this);        int result = MathUtils.min(1, 2, 3);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(result, 1);    }     //方法运行时间超过了timeout,表示测试用例运行失败    @Test(timeout = 1000)    public void timeOutTest() throws InterruptedException {        System.out.println("timeOutTest():" + this);        TimeUnit.SECONDS.sleep(2000);    }     //方法若未抛出expected指定的异常,表示测试用例运行失败    @Test(expected = NullPointerException.class)    public void expectedTest() {        System.out.println("expectedTest():" + this);        new RuntimeException("异常不匹配");    }     @Test    @Ignore    public void ignoredMethod() {        System.out.println("我是被忽略的方法");    }     public static void main(String[] args) {        Result result = JUnitCore.runClasses(MathUtilsTest4.class);        System.out.println("-----------------");        System.out.println("运行测试用例个数:" + result.getRunCount());        System.out.println("失败用例个数:" + result.getFailures().size());        for (Failure failure : result.getFailures()) {            System.out.println(failure);        }        System.out.println("运行测试用例总耗时(ms):" + result.getRunTime());        System.out.println("测试用例是否都成功了:" + result.wasSuccessful());     }}

运行结果如下

@BeforeClass-----------------@Before:com.javacode2018.junit.demo4.MathUtilsTest4@78e03bb5timeOutTest():com.javacode2018.junit.demo4.MathUtilsTest4@78e03bb5@After:com.javacode2018.junit.demo4.MathUtilsTest4@78e03bb5##################@Before:com.javacode2018.junit.demo4.MathUtilsTest4@48533e64max():com.javacode2018.junit.demo4.MathUtilsTest4@48533e64@After:com.javacode2018.junit.demo4.MathUtilsTest4@48533e64##################@Before:com.javacode2018.junit.demo4.MathUtilsTest4@7e0b37bcmin():com.javacode2018.junit.demo4.MathUtilsTest4@7e0b37bc@After:com.javacode2018.junit.demo4.MathUtilsTest4@7e0b37bc##################@Before:com.javacode2018.junit.demo4.MathUtilsTest4@1a93a7caexpectedTest():com.javacode2018.junit.demo4.MathUtilsTest4@1a93a7ca@After:com.javacode2018.junit.demo4.MathUtilsTest4@1a93a7ca##################@AfterClass-----------------运行测试用例个数:4失败用例个数:3timeOutTest(com.javacode2018.junit.demo4.MathUtilsTest4): test timed out after 1000 millisecondsmax(com.javacode2018.junit.demo4.MathUtilsTest4): hah expectedTest(com.javacode2018.junit.demo4.MathUtilsTest4): Expected exception: java.lang.NullPointerException运行测试用例总耗时(ms):1018测试用例是否都成功了:false

从输出中可以看出

  • @BeforeClass和@AfterClass标注的方法只会运行一次
  • 每个@Test标注的方法运行之前会先运行@Before标注的方法,然后运行@Test标注的这个方法,之后再运行@After
  • 从this的输出看出,每个@Test运行的时候,当前类的实例都会重新创建一个新的
  • 不论@Test标注的方法是否异常,@AfterClass、@After标注的方法都会执行,且异常会被淹没,输出中看不到异常信息

2.6、参数化测试

Junit 4 引入了一个新的功能参数化测试

参数化测试允许开发人员使用不同的值反复运行同一个测试,你将遵循 5 个步骤来创建参数化测试

  • 用 @RunWith(Parameterized.class) 来注释 test 类。
  • 创建一个由 @Parameters 注释的公共的静态方法,它返回一个对象的集合(数组)来作为测试数据集合。
  • 创建一个公共的构造函数,它接受和一行测试数据相等同的东西。
  • 为每一列测试数据创建一个实例变量。
  • 用实例变量作为测试数据的来源来创建你的测试用例。

可能大家看了上面的理解,还是比较迷糊。

比如我们com.javacode2018.junit.demo1.MathUtils#max测试下面几组数组

1,2,3100,99,8030,-1,100

我们可以这么写

package com.javacode2018.junit.demo5; import com.javacode2018.junit.demo1.MathUtils;import org.junit.Assert;import org.junit.Test;import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.RunWith;import org.junit.runner.notification.Failure;import org.junit.runners.Parameterized; import java.util.ArrayList;import java.util.Arrays;import java.util.List; @RunWith(Parameterized.class)public class MathUtilsTest5 {     public static class TestData {        int[] testData;//测试数据        int expectedValue;//预期的结果         public TestData(int[] testData, int expectedValue) {            this.testData = testData;            this.expectedValue = expectedValue;        }         @Override        public String toString() {            return "TestData{" +                    "testData=" + Arrays.toString(testData) +                    ", expectedValue=" + expectedValue +                    '}';        }    }     private TestData testData;     @Parameterized.Parameters    public static List<TestData> initTestData() {        System.out.println("initTestData()");        //key:期望的结果,value:max方法需要测试的数据        List<TestData> result = new ArrayList<>();        result.add(new TestData(new int[]{1, 2, 3}, 3));        result.add(new TestData(new int[]{100, 99, 80}, 100));        result.add(new TestData(new int[]{30, -1, 100}, 100));        return result;    }     public MathUtilsTest5(TestData testData) {        System.out.println("MathUtilsTest5构造器:" + testData);        this.testData = testData;    }     @Test    public void maxTest() throws Throwable {        System.out.println(this.hashCode() + ",maxTest():" + this.testData);        int result = MathUtils.max(this.testData.testData);        //判断测试结果和我们期望的结果是否一致        Assert.assertEquals(this.testData.expectedValue, result);        System.out.println("###################");    }     public static void main(String[] args) {        Result result = JUnitCore.runClasses(MathUtilsTest5.class);        System.out.println("-----------------");        System.out.println("运行测试用例个数:" + result.getRunCount());        System.out.println("失败用例个数:" + result.getFailures().size());        for (Failure failure : result.getFailures()) {            System.out.println(failure);        }        System.out.println("运行测试用例总耗时(ms):" + result.getRunTime());        System.out.println("测试用例是否都成功了:" + result.wasSuccessful());     }}

为了方便大家理解代码的运行过程,代码中添加了很多日志输出,运行结果如下,结合代码和输出,理解很容易

initTestData()MathUtilsTest5构造器:TestData{testData=[1, 2, 3], expectedValue=3}721748895,maxTest():TestData{testData=[1, 2, 3], expectedValue=3}###################MathUtilsTest5构造器:TestData{testData=[100, 99, 80], expectedValue=100}463345942,maxTest():TestData{testData=[100, 99, 80], expectedValue=100}###################MathUtilsTest5构造器:TestData{testData=[30, -1, 100], expectedValue=100}195600860,maxTest():TestData{testData=[30, -1, 100], expectedValue=100}###################-----------------运行测试用例个数:3失败用例个数:0运行测试用例总耗时(ms):12测试用例是否都成功了:true

3、Spring集成junit

spring集成junit比较简单,下面我们来个案例感受一下。

3.1、加入maven配置

<dependency>    <groupId>org.springframework</groupId>    <artifactId>spring-test</artifactId>    <version>5.2.6.RELEASE</version></dependency><dependency>    <groupId>junit</groupId>    <artifactId>junit</artifactId>    <version>4.13</version></dependency>

3.2、来个spring的入口配置类

package com.javacode2018.springjunit; import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration; @Configurationpublic class MainConfig {    @Bean    public String name() {        return "路人甲java";    }     @Bean    public int age() {        return 30;    }}

3.3、来个junit测试类集成spring

下面我们来个测试类,对上面的MainConfig中注册的2个bean进行测试

package com.javacode2018.springjunit; import org.junit.Assert;import org.junit.Test;import org.junit.runner.RunWith;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.test.context.ContextConfiguration;import org.springframework.test.context.junit4.SpringRunner; @RunWith(SpringRunner.class) //@1@ContextConfiguration(classes = {MainConfig.class}) //@2public class MainConfigTest {     @Autowired    private String name;     @Autowired    private int age;     @Test    public void nameTest() {        System.out.println(this.name);        Assert.assertEquals("路人甲java", this.name);    }     @Test    public void ageTest() {        System.out.println(this.age);        Assert.assertEquals(30, this.age);    }}

注意上面的@1和@2的代码了,这就是spring集成junit的关键代码,@Runwith的值是org.springframework.test.context.junit4.SpringRunner,@ContextConfiguration注解通过classes属性指定spring启动类,如果是xml的方式,可以使用另外一个属性value或者locations来指定入口xml的位置。

上面代码中name和age属性上面都有@Autowired注解,这2个属性会被自动从spring容器中注入进来。

3.4、来个测试启动类

package com.javacode2018.springjunit; import org.junit.runner.JUnitCore;import org.junit.runner.Result;import org.junit.runner.notification.Failure; public class TestRunner {     public static void main(String[] args) {        Result result = JUnitCore.runClasses(MainConfigTest.class);        System.out.println("-----------------");        System.out.println("运行测试用例个数:" + result.getRunCount());        System.out.println("失败用例个数:" + result.getFailures().size());        for (Failure failure : result.getFailures()) {            System.out.println(failure);        }        System.out.println("运行测试用例总耗时(ms):" + result.getRunTime());        System.out.println("测试用例是否都成功了:" + result.wasSuccessful());     } }

运行输出

30路人甲java-----------------运行测试用例个数:2失败用例个数:0运行测试用例总耗时(ms):422测试用例是否都成功了:true

4、开发工具中使用junit

上面介绍的所有案例,都是通过main方法中用JUnitCore.runClasses来运行测试用例的,实际上有更简单的方式。

java的常用开发工具有eclipse和idea,这两个工具都将junit集成好了,通过开发工具集成的功能,运行测试用例更方便,不需要我们写JUnitCore.runClasses代码了。

我们来演示一下,如下图

点击1处的蓝色箭头,即可运行当前测试类中的所有用例,即2个测试方法,运行效果如下,左边显示了运行的测试用例列表,右边的显示了输出信息。

图中的2和3也可以点击,只会运行选中的那个测试方法,比如点击2,只会运行nameTest()这个用例,效果如下

5、总结

1、本文详细介绍了junit的用法,常用的注解有@Test、@BeforeClass、@AfterClass、@Before、@After、@Ignore、@RunWith,这些都要掌握

2、spring中集成junit,主要的配置就是在测试类上面需要加上下面代码

@RunWith(SpringRunner.class) //@1@ContextConfiguration(classes = {MainConfig.class}) //@2

3、开发工具中使用junit更容易

6、案例源码

git地址:https://gitee.com/javacode2018/spring-series 本文案例对应源码:    spring-series\lesson-008-junit    spring-series\lesson-008-springjunit

大家star一下,所有系列代码都会在这个里面,还有所有原创文章的链接也在里面,方便查阅!!!

原文链接:https://itsoku.blog.csdn.net/article/details/110675698

本文暂时没有评论,来添加一个吧(●'◡'●)

欢迎 发表评论:

最近发表
标签列表