JUnit4在Eclipse中的使用

测试是项目开发中很重要的一环。实际上,建议的项目前期编写过程是:构思-> 编写单元测试代码-> 编写接口->编写实现类-> 测试实现类->编写主类...。JUnit是一个使用广泛的、用于编写和运行可重复的测试的Java测试框架。这里不多介绍背景,直接说用法了。

1.JUnit测试用例的创建

首先,在pom.xml(Maven)中添加依赖:

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    <scope>test</scope>
</dependency>

然后,在src/test/java下的包中新建>JUnit测试用例,在下图所示界面中选择“新建JUnit4测试”(1),填写类名(2)和要测试的类(3),选择要创建的方法存根(4),点击下一步:

 

这里介绍一下可选的方法存根(4):

  • setUpBeforClass():注解@BeforeClass,在运行测试类的最开始运行一次,用作测试准备(读取文件、链接数据库等)。
  • tearDownAfterClass():注解@AfterClass,在运行测试类的最后运行一次,用作测试清理(释放资源)。
  • setUp():注解@Befor,在运行每个要测试方法前运行,有多少个要测试的方法就运行多少次,用作测试方法准备。
  • tearDown():注解@After,在运行每个要测试方法后运行,有多少个要测试的方法就运行多少次,用作测试方法清理。

最后,选择要测试的方法,点击完成:

在生成的测试类中,会对每个选中的方法生成一个测试方法(testXxx)。如果选中了“创建终态方法存根”,则生成的测试方法都带有final修饰符;如果选中了“为生成的测试方法创建任务”,则生成的测试方法中都会出现//TODO标识。

 

2.测试类的编写

(1)JUnit4中的注解

  • @BeforeClass:该方法在所有测试方法运行之前,运行一次。方法必须是public static void。
  • @AfterClass:该方法在所有测试方法运行完毕后,运行一次。方法必须是public static void。
  • @Before:该方法在每个@Test运行之前都要运行。方法必须是public void。
  • @After:该方法在每个@Test运行之后都要运行。方法必须是public void。
  • @Test:表示该方法是测试方法。方法必须是public void。@Test可以有两个参数:expected,timeout,分别对应异常测试和超时测试。
  • @Ignore:对测试类或@Test测试方法使用,表示暂时忽略该测试。JUnit执行结果会报告忽略数量。

通过步骤1生成的测试类,会在setUpBeforeClass、tearDownAfterClass、setUp、tearDown、testXxx方法前自动添加相应注解。

(2)Assert类

Assert类是JUnit中提供的一个工具类,这个类中有大量的静态方法进行断言的处理。在各测试方法中,在调用要测试的方法后,通过Assert类中的方法判断运行结果是否符合预期。

一般为了方便使用Assert类中的静态方法,在测试类中对Assert类中的方法进行静态导入:

import static org.junit.Assert.*;

这里简单介绍几种Assert类中的常见方法(细节详见Assert(JUnit API)):

  • assertArrayEquals((错误信息,)预期结果数组,测试结果数组):断言测试结果数组与预期结果数组相等。如果不相等,抛出AssertionError,表示测试未通过。如果存在信息参数,则抛出带指定信息的AssertionError。
  • assertEquals((错误信息,)预期结果,测试结果):断言测试结果==预期结果。如果不相等,处理方式同上。
  • assertNotEquals((错误信息,)不期望的结果,测试结果):断言测试结果不等于不期望的结果。如果相等,处理方式同上。
  • assertNull((错误信息,)Object):断言对象为空。如果不为空,处理方式同上。
  • assertNotNull((错误信息,)Object):断言对象不为空。如果为空,处理方式同上。
  • assertSame((错误信息,)期望Object,测试Object):断言测试Object和期望Object引用了同一对象。如果引用了不同对象,处理方式同上。
  • assertNotSame((错误信息,)不期望的Object,测试Object):断言测试Object引用的不是不期望的Object。如果引用同一对象,处理方式同上。
  • assertTrue((错误信息,)boolean):断言判定条件(boolean)为true。如果为false,处理方式同上。
  • assertFalse((错误信息,)boolean):断言判定条件(boolean)为false。如果为true,处理方式同上。
  • assertThat((错误信息,)结果参数T,Matcher<? super T>):断言结果参数满足Matcher的条件。如果不满足,抛出带有Matcher和结果信息的AssertionError。如果存在信息参数,则抛出的AssertionError还带有错误信息。
  • fail((识别信息)):使测试不通过。如果存在信息参数,则为测试不通过加上识别信息。

当比较对象为double或float时,应加上对应类型的delta参数,即:判定比较对象相等时的最大误差。

(3)测试方法的编写

对于每个测试方法,一般都是先调用要测试的方法,然后通过Assert中的方法,判断测试结果是否符合预期。

对于每个要测试的方法,可以有3个测试方法:运行结果测试、异常测试、性能测试。三者的功能分别是测试指定方法运行结果是否符合预期、有问题时是否能正确抛出异常、能否在限定时间内完成运行,参数分别是@Test、@Test(expected=XxxException.class)、@Test(timeout=xxx)。可以根据实际需求,选择编写其中的1~3个测试方法。

注意,每个test方法中最好只测试被测类中的一种方法,尽量不要在一个test方法中调用两个以上的被测方法。

节选示例:测试向数据库添加学生信息的addStu方法和通过专业学号查询数据的query...方法。

被测试方法:

    public StudentDAOImpl() {
        // TODO 自动生成的构造函数存根
        apc = new ClassPathXmlApplicationContext("applicationContext.xml");
        jdbcTemplate = (JdbcTemplate) apc.getBean("jdbcTemplate");
    }

    public boolean addStu(Student stu) {
        // TODO 自动生成的方法存根
        String name = stu.getName(), major = stu.getMajor();
        int jnshuId = stu.getJnshuId();
        if (name==null || major==null || jnshuId==0) {
            throw new RuntimeException("姓名、专业、学号不能为空!");
        }
        String sql = "INSERT INTO students (name,qq,major,entrytime,gra_school,id_jnshu"
                + ",daily_url,desire,bro_jnshu,knowfrom) VALUES (?,?,?,?,?,?,?,?,?,?)";
        int line = jdbcTemplate.update(sql,new Object[] {
                name,stu.getQq(),major,stu.getEntryTime(),
                stu.getSchool(),jnshuId,stu.getDailyUrl(),stu.getDesire(),
                stu.getJnshuBro(),stu.getKnowFrom()});
        return line>0?true:false;
    }

    public Student queryStuByJnshu(String major, int jnshuId) {
        // TODO 自动生成的方法存根
        String sql = "SELECT id,create_at,update_at,name,qq,major,entrytime,gra_school,id_jnshu" + 
                ",daily_url,desire,bro_jnshu,knowfrom FROM students WHERE id_jnshu=? and major=?";
        Student stu = null;
        try {
            stu = jdbcTemplate.queryForObject(sql, new QueryStuRowMapper(),new Object[]{jnshuId,major});
        } catch (EmptyResultDataAccessException e) {
            // TODO 此处可做更复杂的提示动作,比如抛出异常、记录到本地文件、显示到GUI等。
            System.out.println("该学生不存在!");
        }
        return stu;
    }

其中,QueryStuRowMapper代码如下:

package cn.cage.student;

import java.sql.ResultSet;
import java.sql.SQLException;
import org.springframework.jdbc.core.RowMapper;

public class QueryStuRowMapper implements RowMapper<Student> {
    /**
     * 直接使用此类建立的对象时,sql语句应查询Student的所有属性。*/
    public Student mapRow(ResultSet rs, int rowNum) throws SQLException {
        // TODO 自动生成的方法存根
        Student stu = new Student(rs.getString("name"), rs.getString("major"), rs.getInt("id_jnshu"));
        stu.setId(rs.getLong("id"));
        stu.setCreateTime(rs.getLong("create_at"));
        stu.setUpdateTime(rs.getLong("update_at"));
        stu.setQq(rs.getString("qq"));
        // TODO 此处根据测试结果(时间格式)看是否需要修改
        stu.setEntryTime(rs.getDate("entrytime").toString());
        stu.setSchool(rs.getString("gra_school"));
        stu.setDailyUrl(rs.getString("daily_url"));
        stu.setDesire(rs.getString("desire"));
        stu.setJnshuBro(rs.getString("bro_jnshu"));
        stu.setKnowFrom(rs.getString("knowfrom"));
        return stu;
    }
}

测试方法:

    @BeforeClass
    public static void setUpBeforeClass() throws Exception {
        stuDao = new StudentDAOImpl();
    }
    
    @AfterClass
    public static void tearDownAfterClass() throws Exception {
        stuDao = null;
    }

    @Test
    public void testAddStu() {
        Student stu = new Student("王五", "Java后端工程师", 1470);
        assertTrue("插入失败!",stuDao.addStu(stu));
    } 

    @Test
    public void testQueryStuByJnshu() {
        Student stu = new Student("王五", "Java后端工程师", 1470);
        Student actual = stuDao.queryStuByJnshu("Java后端工程师", 1470);
        assertEquals("插入错误,或查询方法(byJnshu)有问题!",stu, actual);
    }

3.运行测试

编写完测试类和被测试类后,在测试类上右键>运行方式>JUnit测试即可。

注意:运行测试的顺序并非是按照函数的先后顺序!如果要修改运行测试的顺序,可以在class上加注解:@FixMethodOrder(*)。可以选择的参数有:

  • MethodSorters.DEFAULT:默认顺序,不可预测但固定的顺序(每次顺序都相同)。
  • MethodSorters.JVM:测试方法执行顺序为JVM返回的顺序,不固定的顺序(每次顺序可能不同)
  • MethodSorters.NAME_ASCENDING:按测试方法名(字典顺序)升序执行。(如果是自定义顺序,推荐这种)

虽然可以改变测试顺序,但一个好的测试类不应该依赖于测试顺序!

示例测试结果:

 

插入成功,但查询结果与插入值不同。

找到原因,是Student类中没有equals函数,所以assertEquals比较的是查询结果与插入值是否引用了同一个对象。修改后测试通过。

posted @ 2017-08-08 15:14  花火·  阅读(682)  评论(0编辑  收藏  举报