简介: 通过本文,您能够在较短的时间内掌握使用 Spring 单元测试框架测试基于 Spring 的应用程序的方法,这套方法主要涵盖如何使用 Spring 测试注释来进行常见的 Junit4 或者 TestNG 的单元测试,同时支持访问 Spring 的 beanFactory 和进行自动化的事务管理。
概述
单元测试和集成测试在我们的软件开发整个流程中占有举足轻重的地位,一方面,程序员通过编写单元测试来验证自己程序的有效性,另外一方面,管理者通过持续自动的执行单元测试和分析单元测试的覆盖率等来确保软件本身的质量。这里,我们先不谈单元测试本身的重要性,对于目前大多数的基于 Java 的企业应用软件来说,Spring 已经成为了标准配置,一方面它实现了程序之间的低耦合度,另外也通过一些配置减少了企业软件集成的工作量,例如和 Hibernate、Struts 等的集成。那么,有个问题,在普遍使用 Spring 的应用程序中,我们如何去做单元测试?或者说,我们怎么样能高效的在 Spring 生态系统中实现各种单元测试手段?这就是本文章要告诉大家的事情。
单元测试目前主要的框架包括 Junit、TestNG,还有些 MOCK 框架,例如 Jmock、Easymock、PowerMock 等,这些都是单元测试的利器,但是当把他们用在 Spring 的开发环境中,还是那么高效么?还好,Spring 提供了单元测试的强大支持,主要特性包括:
通过阅读本文,您能够快速的掌握基于 Spring TestContext 框架的测试方法,并了解基本的实现原理。本文将提供大量测试标签的使用方法,通过这些标签,开发人员能够极大的减少编码工作量。OK,现在让我们开始 Spring 的测试之旅吧!
原来我们是怎么做的
这里先展示一个基于 Junit 的单元测试,这个单元测试运行在基于 Spring 的应用程序中,需要使用 Spring 的相关配置文件来进行测试。相关类图如下:
数据库表
假设有一个员工账号表,保存了员工的基本账号信息,表结构如下:
假设表已经建好,且内容为空。
测试工程目录结构和依赖 jar 包
在 Eclipse 中,我们可以展开工程目录结构,看到如下图所示的工程目录结构和依赖的 jar 包列表:
您需要引入的 jar 包括:
其中的 hsqldb 是我们测试用数据库。
图 1. 工程目录结构
类总体介绍
假设我们现在有一个基于 Spring 的应用程序,除了 MVC 层,还包括业务层和数据访问层,业务层有一个类 AccountService,负责处理账号类的业务,其依赖于数据访问层 AccountDao 类,此类提供了基于 Spring Jdbc Template 实现的数据库访问方法,AccountService 和 AccountDao 以及他们之间的依赖关系都是通过 Spring 配置文件进行管理的。
现在我们要对 AccountService 类进行测试,在不使用 Spring 测试方法之前,我们需要这样做:
清单 1. Account.Java
此类代表账号的基本信息,提供 getter 和 setter 方法。
- package domain;
- public class Account {
- public static final String SEX_MALE = "male";
- public static final String SEX_FEMALE = "female";
- private int id;
- private String name;
- private int age;
- private String sex;
- public String toString() {
- return String.format("Account[id=%d,name=%s,age:%d,sex:%s]",id,name,age,sex);
- }
- public int getId() {
- return id;
- }
- public void setId(int id) {
- this.id = id;
- }
- public String getName() {
- return name;
- }
- public void setName(String name) {
- this.name = name;
- }
- public int getAge() {
- return age;
- }
- public void setAge(int age) {
- this.age = age;
- }
- public String getSex() {
- return sex;
- }
- public void setSex(String sex) {
- this.sex = sex;
- }
- public static Account getAccount(int id,String name,int age,String sex) {
- Account acct = new Account();
- acct.setId(id);
- acct.setName(name);
- acct.setAge(age);
- acct.setSex(sex);
- return acct;
- }
- }
注意上面的 Account 类有一个 toString() 方法和一个静态的 getAccount 方法,getAccount 方法用于快速获取 Account 测试对象。
清单 2. AccountDao.Java
这个 DAO 我们这里为了简单起见,采用 Spring Jdbc Template 来实现。
- package DAO;
- import Java.sql.ResultSet;
- import Java.sql.SQLException;
- import Java.util.HashMap;
- import Java.util.List;
- import Java.util.Map;
- import org.Springframework.context.ApplicationContext;
- import org.Springframework.context.support.ClassPathXmlApplicationContext;
- import org.Springframework.jdbc.core.RowMapper;
- import org.Springframework.jdbc.core.namedparam.NamedParameterJdbcDaoSupport;
- import org.Springframework.jdbc.core.simple.ParameterizedRowMapper;
- import domain.Account;
- public class AccountDao extends NamedParameterJdbcDaoSupport {
- public void saveAccount(Account account) {
- String sql = "insert into tbl_account(id,name,age,sex) " +
- "values(:id,:name,:age,:sex)";
- Map paramMap = new HashMap();
- paramMap.put("id", account.getId());
- paramMap.put("name", account.getName());
- paramMap.put("age", account.getAge());
- paramMap.put("sex",account.getSex());
- getNamedParameterJdbcTemplate().update(sql, paramMap);
- }
- public Account getAccountById(int id) {
- String sql = "select id,name,age,sex from tbl_account where id=:id";
- Map paramMap = new HashMap();
- paramMap.put("id", id);
- List
matches = getNamedParameterJdbcTemplate().query(sql, - paramMap,new ParameterizedRowMapper
() { - @Override
- public Account mapRow(ResultSet rs, int rowNum)
- throws SQLException {
- Account a = new Account();
- a.setId(rs.getInt(1));
- a.setName(rs.getString(2));
- a.setAge(rs.getInt(3));
- a.setSex(rs.getString(4));
- return a;
- }
- });
- return matches.size()>0?matches.get(0):null;
- }
- }
AccountDao 定义了几个账号对象的数据库访问方法:
#p#
清单 3. AccountService.Java
- package service;
- import org.apache.commons.logging.Log;
- import org.apache.commons.logging.LogFactory;
- import org.Springframework.beans.factory.annotation.Autowired;
- import DAO.AccountDao;
- import domain.Account;
- public class AccountService {
- private static final Log log = LogFactory.getLog(AccountService.class);
- @Autowired
- private AccountDao accountDao;
- public Account getAccountById(int id) {
- return accountDao.getAccountById(id);
- }
- public void insertIfNotExist(Account account) {
- Account acct = accountDao.getAccountById(account.getId());
- if(acct==null) {
- log.debug("No "+account+" found,would insert it.");
- accountDao.saveAccount(account);
- }
- acct = null;
- }
- }
AccountService 包括下列方法:
其依赖的 DAO 对象 accountDao 是通过 Spring 注释标签 @Autowired 自动注入的。
清单 4. Spring 配置文件
上述几个类的依赖关系是通过 Spring 进行管理的,配置文件如下:
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:context="http://www.Springframework.org/schema/context"
- xsi:schemaLocation="http://www.Springframework.org/schema/beans
- http://www.Springframework.org/schema/beans/Spring-beans-3.0.xsd
- http://www.Springframework.org/schema/context
- http://www.Springframework.org/schema/context/Spring-context-3.0.xsd ">
注意其中的“
另外还有一个要注意的地方,就是 datasource 的定义,由于我们使用的是 Spring Jdbc Template,所以只要定义一个 org.Springframework.jdbc.datasource.DriverManagerDataSource 类型的 datasource 即可。这里我们使用了简单的数据库 HSQL、Single Server 运行模式,通过 JDBC 进行访问。实际测试中,大家可以选择 Oracle 或者 DB2、Mysql 等。
好,万事具备,下面我们来用 Junit4 框架测试 accountService 类。代码如下:
清单 5. AccountServiceOldTest.Java
- package service;
- import static org.Junit.Assert.assertEquals;
- import org.Junit.BeforeClass;
- import org.Junit.Test;
- import org.Springframework.context.ApplicationContext;
- import org.Springframework.context.support.ClassPathXmlApplicationContext;
- import domain.Account;
- public class AccountServiceOldTest {
- private static AccountService service;
- @BeforeClass
- public static void init() {
- ApplicationContext
- context = new ClassPathXmlApplicationContext("config/Spring-db-old.xml");
- service = (AccountService)context.getBean("accountService");
- }
- @Test
- public void testGetAcccountById() {
- Account acct = Account.getAccount(1, "user01", 18, "M");
- Account acct2 = null;
- try {
- service.insertIfNotExist(acct);
- acct2 = service.getAccountById(1);
- assertEquals(acct, acct2);
- } catch (Exception ex) {
- fail(ex.getMessage());
- } finally {
- service.removeAccount(acct);
- }
- }
- }
注意上面的 Junit4 注释标签,***个注释标签 @BeforeClass,用来执行整个测试类需要一次性初始化的环境,这里我们用 Spring 的 ClassPathXmlApplicationContext 从 XML 文件中加载了上面定义的 Spring 配置文件,并从中获得了 accountService 的实例。第二个注释标签 @Test 用来进行实际的测试。
测试过程:我们先获取一个 Account 实例对象,然后通过 service bean 插入数据库中,然后通过 getAccountById 方法从数据库再查询这个记录,如果能获取,则判断两者的相等性;如果相同,则表示测试成功。成功后,我们尝试删除这个记录,以利于下一个测试的进行,这里我们用了 try-catch-finally 来保证账号信息会被清除。
执行测试:(在 Eclipse 中,右键选择 AccountServiceOldTest 类,点击 Run as Junit test 选项),得到的结果如下:
执行测试的结果
在 Eclipse 的 Junit 视图中,我们可以看到如下的结果:
图 2. 测试的结果
对于这种不使用 Spring test 框架进行的单元测试,我们注意到,需要做这些工作:
另外,在这个测试类中,我们还不能使用 Spring 的依赖注入特性。一切都靠手工编码实现。好,那么我们看看 Spring test 框架能做到什么。
首先我们修改一下 Spring 的 XML 配置文件,删除
清单 6. Spring-db1.xml
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://www.Springframework.org/schema/beans
- http://www.Springframework.org/schema/beans/Spring-beans-3.2.xsd">
- >
- >
其中的 transactionManager 是 Spring test 框架用来做事务管理的管理器。
清单 7. AccountServiceTest1.Java
- package service;
- import static org.Junit.Assert.assertEquals;
- 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.SpringJUnit4ClassRunner;
- import org.Springframework.transaction.annotation.Transactional;
- import domain.Account;
- @RunWith(SpringJUnit4ClassRunner.class)
- @ContextConfiguration("/config/Spring-db1.xml")
- @Transactional
- public class AccountServiceTest1 {
- @Autowired
- private AccountService service;
- @Test
- public void testGetAcccountById() {
- Account acct = Account.getAccount(1, "user01", 18, "M");
- service.insertIfNotExist(acct);
- Account acct2 = service.getAccountById(1);
- assertEquals(acct,acct2);
- }
- }
对这个类解释一下:
执行结果
在 Eclipse 的 Junit 视图中,我们可以看到如下的结果:
图 3. 执行结果
小结
如果您希望在 Spring 环境中进行单元测试,那么可以做如下配置:
另外您不再需要:
Spring 测试注释标签
我们已经看到利用 Spring test framework 来进行基于 Junit4 的单元测试是多么的简单,下面我们来看一下前面遇到的各种注释标签的一些可选用法。
@ContextConfiguration 和 @Configuration 的使用
刚才已经介绍过,可以输入 Spring xml 文件的位置,Spring test framework 会自动加载 XML 文件,得到 application context,当然也可以使用 Spring 3.0 新提供的特性 @Configuration,这个注释标签允许您用 Java 语言来定义 bean 实例,举个例子:
现在我们将前面定义的 Spring-db1.xml 进行修改,我们希望其中的三个 bean:initer、accountDao、accountService 通过配置类来定义,而不是 XML,则我们需要定义如下配置类:
注意:如果您想使用 @Configuration,请在 classpath 中加入 cglib 的 jar 包(cglib-nodep-2.2.3.jar),否则会报错。
#p#
清单 8. SpringDb2Config.Java
- package config;
- import org.Springframework.beans.factory.annotation.Autowired;
- import org.Springframework.context.annotation.Bean;
- import org.Springframework.context.annotation.Configuration;
- import org.Springframework.jdbc.datasource.DriverManagerDataSource;
- import service.AccountService;
- import service.Initializer;
- import DAO.AccountDao;
- @Configuration
- public class SpringDb2Config {
- private @Autowired DriverManagerDataSource datasource;
- @Bean
- public Initializer initer() {
- return new Initializer();
- }
- @Bean
- public AccountDao accountDao() {
- AccountDao DAO = new AccountDao();
- DAO.setDataSource(datasource);
- return DAO;
- }
- @Bean
- public AccountService accountService() {
- return new AccountService();
- }
- }
注意上面的注释标签:
注意,我们采用的是 XML+config bean 的方式进行配置,这种方式比较符合实际项目的情况。相关的 Spring 配置文件也要做变化,如下清单所示:
清单 9. Spring-db2.xml
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:context="http://www.Springframework.org/schema/context"
- xsi:schemaLocation="http://www.Springframework.org/schema/beans
- http://www.Springframework.org/schema/beans/Spring-beans-3.0.xsd
- http://www.Springframework.org/schema/context
- http://www.Springframework.org/schema/context/Spring-context-3.0.xsd">
- >
- >
注意里面的 context 命名空间的定义,如代码中黑体字所示。另外还必须有
现在有了这些配置,我们的测试类只要稍稍修改一下,即可实现加载配置类的效果,如下:
- @ContextConfiguration("/config/Spring-db2.xml")
通过上面的配置,测试用例就可以实现加载 Spring 配置类,运行结果也是成功的 green bar。
@DirtiesContext
缺省情况下,Spring 测试框架一旦加载 applicationContext 后,将一直缓存,不会改变,但是,
由于 Spring 允许在运行期修改 applicationContext 的定义,例如在运行期获取 applicationContext,然后调用 registerSingleton 方法来动态的注册新的 bean,这样的情况下,如果我们还使用 Spring 测试框架的被修改过 applicationContext,则会带来测试问题,我们必须能够在运行期重新加载 applicationContext,这个时候,我们可以在测试类或者方法上注释:@DirtiesContext,作用如下:
@TransactionConfiguration 和 @Rollback
缺省情况下,Spring 测试框架将事务管理委托到名为 transactionManager 的 bean 上,如果您的事务管理器不是这个名字,那需要指定 transactionManager 属性名称,还可以指定 defaultRollback 属性,缺省为 true,即所有的方法都 rollback,您可以指定为 false,这样,在一些需要 rollback 的方法,指定注释标签 @Rollback(true)即可。
对 Junit4 的注释标签支持
看了上面 Spring 测试框架的注释标签,我们来看看一些常见的基于 Junit4 的注释标签在 Spring 测试环境中的使用方法。
@Test(expected=…)
此注释标签的含义是,这是一个测试,期待一个异常的发生,期待的异常通过 xxx.class 标识。例如,我们修改 AccountService.Java 的 insertIfNotExist 方法,对于传入的参数如果为空,则抛出 IllegalArgumentException,如下:
- public void insertIfNotExist(Account account) {
- if(account==null)
- throw new IllegalArgumentException("account is null");
- Account acct = accountDao.getAccountById(account.getId());
- if(acct==null) {
- log.debug("No "+account+" found,would insert it.");
- accountDao.saveAccount(account);
- }
- acct = null;
- }
然后,在测试类中增加一个测试异常的方法,如下:
- @Test(expected=IllegalArgumentException.class)
- public void testInsertException() {
- service.insertIfNotExist(null);
- }
运行结果是 green bar。
@Test(timeout=…)
可以给测试方法指定超时时间(毫秒级别),当测试方法的执行时间超过此值,则失败。
比如在 AccountService 中增加如下方法:
- public void doSomeHugeJob() {
- try {
- Thread.sleep(2*1000);
- } catch (InterruptedException e) {
- }
- }
上述方法模拟任务执行时间 2 秒,则测试方法如下:
- @Test(timeout=3000)
- public void testHugeJob() {
- service.doSomeHugeJob();
- }
上述测试方法期待 service.doSomeHugeJob 方法能在 3 秒内结束,执行测试结果是 green bar。
@Repeat
通过 @Repeat,您可以轻松的多次执行测试用例,而不用自己写 for 循环,使用方法:
- @Repeat(3)
- @Test(expected=IllegalArgumentException.class)
- public void testInsertException() {
- service.insertIfNotExist(null);
- }
这样,testInsertException 就能被执行 3 次。
在测试类中基于 profile 加载测试 bean
从 Spring 3.2 以后,Spring 开始支持使用 @ActiveProfiles 来指定测试类加载的配置包,比如您的配置文件只有一个,但是需要兼容生产环境的配置和单元测试的配置,那么您可以使用 profile 的方式来定义 beans,如下:
清单 10. Spring-db.xml
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://www.Springframework.org/schema/beans
- http://www.Springframework.org/schema/beans/Spring-beans-3.2.xsd">
- >
- >
- >
分享标题:使用Spring进行单元测试
当前网址:http://www.shufengxianlan.com/qtweb/news9/313609.html网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联