Junit4参数化测试实现程序与用例数据分离

http://touchfu.iteye.com/blog/732930

现状：你是不是还在为自己的TestCase代码杂乱无章而苦恼，咎其根本还在于针对不同的用例，输入参数和mock信息的组装全部作为你的程序代码分布在各个单元测试程序中。

  期望：因此为了让测试程序更加优雅的显示作为code的本质，我们需要把输入参数和mock内容与程序本身尽可能的达到松耦合的布局，即程序归程序，用例数据归用例数据。

  如何：我们怎么来完成这样的一个分离动作呢，下面讲讲本人实现的基本思路。利用JUNIT4中的参数化测试为基础，通过解析文件来初始化参数信息，并对用例提供注销控制。

  下面我们着重介绍下实现BaseTestCase.

@RunWith(Parameterized.class)
@ContextConfiguration(locations = {"XXX.xml"})
public class BaseTestCase extends AbstractJUnit4SpringContextTests{
    /** 用例ID */
    protected String                     caseId;
    /** 描述 */
    protected String                     description;
    /** 期望值 */
    protected String                     expectValue;
    /** 测试上下文管理 */
    private final TestContextManager     testContextManager;

    public BaseTestCase(){
        this.testContextManager = new TestContextManager(getClass());
        this.caseId = caseId;
        this.description = description;
        this.expectValue = expectValue;
    }

    /**
     * 依靠<code>DependencyInjectionTestExecutionListener<code>完成注入上下文信息
     * @throws Throwable
     */
    @Before
    public void injectDependencies() throws Throwable {
        this.testContextManager.prepareTestInstance(this);
    }

    /**
     * 获取用例数据
     * @param caseFilePath
     * @return
     */
    protected static Collection<String[]> loadCaseData(String caseFilePath) {
        if (StringUtil.isBlank(caseFilePath)) {
            throw new IllegalArgumentException("未初始化用例文件信息");
        }
        List<String[]> caseDataList = FileParser.loadItems("cases/" + caseFilePath);
        if (CollectionUtils.isEmpty(caseDataList)) {
            throw new IllegalArgumentException("准备数据不能为空");
        }
        // 剔除第一行标题信息
        caseDataList.remove(0);

        return caseDataList;
    }
}

 由于在自己基类使用的runner为Parameterized，与使用SpringJUnit4ClassRunner的不同在于少了自动对测试上下文进行依赖注入关联，因此我们需要自己手工触发完成，大家在类源码里可以注意到这一点。主要还是依赖于DependencyInjectionTestExecutionListener完成。同时由于测试基类集成了AbstractJUnit4SpringContextTests了，在此类的源码里可以看到两个关键点DependencyInjectionTestExecutionListener和其中的ApplicationContext，因此我们在子类里不需要再自己写什么上下文的属性，也不需要再添加依赖注入的执行监听器。

  下面再看下FileParser的实现

/**
 * <p>文件解析器</p>
 * @author Eric.fu
 */
public class FileParser {
    /** 分隔符 */
    private static final String SPLIT_TAG  = ",";
    /** 忽略标记 */
    private static final String IGNORE_TAG = "#";

    /**
     * 获取文件内容
     * @param filePath
     * @return
     */
    public static List<String[]> loadItems(String filePath) {
        List<String[]> itemList = new ArrayList<String[]>();
        ClassPathResource resource = new ClassPathResource(".");
        BufferedReader reader = null;
        try {
            String path = resource.getFile().getAbsolutePath();
            File file = new File(path + "/META-INF/" + filePath);
            reader = new BufferedReader(new FileReader(file));

            String tempString = null;
            // 一次读入一行，直到读入空为文件结束
            while (StringUtil.isNotBlank(tempString = reader.readLine())) {
                if (tempString.indexOf(IGNORE_TAG) == 0) {
                    continue;
                }
                itemList.add(tempString.split(SPLIT_TAG));
            }
            reader.close();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            if (reader != null) {
                try {
                    reader.close();
                } catch (IOException e1) {
                }
            }
        }

        return itemList;
    }
}

 此类为相当普通的一段读文件的代码，这里有个特殊点在于加了一个忽略标记，用于注释用例数据，即把不跑的数据暂时注释掉，不作为读入参数。

  下面再来看下一个简单的测试子类实现

public class SubTestCase extends BaseTestCase {
    /** 测试请求 */
    protected String            request;
    /**
     * 构造入款支付清算
     */
    public SubTestCase(String caseId, String description, String expectValue, String request){
        super(caseId, description, expectValue);
        this.request = request;
    }

    @Parameters
    public static Collection<String[]> caseData() {
        return loadCaseData("case.csv");
    }

    /**
     * 执行
     */
    @Test
    public void execute() {
        Assert.notNull(request);
    }
}

在子类里通过构造方法初始化参数，参数数据来源为case.csv文件。

文件格式为caseId,description,expectValue,request

本文主要介绍的利用JUNIT4中的参数化测试来完成程序与测试数据的分离，当然如果你用的testNG，则可以用更优雅的provider来完成此项工作。在测试用例中除了让数据与程序分离还是不够的，还需要将mock部分也分离出去，这样才能更好的达到扩展的效果。