test

Class TestReport

java.lang.Object

test.TestReport

All Implemented Interfaces:

java.io.Serializable

class TestReport
extends java.lang.Object
implements java.io.Serializable

Individual test report.

This class contains fields and convenience methods related to the result of running a single test. It is used internally by Series to pass test results. For failed tests, it is returned in SeriesReport objects.

Field Summary

Fields

Modifier and Type	Field and Description
private FatalError	cleanup_stop_cause Reason for test cleanup failure, or null if the test was cleaned up successfully.
private java.lang.Throwable	stop_cause Reason for test failure, or null if the test was successful.
private java.lang.String	task Task message when the test failed, or null if there was no task message, or the test was successful.
private java.lang.Class<? extends Test>	test_class Test class.

Constructor Summary

Constructors

Constructor and Description
TestReport(java.lang.Class<? extends Test> test_class, java.lang.Throwable stop_cause, FatalError cleanup_stop_cause) Creates a TestReport object.

Method Summary

Modifier and Type	Method and Description
(package private) boolean	fatal() Returns true if and only if the test stopped with a fatal error, or cleanup stopped with any error (all cleanup erros are fatal).
(package private) void	print(java.io.PrintStream stream) Prints a report for a failed test.
(package private) boolean	successful() Returns true if and only if the test was successful: if both the test stop cause and the cleanup stop cause are null.

Methods inherited from class java.lang.Object

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

Field Detail

test_class

private final java.lang.Class<? extends Test> test_class

Test class.

stop_cause

private final java.lang.Throwable stop_cause

Reason for test failure, or null if the test was successful.

task

private final java.lang.String task

Task message when the test failed, or null if there was no task message, or the test was successful.

cleanup_stop_cause

private final FatalError cleanup_stop_cause

Reason for test cleanup failure, or null if the test was cleaned up successfully.

Constructor Detail

TestReport

TestReport(java.lang.Class<? extends Test> test_class,
           java.lang.Throwable stop_cause,
           FatalError cleanup_stop_cause)

Creates a TestReport object.

If stop_cause is wrapped in a FailedDuringTask object, it is unwrapped, and the task noted in the task field.

Method Detail

successful

boolean successful()

Returns true if and only if the test was successful: if both the test stop cause and the cleanup stop cause are null.

fatal

boolean fatal()

Returns true if and only if the test stopped with a fatal error, or cleanup stopped with any error (all cleanup erros are fatal).

print

void print(java.io.PrintStream stream)

Prints a report for a failed test.

The test name is printed. If the main test failed, then the reason for the failure is printed. The task being performed during the failure is shown, if there was one. If the failure was not a timeout, the stack trace is shown as well. If the cleanup task failed, a description of the error and a stack trace are printed.

Parameters:

stream - Stream to receive the formatted test report.