com.nordstrom.automation.junit.RunWatcher Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of junit-foundation Show documentation

This is the foundation framework for JUnit automation

There is a newer version: 17.1.1

package com.nordstrom.automation.junit;

import org.junit.internal.AssumptionViolatedException;

/**
 * This interface defines the methods implemented by JUnit run watchers.
 */
public interface RunWatcher extends TypeDiscloser, JUnitWatcher {

    /**
     * Called when an atomic test is about to be started.
     *
     * @param atomicTest {@link AtomicTest} object for this atomic test
     */
    public void testStarted(AtomicTest atomicTest);

    /**
     * Called when an atomic test has finished, whether the test succeeds or fails.
     *
     * @param atomicTest {@link AtomicTest} object for this atomic test
     */
    public void testFinished(AtomicTest atomicTest);
    
    /**
     * Called when an atomic test fails.
     * 
     * @param atomicTest {@link AtomicTest} object for this atomic test
     * @param thrown exception thrown by method
     */
    public void testFailure(AtomicTest atomicTest, Throwable thrown);

    /**
     * Called when an atomic test flags that it assumes a condition that is false
     * 
     * @param atomicTest {@link AtomicTest} object for this atomic test
     * @param thrown {@link AssumptionViolatedException} thrown by method
     */
    public void testAssumptionFailure(AtomicTest atomicTest, AssumptionViolatedException thrown);
    
    /**
     * Called when a test will not be run, generally because a test method is annotated with {@link org.junit.Ignore}.
     * 
     * @param atomicTest {@link AtomicTest} object for this atomic test
     */
    public void testIgnored(AtomicTest atomicTest);
}