How do I run JUnit tests from inside my Java application?

Yes, you can. I was doing it couple of times to run diagnostic/smoke tests in production systems. This is a snippet of key part of the code invoking JUnit:

JUnitCore junit = new JUnitCore();
Result result = junit.run(testClasses);

DON’T use JUnit.main inside your application, it invokes System.exit after tests are finished and thus it may stop JVM process.

You may want to capture JUnit’s “regular” console output (the dots and simple report). This can be easily done by registering TextListener (this class provides this simple report).

Please also be aware of several complications using this kind of method:

  1. Testing of any “test framework”, including so small one, although is quite simple may be confusing. For example if you want to test if your “test framework” return failure result when one of the tests fails you could (should?) create sample JUnit test that always fails and execute that test with the “test framework”. In this case failing test case is actually test data and shouldn’t be executed as “normal” JUnit. For an example of such tests you can refer to JUnit’s internal test cases.

  2. If you want to prepare / display your custom report you should rather register your own RunListener, because Result returned by JUnit doesn’t contain (directly) information about passed tests and test method (it is only “hardcoded” as a part of test Description).

Leave a Comment