赖赖的博客

07 Spring 单元测试(融合 Junit,轻松入门)

转载请注明来源 赖赖的博客

导语

学习,先知骨架,再丰羽翼,先知其然,再知其所以然。

要迅速解决问题,首先要有一个自己的框架知识库,例如,我知道Tomcat可以搭建web服务器,我知道Spring MVC可以构件web项目,我知道Mybatis可以控制持久层…
这些是需要了解并且记在脑中的,至于详细的东西,等用的时候可以详细了解,此博客专题连载的Spring系列,就是送你一套框架知识库
今天介绍单元测试,简单实例,让你知其然。

实例

项目工程目录结构和代码获取地址

获取地址(版本Log将会注明每一个版本对应的课程)

https://github.com/laiyijie/SpringLearning

目录结构

目录结构

运行工程(与之前不同,请注意)

运行方式  
  • 右键HelloInterFaceTest.java
  • Run as
  • JUnit Test
运行结果

init before every testcase
the 10 time to say userHello
clean after every testcase
init before every testcase
time:1480420925632 userHello
clean after every testcase

项目详解

从HelloInterFaceTest.java入手(终于不是四行代码的App.java啦)

HelloInterFaceTest.java

package me.laiyijie.demo.service;

import org.junit.After;
import org.junit.Before;
import org.junit.FixMethodOrder;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.MethodSorters;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import static org.junit.Assert.*;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration({ "classpath:root-context.xml" })
@FixMethodOrder(MethodSorters.NAME_ASCENDING)
public class HelloInterFaceTest {

    @Autowired
    private HelloInterface helloInterface;

    @Before
    public void init() {
        System.out.println("init before every testcase");
    }

    @After
    public void after() {
        System.out.println("clean after every testcase");
    }

    @Test
    public void TS0101_sayHello_normal() {

        int num = 10;

        String result = helloInterface.sayHello(num);

        System.out.println(result);

        String expect = "the " + num + " time to say userHello";

        assertEquals(expect, result);
    }

    @Test
    public void TS0201_sayHelloWithTime_normal() {

        String result = helloInterface.sayHelloWithTime();

        System.out.println(result);
    }
}  

代码有点儿长?莫慌,长代码,一个套路,那就是叠砖!让我们仔细看看这块砖

JUnit测试用例执行过程概述

首先略过头部,直接看类里面的方法,其中两个函数分别被@Before@After注解,两个函数被@Test注解。
我们仔细看一下运行结果可以发现几个函数的执行顺序如下所示:

  1. @Before 注解的函数先执行
  2. @Test 注解的TS0101_sayHello_normal执行
  3. @After 注解的函数执行
  4. @Before 注解的函数先执行
  5. @Test 注解的TS0201_sayHelloWithTime_normal执行
  6. @After 注解的函数执行

那么显而易见的结论:

  • @Test注释的函数会挨个执行(我们称这个函数为测试用例
  • @Before注解的函数会在每个@Test注解的函数之 执行(我们使用这个注解进行测试用例前的初始化)
  • @After 注解的函数会在每个@Test注解的函数之 执行(我们使用这个注解进行测试用例后的清理)

下面详细解读其余部分:

import先略过,只是一些依赖

之后从类前面的注解开始讲解

Spring测试类前注解含义(启动Spring测试环境)
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration({ "classpath:root-context.xml" })
@FixMethodOrder(MethodSorters.NAME_ASCENDING)
  • @RunWith(SpringJUnit4ClassRunner.class) 提供了一个Spring的运行环境,说白了,就是可以在测试类中使用@Autowired等Spring注解,例如代码中的private HelloInterface helloInterface;就是使用@Autowired来注入,你完全可以理解为是@Service
  • @ContextConfiguration({ "classpath:root-context.xml" }) 加载了root-context.xml(加载了才可以注入 UserServiceImpl实例嘛
  • @FixMethodOrder(MethodSorters.NAME_ASCENDING) 根据用例的函数名称升序执行用例(很实用,但是非必须)

OK,三个注解解决了Spring+JUnit单元测试环境的配置。

JUnit的三个注解,加上Spring Test环境的配置,测试用例就此简单起步。
而在测试用例中,我们肯定不能通过System.out.println输出到控制台来进行判断(肉眼判断输出是否正确,很容易出现失误)
在此我简单的介绍使用Assert类提供的方法判断输出是否正确

##### assertequals,跟肉眼say goodbye

我们摘出这段代码:

@Test
public void TS0101_sayHello_normal() {

    int num = 10;

    String result = helloInterface.sayHello(num);

    System.out.println(result);

    String expect = "the " + num + " time to say userHello";

    assertEquals(expect, result);
}  

其中这句话:

assertEquals(expect, result);

就这么简单,第一参数为期望输出第二个参数为真实结果

  • 如果两者相等(equals),用例通过(JUnit测试条为绿色)

    测试成功

  • 如果两者不等,用例失败(JUnit测试条为红色)

    测试成功

pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>me.laiyijie</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <dependencies>

        <!-- https://mvnrepository.com/artifact/org.springframework/spring-context -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>4.3.2.RELEASE</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.springframework/spring-test -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>4.3.2.RELEASE</version>
            <scope>test</scope>
        </dependency>
        <!-- Test -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

    </dependencies>
</project>

新增两个Scope为test的依赖,分别是

  • spring-test 提供@RunWith中的 SpringJUnit4ClassRunner.class 以及 @ContextConfiguration
  • junit 提供@RunWith@After@Before@Test

小结:

  • JUnit运行过程
    • 通过@RunWith(SpringJUnit4ClassRunner.class)@ContextConfiguration({ "classpath:root-context.xml" })配置Spring单元测试环境,使得
      1. 加载root-context.xml配置的ApplicationContext
      2. 使得HelloInterFaceTest(测试类)可以使用@Autowired装载容器中的bean
    • 通过@Before实现测试用例运行前初始化
    • 通过@Test定义测试用例并且挨个执行
    • 通过@After实现测试用例完成后清理

测试用例这么好写,何不多写几个?你的代码稳定性会提升一个层次!