当前位置:首页 > 开发 > 编程语言 > 编程 > 正文

探索JUnit4扩展:深入Rule

发表于: 2014-09-23   作者:bijian1013   来源:转载   浏览:
摘要:         本文将进一步探究Rule的应用,展示如何使用Rule来替代@BeforeClass,@AfterClass,@Before和@After的功能。         在上一篇中提到,可以使用Rule替代现有的大部分Runner扩展,而且也不提倡对Runner中的withBefores(),withAfte

        本文将进一步探究Rule的应用,展示如何使用Rule来替代@BeforeClass,@AfterClass,@Before和@After的功能。

        在上一篇中提到,可以使用Rule替代现有的大部分Runner扩展,而且也不提倡对Runner中的withBefores(),withAfters()等方法进行扩展。本文将介绍如何使用Rule去实现@Before,@After和@BeforeClass的相同功能。

1. BaseRule

        首先要创建一个较通用的TestRule实现BaseRule,它会释放出两个扩展点,一个在执行测试方法之前,before();另一个在执行测试方法之后after()。下面是该类的代码:

package com.bijian.study;

import org.junit.rules.TestRule;
import org.junit.runner.Description;
import org.junit.runners.model.Statement;

public abstract class BaseRule implements TestRule {
	 
    @Override
    public Statement apply(Statement base, Description description) {
        return new RuleStatement(base, description);
    }
 
    private class RuleStatement extends Statement {
 
        private Statement base = null;
 
        private Description description = null;
 
        private RuleStatement(Statement base, Description description) {
            this.base = base;
            this.description = description;
        }
 
        @Override
        public void evaluate() throws Throwable {
            before(base, description);
            try {
                base.evaluate();
            } finally {
                after(base, description);
            }
        }
    }
 
    protected void before(Statement base, Description description) throws Throwable {
 
    }
 
    protected void after(Statement base, Description description) {
 
    }
}

        如果对JUnit4的源代码略有认知,可能会发现BaseRule与JUnit4提供的TestRule实现ExternalResource代码相似。关键的不同之处是,BaseRule中的before()与after()方法都提供了Statement与Description类型的参数,这使得它能够完成更复杂的工作。

 

2. CalculatorTest

        本文使用的CalculatorTest将不使用@BeforeClass,@Before和@After,而会创建两个BaseRule的实例:一个用于替代@BeforeClass和@AfterClass(本系列目前还未使用过@AfterClass),另一个则替代@Before和@After。

package com.bijian.study;

import java.text.DateFormat;
import java.text.SimpleDateFormat;
import java.util.Date;

import org.junit.Assert;
import org.junit.ClassRule;
import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.Description;
import org.junit.runners.model.Statement;

public class CalculatorTest {
	 
    private static final DateFormat format = new SimpleDateFormat("yyyy-MM-dd_HH:mm:ss_SSS");
 
    private static Calculator calculator = null;
 
    @ClassRule
    public static BaseRule classRule = new BaseRule() {
 
        protected void before(Statement base, Description description) throws Throwable {
            calculator = new Calculator();
        };
    };
 
    @Rule
    public BaseRule rule = new BaseRule() {
 
        protected void before(Statement base, Description description) throws Throwable {
            printBeforeLog(description);
        };
 
        protected void after(Statement base, Description description) {
            printAfterLog(description);
        };
 
        private void printBeforeLog(Description description) {
            TestLogger testLogger = description.getAnnotation(TestLogger.class);
            if (testLogger != null) {
                StringBuilder log = new StringBuilder(format.format(new Date()));
                log.append(" ").append(description.getClassName()).append("#")
                        .append(description.getMethodName()).append(": ")
                        .append(testLogger.log());
                System.out.println(log.toString());
            }
        }
 
        private void printAfterLog(Description description) {
            StringBuilder log = new StringBuilder(format.format(new Date()));
            log.append(" ").append(description.getClassName()).append("#")
                    .append(description.getMethodName()).append(" end");
            System.out.println(log.toString());
        }
    };
 
    @Test
    @TestLogger(log = "a simple division")
    public void simpleDivide() {
        int value = calculator.divide(8, 2);
        Assert.assertTrue(value == 4);
    }
 
    @Test(expected = ArithmeticException.class)
    @TestLogger(log = "divided by zero, and an ArithmeticException thrown.")
    public void dividedByZero() {
        calculator.divide(8, 0);
    }
}

        值得注意的是,classRule是静态变量,它使用@ClassRule Annotation,将替代@BeforeClass和@AfterClass;而rule是成员变量,它使用@Rule Annotation,将替代@Before和@After。与之前文章不同的是,此处不仅会在执行测试方法之前打印指定内容的日志(printBeforeLog()),还会在执行测试方法之后打印一条固定格式的日志(printAfterLog()),用于指示该测试方法已经执行完毕了。执行结果如下所示:

2014-09-24_00:05:41_375 com.bijian.study.CalculatorTest#simpleDivide: a simple division
2014-09-24_00:05:41_375 com.bijian.study.CalculatorTest#simpleDivide end
2014-09-24_00:05:41_375 com.bijian.study.CalculatorTest#dividedByZero: divided by zero, and an ArithmeticException thrown.
2014-09-24_00:05:41_375 com.bijian.study.CalculatorTest#dividedByZero end

 

3. 小结

        使用Rule可以替代绝大部分的Runner扩展,而且特定的Rule实现可以被复用,也易于添加或移除Rule实例,这些都大大地提高了灵活性。值得注意地是,本文虽然使用Rule代替了@BeforeClass,@AfterClass,@Before和@After的功能,但并不意味着就应当这么做。就我个人的看法,将传统的Fixture功能交由@BeforeClass,@AfterClass,@Before和@After实现,仍然是一种不错的选择。

 

文章来源:http://www.blogjava.net/jiangshachina/archive/2012/01/04/367802.html

探索JUnit4扩展:深入Rule

  • 0

    开心

    开心

  • 0

    板砖

    板砖

  • 0

    感动

    感动

  • 0

    有用

    有用

  • 0

    疑问

    疑问

  • 0

    难过

    难过

  • 0

    无聊

    无聊

  • 0

    震惊

    震惊

编辑推荐
@Rule是JUnit4的新特性。利用@Rule我们可以扩展JUnit的功能,在执行case的时候加入测试者特有的操作
透视投影是3D固定流水线的重要组成部分,是将相机空间中的点从视锥体(frustum)变换到规则观察体(Can
深入探索透视投影变换 引用自:原文(作者:Twinsen) -Twinsen编写 -本人水平有限,疏忽错误在所难免
深入探索透视投影变换 -Twinsen编写 -本人水平有限,疏忽错误在所难免,还请各位数学高手、编程高手
深入探索透视投影变换 最近更新:2013年11月22日 -Twinsen编写 -本人水平有限,疏忽错误在所难免,
透视投影是3D固定流水线的重要组成部分,是将相机空间中的点从视锥体(frustum)变换到规则观察体(Can
最近做WIN32 API开发时发现对ScrollWindow的一些工作原理并不是太清楚,于是做了相关研究,记载下来
透视投影是3D固定流水线的重要组成部分,是将相机空间中的点从视锥体(frustum)变换到规则观察体(Can
在JUnit4.7之前用户要扩展JUnit通常采用继承BlockJUnit4ClassRunner的方式,然后在BaseTestCase中通
在上一篇文章中给出了JUnit4.8中如何使用Rule对JUnit进行扩展,在JUnit4.8中存在一个问题就是不能够
版权所有 IT知识库 CopyRight © 2009-2015 IT知识库 IT610.com , All Rights Reserved. 京ICP备09083238号