Package org.junit.experimental.theories
Class Theories
- java.lang.Object
-
- org.junit.runner.Runner
-
- org.junit.runners.ParentRunner<FrameworkMethod>
-
- org.junit.runners.BlockJUnit4ClassRunner
-
- org.junit.experimental.theories.Theories
-
- All Implemented Interfaces:
Describable
,Filterable
,Sortable
public class Theories extends BlockJUnit4ClassRunner
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Theories.TheoryAnchor
-
Constructor Summary
Constructors Constructor Description Theories(java.lang.Class<?> klass)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
collectInitializationErrors(java.util.List<java.lang.Throwable> errors)
Adds toerrors
a throwable for each problem noted with the test class (available fromParentRunner.getTestClass()
).protected java.util.List<FrameworkMethod>
computeTestMethods()
Returns the methods that run tests.Statement
methodBlock(FrameworkMethod method)
Returns a Statement that, when executed, either returns normally ifmethod
passes, or throws an exception ifmethod
fails.protected void
validateConstructor(java.util.List<java.lang.Throwable> errors)
Adds toerrors
if the test class has more than one constructor, or if the constructor takes parameters.protected void
validateTestMethods(java.util.List<java.lang.Throwable> errors)
Adds toerrors
for each method annotated with@Test
that is not a public, void instance method with no arguments.-
Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner
createTest, describeChild, getChildren, getTestRules, methodInvoker, possiblyExpectingExceptions, rules, runChild, testName, validateFields, validateInstanceMethods, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateZeroArgConstructor, withAfters, withBefores, withPotentialTimeout
-
Methods inherited from class org.junit.runners.ParentRunner
childrenInvoker, classBlock, classRules, filter, getDescription, getName, getRunnerAnnotations, getTestClass, run, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods, withAfterClasses, withBeforeClasses
-
-
-
-
Constructor Detail
-
Theories
public Theories(java.lang.Class<?> klass) throws InitializationError
- Throws:
InitializationError
-
-
Method Detail
-
collectInitializationErrors
protected void collectInitializationErrors(java.util.List<java.lang.Throwable> errors)
Description copied from class:ParentRunner
Adds toerrors
a throwable for each problem noted with the test class (available fromParentRunner.getTestClass()
). Default implementation adds an error for each method annotated with@BeforeClass
or@AfterClass
that is notpublic static void
with no arguments.- Overrides:
collectInitializationErrors
in classBlockJUnit4ClassRunner
-
validateConstructor
protected void validateConstructor(java.util.List<java.lang.Throwable> errors)
Description copied from class:BlockJUnit4ClassRunner
Adds toerrors
if the test class has more than one constructor, or if the constructor takes parameters. Override if a subclass requires different validation rules.- Overrides:
validateConstructor
in classBlockJUnit4ClassRunner
-
validateTestMethods
protected void validateTestMethods(java.util.List<java.lang.Throwable> errors)
Description copied from class:BlockJUnit4ClassRunner
Adds toerrors
for each method annotated with@Test
that is not a public, void instance method with no arguments.- Overrides:
validateTestMethods
in classBlockJUnit4ClassRunner
-
computeTestMethods
protected java.util.List<FrameworkMethod> computeTestMethods()
Description copied from class:BlockJUnit4ClassRunner
Returns the methods that run tests. Default implementation returns all methods annotated with@Test
on this class and superclasses that are not overridden.- Overrides:
computeTestMethods
in classBlockJUnit4ClassRunner
-
methodBlock
public Statement methodBlock(FrameworkMethod method)
Description copied from class:BlockJUnit4ClassRunner
Returns a Statement that, when executed, either returns normally ifmethod
passes, or throws an exception ifmethod
fails. Here is an outline of the default implementation:- Invoke
method
on the result ofcreateTest()
, and throw any exceptions thrown by either operation. - HOWEVER, if
method
's@Test
annotation has theexpecting
attribute, return normally only if the previous step threw an exception of the correct type, and throw an exception otherwise. - HOWEVER, if
method
's@Test
annotation has thetimeout
attribute, throw an exception if the previous step takes more than the specified number of milliseconds. - ALWAYS run all non-overridden
@Before
methods on this class and superclasses before any of the previous steps; if any throws an Exception, stop execution and pass the exception on. - ALWAYS run all non-overridden
@After
methods on this class and superclasses after any of the previous steps; all After methods are always executed: exceptions thrown by previous steps are combined, if necessary, with exceptions from After methods into aMultipleFailureException
. - ALWAYS allow
@Rule
fields to modify the execution of the above steps. ARule
may prevent all execution of the above steps, or add additional behavior before and after, or modify thrown exceptions. For more information, seeTestRule
- Overrides:
methodBlock
in classBlockJUnit4ClassRunner
- Invoke
-
-