平常,我们大部分人使用Junit运行大测试代码, 都是通过通过IDE的界面手动运行,或者通过maven命令来运行的多. 这些方式对于使用来说很直观, 但是我们没法直接了解Junit的运行方式.
所以如果我们要研究源码学习Junit的话,最好结合我们的测试代码,先了解测试代码如果被调用.那么JUnitCore这个类,就是我们需要最新研究的类.按照我的理解,它是运行所有测试类的核心入口类. 以下请看例子.
首先,我们有一个常规的测试类:
public class HelloJunit { @Test public void helloTest(){ System.out.println("Hello Test"); } }
然后,我们可以通过JUnitCore类来执行调用这个测试类,达到运行它的目的:
public class JunitCoreDemo { public static void main(String[] args) { Result result = JUnitCore.runClasses(HelloJunit.class); System.out.println(result.getRunCount()); } }
这样我们可以看到测试类被成功地执行了.
通过以上很简单的例子,我们就可以开始我们的源码解读之旅了.
追踪JUnitCore的源代码进去,发现最终runClasses()方法调用到了run()方法, 它的参数是一个Runner
public Result run(Runner runner) { Result result = new Result(); RunListener listener = result.createListener(); notifier.addFirstListener(listener); try { notifier.fireTestRunStarted(runner.getDescription()); runner.run(notifier); notifier.fireTestRunFinished(result); } finally { removeListener(listener); } return result; }
以下是Runner的继承关系图:
其中较为重要的Runner有:
- Suite: JUnitCore.run()方法引用的就是一个Suite的实例
- BlockJUnit4ClassRunner: 默认的Junit runner, 可以继承它来扩展功能
再往回看代码:
- Runner是从request.getRunner()来的
-
然后它又是Computer类的getSuite()方法来的:
/** * Create a suite for {@code classes}, building Runners with {@code builder}. * Throws an InitializationError if Runner construction fails */ public Runner getSuite(final RunnerBuilder builder, Class<?>[] classes) throws InitializationError { return new Suite(new RunnerBuilder() { @Override public Runner runnerForClass(Class<?> testClass) throws Throwable { return getRunner(builder, testClass); } }, classes); }
Runner是一个Suite, 它包含了一个RunnerBuilder的匿名子类 - RunnerBuilder子类的runnerForClass()方法,可以根据builder.runnerForClass(testClass)来获取具体的Runer
- 再回看代码发现builder的值是 AllDefaultPossibilitiesBuilder的实例
AllDefaultPossibilitiesBuilder类的代码比较简单,但是非常重要.它的核心方法org.junit.internal.builders.AllDefaultPossibilitiesBuilder.runnerForClass(Class<?>)的作用就是根据传入的测试类.class返回该测试类的Runner, 它返回的Runner有:
- BlockJUnit4ClassRunner
- IgnoredClassRunner
- SuiteMethod
- JUnit38ClassRunner
- AnnotatedBuilder中取到的自定义Runner
这里值得一说有是AnnotatedBuilder, 如果某个测试类带上了@RunWith(MyTestRunner.class)注解,表明它需要通过MyTestRunner去运行,而不是默认的BlockJUnit4ClassRunner.
AnnotatedBuilder.runnerForClass(Class<?>)方法里可以看到获取自定义Runner的逻辑:
@Override public Runner runnerForClass(Class<?> testClass) throws Exception { for (Class<?> currentTestClass = testClass; currentTestClass != null; currentTestClass = getEnclosingClassForNonStaticMemberClass(currentTestClass)) { RunWith annotation = currentTestClass.getAnnotation(RunWith.class); if (annotation != null) { return buildRunner(annotation.value(), testClass); } } return null; }
首先,它获取了RunWIth的值, 然后在buildRunner中创建的Runner的实例, 这个是反射的最基本应用:
public Runner buildRunner(Class<? extends Runner> runnerClass, Class<?> testClass) throws Exception { try { return runnerClass.getConstructor(Class.class).newInstance(testClass); } catch (NoSuchMethodException e) { try { return runnerClass.getConstructor(Class.class, RunnerBuilder.class).newInstance(testClass, suiteBuilder); } catch (NoSuchMethodException e2) { String simpleName = runnerClass.getSimpleName(); throw new InitializationError(String.format( CONSTRUCTOR_ERROR_FORMAT, simpleName, simpleName)); } } }
到此位置JUnitCore的代码逻辑基本清楚了.再小结一下:
- JUnitCore最终运行的是JUnitCore.run(Runner)方法
- 1中的Runer是一个Suite, 它含有一个RunnerBuilder的匿名子类
- RunnerBuilder会根据runnerForClass()方法,取到测试类的真正的Runner
- JUnitCore.run()方法可以执行使用自定义Runner的测试类
下一节将介绍如何扩展具体的Runner,比如BlockJUnit4ClassRunner, 来增强Junit的功能
相关推荐
JUnit学习资料
中间有各种Junit文档,Junit各种操作手册!3.8--4.9。还有本人学习的笔记。绝对值得下载。
junit ppt 学习文档.ppt junit ppt 学习文档.ppt junit ppt 学习文档.ppt
junit4学习文档,有实例,非常详细,不懂的可以参考
junit 3,junit 4学习
JUnit是一款由Erich Gamma(《设计模式》的作者)和Kent Beck(极限编程的提出者)编写的开源的回归测试框架,供Java编码人员做单元测试之用。当前版本4.1,可以从www.junit.org网站上获得。与早期的JUnit 3相比,...
Junit学习笔记,希望有用~~~~~~~~~~~~~~~~~~~~~~
org.junit.runner.JUnitCore.class org.junit.runner.Request.class org.junit.runner.Result.class org.junit.runner.RunWith.class org.junit.runner.Runner.class org.junit.runner.manipulation.Filter.class ...
Junit学习资料
本文档和网络上的差不多,但加了一个自己写的示例,和一些心得,对于只要使用junit的人来说(主要是junit4) 本文档已经足够了,这个文档也是我对我们公司整个开发团队junit的培训文档。传上来给大家参考参考,有些...
Ant and JUnit 学习
JUnit学习笔记之NetBeans入门篇,一句话好东西
Junit学习笔记和课件,欢迎学习爱好者下载资源,共同学习。。
• JUnit 是一个开放的资源框架,用于编写和运行测试。 • 提供注释来识别测试方法。 • 提供断言来测试预期结果。 • 提供测试运行来运行测试。 • JUnit 测试允许你编写代码更快,并能提高质量。 • JUnit 优雅...
包括JUnit.in.Action中文版.pdf,JUnit详解.pdf,Manning - JUnit in Action.pdf,单元测试之道Java版:使用JUnit.pdf以及Junit设计模式分析(Junit设计模式分析.pdf及源码实例),是学习JUnit不可多得的资料。
JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage,包含依赖包:junit-jupiter-5.5.1.jar,junit-jupiter-engine-5.5.1.jar,junit-jupiter-params-5.5.1.jar,junit-platform-launcher-1.5.1.jar,junit-...
junit ppt 学习文档,详细junit介绍,深入浅出
JUnit学习笔记及练习用例,主要分为JUnit3.8.2和JUnit4.8.1两个版本。
NULL 博文链接:https://greatjone.iteye.com/blog/1161009
junit4.1junit4.1junit4.1junit4.1junit4.1