package org.junit.rules;
import org.junit.internal.AssumptionViolatedException;
import org.junit.runners.model.FrameworkMethod;
import org.junit.runners.model.Statement;
/**
* TestWatchman is a base class for Rules that take note of the testing
* action, without modifying it. For example, this class will keep a log of each
* passing and failing test:
*
* <pre>
* public static class WatchmanTest {
* private static String watchedLog;
*
* @Rule
* public MethodRule watchman= new TestWatchman() {
* @Override
* public void failed(Throwable e, FrameworkMethod method) {
* watchedLog+= method.getName() + " " + e.getClass().getSimpleName()
* + " ";
* }
*
* @Override
* public void succeeded(FrameworkMethod method) {
* watchedLog+= method.getName() + " " + "success! ";
* }
* };
*
* @Test
* public void fails() {
* fail();
* }
*
* @Test
* public void succeeds() {
* }
* }
* </pre>
*
* @since 4.7
* @deprecated Use {@link TestWatcher} (which implements {@link TestRule}) instead.
*/
@Deprecated
public class TestWatchman implements MethodRule {
public Statement apply(final Statement base, final FrameworkMethod method,
Object target) {
return new Statement() {
@Override
public void evaluate() throws Throwable {
starting(method);
try {
base.evaluate();
succeeded(method);
} catch (AssumptionViolatedException e) {
throw e;
} catch (Throwable e) {
failed(e, method);
throw e;
} finally {
finished(method);
}
}
};
}
/**
* Invoked when a test method succeeds
*/
public void succeeded(FrameworkMethod method) {
}
/**
* Invoked when a test method fails
*/
public void failed(Throwable e, FrameworkMethod method) {
}
/**
* Invoked when a test method is about to start
*/
public void starting(FrameworkMethod method) {
}
/**
* Invoked when a test method finishes (whether passing or failing)
*/
public void finished(FrameworkMethod method) {
}
}