public class

TestWatchman

extends Object
implements MethodRule
java.lang.Object
   ↳ org.junit.rules.TestWatchman
Known Direct Subclasses

Class Overview

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() {
 	}
 }

Summary

Public Constructors
TestWatchman()
Public Methods
Statement apply(Statement base, FrameworkMethod method, Object target)
Modifies the method-running Statement to implement an additional test-running rule.
void failed(Throwable e, FrameworkMethod method)
Invoked when a test method fails
void finished(FrameworkMethod method)
Invoked when a test method finishes (whether passing or failing)
void starting(FrameworkMethod method)
Invoked when a test method is about to start
void succeeded(FrameworkMethod method)
Invoked when a test method succeeds
[Expand]
Inherited Methods
From class java.lang.Object
From interface org.junit.rules.MethodRule

Public Constructors

public TestWatchman ()

Public Methods

public Statement apply (Statement base, FrameworkMethod method, Object target)

Modifies the method-running Statement to implement an additional test-running rule.

Parameters
base The Statement to be modified
method The method to be run
target The object on with the method will be run.
Returns
  • a new statement, which may be the same as base, a wrapper around base, or a completely new Statement.

public void failed (Throwable e, FrameworkMethod method)

Invoked when a test method fails

public void finished (FrameworkMethod method)

Invoked when a test method finishes (whether passing or failing)

public void starting (FrameworkMethod method)

Invoked when a test method is about to start

public void succeeded (FrameworkMethod method)

Invoked when a test method succeeds