Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Refactoring Suite, Parameterized and class runners to allow reuse in custom Runners #1348

Open
wants to merge 13 commits into
base: main
Choose a base branch
from
Open

Refactoring Suite, Parameterized and class runners to allow reuse in custom Runners #1348

Changes from 1 commit
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
06bbb4e
Converted useful object methods to class methods for later reuse
PeterWippermann Jul 7, 2016
1f04d9d
extracted new helper methods; moved helper methods from nested
PeterWippermann Jul 8, 2016
d4e9cf4
extracted getNamePatternForParameters()
PeterWippermann Jul 8, 2016
d3d5f9c
renamed getAnnotatedClasses() to getSuiteClasses() and made it public
PeterWippermann Jul 8, 2016
59bd461
minor improvement of variable name
Jul 18, 2016
60ee694
Extracted further methods as static for reuse in other Runners
Jul 18, 2016
0e9d515
Methods for TestRules are now publicly available
Jul 18, 2016
6964310
Minor change to fix "@param name not found" error on Travis CI
Jul 19, 2016
0f4704a
methods related to annotation processing are now protected inst. methods
Jul 21, 2016
ff3d035
Introduced ParameterizedTestClass to encapsulate annotation processing
Jul 22, 2016
43ab75e
withClassStatements() combines @BeforeClass, @AfterClass and @ClassRule
Jul 22, 2016
dca431f
converted line delimiters to unix
PeterWippermann Jul 25, 2016
0c1d4d5
converted line delimiters to unix
PeterWippermann Jul 25, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
20 changes: 8 additions & 12 deletions src/main/java/org/junit/runners/ParentRunner.java
View file
Open in desktop
Expand Up @@ -189,9 +189,9 @@ private void validateClassRules(List<Throwable> errors) {
protected Statement classBlock(final RunNotifier notifier) {
Statement statement = childrenInvoker(notifier);
if (!areAllChildrenIgnored()) {
statement = withBeforeClasses(statement, testClass);
statement = withAfterClasses(statement, testClass);
statement = withClassRules(statement, testClass, getDescription());
statement = withBeforeClasses(statement);
statement = withAfterClasses(statement);
statement = withClassRules(statement, getDescription());
}
return statement;
}
Expand All @@ -209,9 +209,8 @@ private boolean areAllChildrenIgnored() {
* Returns a {@link Statement}: run all non-overridden {@code @BeforeClass} methods on this class
* and superclasses before executing {@code statement}; if any throws an
* Exception, stop execution and pass the exception on.
* @param testClass
*/
public static Statement withBeforeClasses(Statement statement, TestClass testClass) {
protected Statement withBeforeClasses(Statement statement) {
Copy link
Member

@kcooney kcooney Jul 21, 2016 •
edited

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Curious why you want to call these directly vs. calling classBlock(). If you cannot use classBlock() then perhaps instead of making these three protected we should extract one protected method that calls all three so 1) your runner isn't hard-coding the order and 2) we can add more calls in the future (ex withClassFixtures()). Perhaps call the new method withClassStatements()

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like your proposal to introduce withClassStatements(). I also had something like this in mind before, but didn't brought it to an end. I will incorporate it now.

I'd like to propose to leave withBeforeClasses(...) (and the others) protected anyway. But the documentation should encourage to use withClassStatements().

I can't call ParentRunner.classBlock(...) in my custom Runner because between invoking the children and applying the class statements, I'd like to apply @TestRules. ParentRunner doesn't support these.

        Statement statement = childrenInvoker(notifier);

        List<TestRule> testRules = BlockJUnit4ClassRunner.getTestRules(testInstance, getTestClass());
        statement = BlockJUnit4ClassRunner.withTestRules(testRules, getDescription(), statement);

        statement = withClassStatements(statement);
        return statement;

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@PeterWippermann I don't understand what you mean by "I can't call ParentRunner.classBlock(...) in my custom Runner because between invoking the children and applying the class statements, I'd like to apply @testrules". The method withClassRules() applies all of the rules annotated with @ClassRule. You shouldn't invoke rules annotated with TestRule in ParentRunner because there is no instance of the class.

List<FrameworkMethod> befores = testClass
.getAnnotatedMethods(BeforeClass.class);
return befores.isEmpty() ? statement :
Expand All @@ -224,9 +223,8 @@ public static Statement withBeforeClasses(Statement statement, TestClass testCla
* always executed: exceptions thrown by previous steps are combined, if
* necessary, with exceptions from AfterClass methods into a
* {@link org.junit.runners.model.MultipleFailureException}.
* @param testClass
*/
public static Statement withAfterClasses(Statement statement, TestClass testClass) {
protected Statement withAfterClasses(Statement statement) {
List<FrameworkMethod> afters = testClass
.getAnnotatedMethods(AfterClass.class);
return afters.isEmpty() ? statement :
Expand All @@ -239,23 +237,21 @@ public static Statement withAfterClasses(Statement statement, TestClass testClas
* annotated with {@link ClassRule}.
*
* @param statement the base statement
* @param testClass
* @param description the description to pass to the {@link Rule}s
* @return a RunRules statement if any class-level {@link Rule}s are
* found, or the base statement
*/
public static Statement withClassRules(Statement statement, TestClass testClass, Description description) {
List<TestRule> classRules = classRules(testClass);
protected Statement withClassRules(Statement statement, Description description) {
List<TestRule> classRules = classRules();
return classRules.isEmpty() ? statement :
new RunRules(statement, classRules, description);
}

/**
* @param testClass
* @return the {@code ClassRule}s that can transform the block that runs
* each method in the tested class.
*/
protected static List<TestRule> classRules(TestClass testClass) {
protected List<TestRule> classRules() {
List<TestRule> result = testClass.getAnnotatedMethodValues(null, ClassRule.class, TestRule.class);
result.addAll(testClass.getAnnotatedFieldValues(null, ClassRule.class, TestRule.class));
return result;
Expand Down