探索JUnit4扩展:扩展Runner

在使用JUnit的过程中,大家可能会对JUnit进行一些扩展。本文中的示例为JUnit4定义了一个新的Annotation,并相应地对已有的Runner进行扩展,使其能够解析新引入的Annotation。(2011.12.25***更新)

创新互联公司自2013年起,是专业互联网技术服务公司,拥有项目成都做网站、成都网站制作网站策划,项目实施与项目整合能力。我们以让每一个梦想脱颖而出为使命,1280元新吴做网站,已为上家服务,为新吴各地企业和个人服务,联系电话:18982081108

本文臆造了一个示例,会在执行单元测试方法之前,自动地为单元测试方法打印日志。该示例会为JUnit定义一个新的Annotation用于指定要打印的日志内容,并对JUnit默认提供的Runner实现BlockJUnit4ClassRunner进行扩展,使其能够识别这个新的Annotation。

1. 定义Annotation

TestLogger是一个作用于方法的Annotation,它只有一个属性,用于指定日志的内容,其代码如下所示,

 
 
 
  1. @Target({ ElementType.METHOD })  
  2. @Retention(RetentionPolicy.RUNTIME)  
  3. public @interface TestLogger {  
  4. public String log() default "";  

2. 扩展Runner

JUnit提供了若干个Runner的实现,如BlockJUnit4ClassRunner,Suite,其中BlockJUnit4ClassRunner用来执行单个测试用例类。LoggedRunner将扩展BlockJUnit4ClassRunner,覆写其中的methodBlock()方法。新的methodBlock()方法会在一开始试图获取被执行测试方法中的TestLogger Annotation,如果存在的话,就会打印出指定的日志,每行日志以当时的执行时间与完整方法名作为前缀。该类的代码如下所示,

 
 
 
  1. public class LoggedRunner extends BlockJUnit4ClassRunner {  
  2.  
  3. private static final DateFormat format = new SimpleDateFormat("yyyy-MM-dd_HH:mm:ss_SSS");  
  4.  
  5. public LoggedRunner(Class klass) throws InitializationError {  
  6. super(klass);  
  7. }  
  8.  
  9. @Override 
  10. protected Statement methodBlock(FrameworkMethod method) {  
  11. Method classMethod = method.getMethod();  
  12. TestLogger loggerAnnotation = classMethod.getAnnotation(TestLogger.class);  
  13. if (loggerAnnotation != null) {  
  14. StringBuilder log = new StringBuilder(format.format(new Date()));  
  15. log.append(" ").append(classMethod.getDeclaringClass().getName())  
  16. .append("#").append(classMethod.getName()).append(": ")  
  17. .append(loggerAnnotation.log());  
  18. System.out.println(log.toString());  
  19. }  
  20. return super.methodBlock(method);  
  21. }  

3. 应用程序

Calculator是一个简单的应用程序,其中定义了一个除法方法,代码如下所示,

 
 
 
  1. public class Calculator {  
  2. public int divide(int a, int b) {  
  3. return a / b;  
  4. }  

4. 单元测试程序

CalculatorTest是一个简单的单元测试程序,它会使用两种方式对Calculator中的divide()方法进行单元测试。其代码如下所示,

 
 
 
  1. @RunWith(LoggedRunner.class)  
  2. public class CalculatorTest {  
  3.  
  4. private static Calculator calculator = null;  
  5.  
  6. @BeforeClass 
  7. public static void createCalculator() {  
  8. calculator = new Calculator();  
  9. }  
  10.  
  11. @Test 
  12. @TestLogger(log = "a simple division.")  
  13. public void simpleDivide() {  
  14. int value = calculator.divide(8, 2);  
  15. Assert.assertTrue(value == 4);  
  16. }  
  17.  
  18. @Test(expected = ArithmeticException.class)  
  19. @TestLogger(log = "divided by zero, and an ArithmeticException thrown.")  
  20. public void dividedByZero() {  
  21. calculator.divide(8, 0);  
  22. }  

值得注意的是,CalculatorTest特别指定LoggedRunner作为测试执行器(@RunWith(LoggedRunner.class));同时,每个单元测试方法,simpleDivide()与dividedByZero(),都使用了Annotation TestLogger,为其指定日志内容。当执行上述单元测试时,会自动地打印出如下形式的日志内容:

2011-12-13_23:48:38_218 test.CalculatorTest#simpleDivide: a simple division
2011-12-13_23:48:38_218 test.CalculatorTest#dividedByZero: divided by zero, and an ArithmeticException thrown.

5. 小结

通过对BlockJUnit4ClassRunner的扩展,可以让JUnit在运行测试用例时做一些额外的工作。但这种直接修改默认Test Runner的方式并不被提倡,在下一篇文章中将会介绍使用Test Rule来达到相同的扩展目的。

原文链接:http://www.blogjava.net/jiangshachina/archive/2011/12/14/366289.html

当前文章:探索JUnit4扩展:扩展Runner
文章URL:http://www.shufengxianlan.com/qtweb/news41/530591.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联