Eclipse JDT
Release 3.3

org.eclipse.jdt.junit
Class TestRunListener

java.lang.Object
  extended byorg.eclipse.jdt.junit.TestRunListener

public abstract class TestRunListener
extends Object

A test run listener that can be registered at JUnitCore.addTestRunListener(TestRunListener).

A test run starts with the call to sessionStarted(ITestRunSession) followed by calls to testCaseStarted(ITestCaseElement) and testCaseFinished(ITestCaseElement) for all test cases contained in the tree.

A test run session is ended with the call to sessionFinished(ITestRunSession). After that call, no references must be kept to the session or any of the test cases or suites.

Since:
3.3

Constructor Summary
TestRunListener()
           
 
Method Summary
 void sessionFinished(ITestRunSession session)
          A test run session has finished.
 void sessionStarted(ITestRunSession session)
          A test run session has started.
 void testCaseFinished(ITestCaseElement testCaseElement)
          A test case has ended.
 void testCaseStarted(ITestCaseElement testCaseElement)
          A test case has started.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TestRunListener

public TestRunListener()
Method Detail

sessionStarted

public void sessionStarted(ITestRunSession session)
A test run session has started. The test tree can be accessed through the session element.

Important: The implementor of this method must not keep a reference to the session element longer after sessionFinished(ITestRunSession) has finished.

Parameters:
session - the session that has just started.

sessionFinished

public void sessionFinished(ITestRunSession session)
A test run session has finished. The test tree can be accessed through the session element.

Important: The implementor of this method must not keep the session element when the method is finished.

Parameters:
session - the test

testCaseStarted

public void testCaseStarted(ITestCaseElement testCaseElement)
A test case has started. The result can be accessed from the element.

Important: The implementor of this method must not keep a reference to the test case element after sessionFinished(ITestRunSession) has finished.

Parameters:
testCaseElement - the test that has started to run

testCaseFinished

public void testCaseFinished(ITestCaseElement testCaseElement)
A test case has ended. The result can be accessed from the element.

Important: The implementor of this method must not keep a reference to the test case element after sessionFinished(ITestRunSession) has finished.

Parameters:
testCaseElement - the test that has finished running

Eclipse JDT
Release 3.3

Copyright (c) IBM Corp. and others 2000, 2007. All Rights Reserved.