|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.junit.rules.RuleChain
public class RuleChain
The RuleChain can be used for creating composite rules. You create a
RuleChain with outerRule(TestRule) and subsequent calls of
around(TestRule):
public abstract class CompositeRules {
public static TestRule extendedLogging() {
return RuleChain.outerRule(new LoggingRule("outer rule"))
.around(new LoggingRule("middle rule"))
.around(new LoggingRule("inner rule"));
}
}
public class UseRuleChain {
@Rule
public final TestRule extendedLogging = CompositeRules.extendedLogging();
@Test
public void example() {
assertTrue(true);
}
}
writes the log
starting outer rule starting middle rule starting inner rule finished inner rule finished middle rule finished outer ruleIn older versions of JUnit (before 4.13)
RuleChain was used for
ordering rules. We recommend to not use it for this purpose anymore. You can
use the attribute order of the annotation Rule
or ClassRule for ordering rules.
Rule.order(),
ClassRule.order()| Method Summary | |
|---|---|
Statement |
apply(Statement base,
Description description)
Modifies the method-running Statement to implement this
test-running rule. |
RuleChain |
around(TestRule enclosedRule)
Create a new RuleChain, which encloses the given TestRule with
the rules of the current RuleChain. |
static RuleChain |
emptyRuleChain()
Returns a RuleChain without a TestRule. |
static RuleChain |
outerRule(TestRule outerRule)
Returns a RuleChain with a single TestRule. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
|---|
public static RuleChain emptyRuleChain()
RuleChain without a TestRule. This method may
be the starting point of a RuleChain.
RuleChain without a TestRule.public static RuleChain outerRule(TestRule outerRule)
RuleChain with a single TestRule. This method
is the usual starting point of a RuleChain.
outerRule - the outer rule of the RuleChain.
RuleChain with a single TestRule.public RuleChain around(TestRule enclosedRule)
RuleChain, which encloses the given TestRule with
the rules of the current RuleChain.
enclosedRule - the rule to enclose; must not be null.
RuleChain.
NullPointerException - if the argument enclosedRule is null
public Statement apply(Statement base,
Description description)
Statement to implement this
test-running rule.
apply in interface TestRulebase - The Statement to be modifieddescription - A Description of the test implemented in base
base,
a wrapper around base, or a completely new Statement.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||