junit源码学习--运行测试的过程

找到textui/TestRunner.java，看到了阔别很久的main方法，OK，开始运行测试。

TestRunner.java

/**
* 运行自身的start方法，并将返回结果提交给容器

*/

public static void main(String args[]) {
TestRunner aTestRunner= new TestRunner();
try {
TestResult r= aTestRunner.start(args);
if (!r.wasSuccessful())
System.exit(FAILURE_EXIT);
System.exit(SUCCESS_EXIT);
} catch(Exception e) {
System.err.println(e.getMessage());
System.exit(EXCEPTION_EXIT);
}
}

/**
* Starts a test run. Analyzes the command line arguments and runs the given
* test suite.解析传入参数，并根据参数运行对应的方法
*/

public TestResult start(String args[]) throws Exception {
String testCase= "";
String method= "";
boolean wait= false;

for (int i= 0; i < args.length; i++) {

//以下这一段if else看着真扎眼，不过考虑到这一段基本不扩展，而且也不会复用，也就这样吧

//根据传入参数获取运行的testCase类名和method方法名
if (args[i].equals("-wait"))
wait= true;
else if (args[i].equals("-c"))
testCase= extractClassName(args[++i]);
else if (args[i].equals("-m")) {
String arg= args[++i];
int lastIndex= arg.lastIndexOf('.');
testCase= arg.substring(0, lastIndex);
method= arg.substring(lastIndex + 1);
} else if (args[i].equals("-v"))
System.err.println("JUnit " + Version.id() + " by Kent Beck and Erich Gamma");
else
testCase= args[i];
}

if (testCase.equals(""))
throw new Exception("Usage: TestRunner [-wait] testCaseName, where name is the name of the TestCase class");

try {
if (!method.equals("")) //方法名不为空
return runSingleMethod(testCase, method, wait);
Test suite= getTest(testCase);//方法名为空
return doRun(suite, wait);
} catch (Exception e) {
throw new Exception("Could not create and run test suite: " + e);
}
}

当方法名不为空时，进入runSingleMethod方法

protected TestResult runSingleMethod(String testCase, String method, boolean wait) throws Exception {
Class<? extends TestCase> testClass= loadSuiteClass(testCase);//根据类名获取具体类，如果不是TestCase的子类，则抛

//出ClassNotFoundException
Test test= TestSuite.createTest(testClass, method);//在TestSuite中通过反射获取到对应的类实例
return doRun(test, wait);//运行本地doRun()方法，将获取的类实例作为参数传入
}

进入doRun(Test suite,boolean wait)方法，实际运行测试方法

public TestResult doRun(Test suite, boolean wait) {
TestResult result= createTestResult();//获取新的TestResult实例
result.addListener(fPrinter);
long startTime= System.currentTimeMillis();
suite.run(result);//实际运行测试方法
long endTime= System.currentTimeMillis();
long runTime= endTime-startTime;
fPrinter.print(result, runTime);

pause(wait);
return result;
}

OK，运行至此，实际的测试方法已经运行完成了。其中，最关键的点就是判断类是否为TestCase的子类，然后通过反射获取类的实例，保证了运行方法绝对是TestCase的run。