net.thucydides.core.statistics
Class StatisticsListener

java.lang.Object
  net.thucydides.core.statistics.StatisticsListener

All Implemented Interfaces:

StepListener

public class StatisticsListener
extends Object
implements StepListener

Records test results in a database, for reporting on test statistics.

Constructor Summary

StatisticsListener(TestOutcomeHistoryDAO testOutcomeHistoryDAO, EnvironmentVariables environmentVariables, DatabaseConfig databaseConfig)

Method Summary

void	lastStepFailed(StepFailure failure) Declare that a step has failed after it has finished.
void	notifyScreenChange()
void	skippedStepStarted(ExecutedStepDescription description) Called when a test step is about to be started, but this step is scheduled to be skipped.
void	stepFailed(StepFailure failure) Called when a test step fails.
void	stepFinished() Called when an test step has finished successfully
void	stepIgnored() Called when a step will not be run, generally because a test method is annotated with Ignore.
void	stepIgnored(String message) The step is marked as ignored with a descriptive message.
void	stepPending() The step is marked as pending.
void	stepPending(String message) The step is marked as pending with a descriptive message.
void	stepStarted(ExecutedStepDescription description) Called when a test step is about to be started.
void	testFailed(TestOutcome result, Throwable cause) The test failed, but not while executing a step.
void	testFinished(TestOutcome result) Called when a test finishes.
void	testIgnored() The test as a whole was skipped or ignored.
void	testStarted(String description) A test with a given name has started.
void	testSuiteFinished() End of a test case or story.
void	testSuiteStarted(Class<?> storyClass) Start a test run using a test case or a user story.
void	testSuiteStarted(Story story) Start a test run using a specific story, without a corresponding Java class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StatisticsListener

@Inject
public StatisticsListener(TestOutcomeHistoryDAO testOutcomeHistoryDAO,
                                 EnvironmentVariables environmentVariables,
                                 DatabaseConfig databaseConfig)

Method Detail

testSuiteStarted

public void testSuiteStarted(Class<?> storyClass)

Description copied from interface: StepListener

Start a test run using a test case or a user story. For JUnit tests, the test case should be provided. The test case should be annotated with the Story annotation to indicate what user story it tests. Otherwise, the test case itself will be treated as a user story. For easyb stories, the story class can be provided directly.

Specified by:

testSuiteStarted in interface StepListener

testSuiteStarted

public void testSuiteStarted(Story story)

Description copied from interface: StepListener

Start a test run using a specific story, without a corresponding Java class.

Specified by:

testSuiteStarted in interface StepListener

testStarted

public void testStarted(String description)

Description copied from interface: StepListener

A test with a given name has started.

Specified by:

testStarted in interface StepListener

testFinished

public void testFinished(TestOutcome result)

Description copied from interface: StepListener

Called when a test finishes.

Specified by:

testFinished in interface StepListener

testSuiteFinished

public void testSuiteFinished()

Description copied from interface: StepListener

End of a test case or story.

Specified by:

testSuiteFinished in interface StepListener

stepStarted

public void stepStarted(ExecutedStepDescription description)

Description copied from interface: StepListener

Called when a test step is about to be started.

Specified by:

stepStarted in interface StepListener

Parameters:

description - the description of the test that is about to be run (generally a class and method name)

skippedStepStarted

public void skippedStepStarted(ExecutedStepDescription description)

Description copied from interface: StepListener

Called when a test step is about to be started, but this step is scheduled to be skipped.

Specified by:

skippedStepStarted in interface StepListener

Parameters:

description - the description of the test that is about to be run (generally a class and method name)

stepFailed

public void stepFailed(StepFailure failure)

Description copied from interface: StepListener

Called when a test step fails.

Specified by:

stepFailed in interface StepListener

Parameters:

failure - describes the test that failed and the exception that was thrown

lastStepFailed

public void lastStepFailed(StepFailure failure)

Description copied from interface: StepListener

Declare that a step has failed after it has finished.

Specified by:

lastStepFailed in interface StepListener

stepIgnored

public void stepIgnored()

Description copied from interface: StepListener

Called when a step will not be run, generally because a test method is annotated with Ignore.

Specified by:

stepIgnored in interface StepListener

stepIgnored

public void stepIgnored(String message)

Description copied from interface: StepListener

The step is marked as ignored with a descriptive message.

Specified by:

stepIgnored in interface StepListener

stepPending

public void stepPending()

Description copied from interface: StepListener

The step is marked as pending.

Specified by:

stepPending in interface StepListener

stepPending

public void stepPending(String message)

Description copied from interface: StepListener

The step is marked as pending with a descriptive message.

Specified by:

stepPending in interface StepListener

stepFinished

public void stepFinished()

Description copied from interface: StepListener

Called when an test step has finished successfully

Specified by:

stepFinished in interface StepListener

testFailed

public void testFailed(TestOutcome result,
                       Throwable cause)

Description copied from interface: StepListener

The test failed, but not while executing a step.

Specified by:

testFailed in interface StepListener

Parameters:

result - The test outcome structure for the failing test

cause - The exception that triggered the failure

testIgnored

public void testIgnored()

Description copied from interface: StepListener

The test as a whole was skipped or ignored.

Specified by:

testIgnored in interface StepListener

notifyScreenChange

public void notifyScreenChange()

Specified by:

notifyScreenChange in interface StepListener