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:
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()
                 + "\n";
        }
     @Override
     public void succeeded(FrameworkMethod method) {
         watchedLog+= method.getName() + " " + "success!\n";
        }
    };
 @Test
 public void fails() {
     fail();
    }
 @Test
 public void succeeds() {
    }
}

Since:
4.7
Deprecated:
Use TestWatcher (which implements TestRule) instead./**
 * 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;
 *
 *  &#064;Rule
 *  public MethodRule watchman= new TestWatchman() {
 *      &#064;Override
 *      public void failed(Throwable e, FrameworkMethod method) {
 *          watchedLog+= method.getName() + &quot; &quot; + e.getClass().getSimpleName()
 *                  + &quot;\n&quot;;
 *         }
 *
 *      &#064;Override
 *      public void succeeded(FrameworkMethod method) {
 *          watchedLog+= method.getName() + &quot; &quot; + &quot;success!\n&quot;;
 *         }
 *     };
 *
 *  &#064;Test
 *  public void fails() {
 *      fail();
 *     }
 *
 *  &#064;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
/**
     * Invoked when a test method succeeds
     */
    public void succeeded(FrameworkMethod method) {
    }

    
Invoked when a test method fails
/**
     * Invoked when a test method fails
     */
    public void failed(Throwable e, FrameworkMethod method) {
    }

    
Invoked when a test method is about to start
/**
     * Invoked when a test method is about to start
     */
    public void starting(FrameworkMethod method) {
    }


    
Invoked when a test method finishes (whether passing or failing)
/**
     * Invoked when a test method finishes (whether passing or failing)
     */
    public void finished(FrameworkMethod method) {
    }
}