Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.apache.batik.test
Interface TestReport  view TestReport download TestReport.java

All Known Subinterfaces:
TestSuiteReport
All Known Implementing Classes:
DefaultTestReport, DefaultTestSuiteReport

public interface TestReport

Defines the interface of a TestReport produced by a Test case.

Version:
$Id: TestReport.java,v 1.6 2004/08/18 07:16:58 vhardy Exp $

Nested Class Summary
static class TestReport.Entry
          Inner class for describing an information element in a TestReport
 
Field Summary
static java.lang.String ENTRY_KEY_ERROR_CONDITION_STACK_TRACE
          Entry with the stack trace for a specific test error condition.
static java.lang.String ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_CLASS
          Entry describing the class of the internal exception that caused the test's internal failure
static java.lang.String ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_MESSAGE
          Entry describing the messages of the internal exception that caused the test's internal failure
static java.lang.String ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_STACK_TRACE
          Entry with the stack trace for the internal exception that caused the test's internal failure
static java.lang.String ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_CLASS
          Entry with the class of the exception that caused the test to fail.
static java.lang.String ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_MESSAGE
          Entry with the message of the exception that caused the test to fail.
static java.lang.String ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_STACK_TRACE
          Entry with the stack trace that caused the test to fail.
static java.lang.String ERROR_ASSERTION_FAILED
          Generic error code to report test assertion failures.
static java.lang.String ERROR_INTERNAL_TEST_FAILURE
          Error code to be used when a Test fails in its own operation (i.e., the Test itself fails, not what it is testing.
static java.lang.String ERROR_TEST_FAILED
          Very generic error code which can be used to report that the test failed.
 
Method Summary
 void addDescriptionEntry(java.lang.String key, java.lang.Object value)
          Appends entry to the array of description entry.
 TestReport.Entry[] getDescription()
          Returns an array of Entry objects describing the test result.
 java.lang.String getErrorCode()
          Returns the error code.
 TestSuiteReport getParentReport()
          Returns the parent report in case this TestReport is part of a TestSuiteReport.
 Test getTest()
          Returns the Test object that generated this TestReport
 boolean hasPassed()
          Returns the overall test result
 void setParentReport(TestSuiteReport parent)
          Set this report's parent.
 

Field Detail

ERROR_INTERNAL_TEST_FAILURE

public static final java.lang.String ERROR_INTERNAL_TEST_FAILURE
Error code to be used when a Test fails in its own operation (i.e., the Test itself fails, not what it is testing. An internal failure is reported when any type of exception occurs while running the test.

See Also:
Constant Field Values

ERROR_TEST_FAILED

public static final java.lang.String ERROR_TEST_FAILED
Very generic error code which can be used to report that the test failed.

See Also:
Constant Field Values

ERROR_ASSERTION_FAILED

public static final java.lang.String ERROR_ASSERTION_FAILED
Generic error code to report test assertion failures.

See Also:
Constant Field Values

ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_CLASS

public static final java.lang.String ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_CLASS
Entry describing the class of the internal exception that caused the test's internal failure

See Also:
Constant Field Values

ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_MESSAGE

public static final java.lang.String ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_MESSAGE
Entry describing the messages of the internal exception that caused the test's internal failure

See Also:
Constant Field Values

ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_STACK_TRACE

public static final java.lang.String ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_STACK_TRACE
Entry with the stack trace for the internal exception that caused the test's internal failure

See Also:
Constant Field Values

ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_CLASS

public static final java.lang.String ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_CLASS
Entry with the class of the exception that caused the test to fail. Note that this is different from ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_CLASS, in which case, the test itself failed unexpectedly. In this case, the entry is used to describe an expected exception for which the Test author probably created a specific error code.

See Also:
Constant Field Values

ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_MESSAGE

public static final java.lang.String ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_MESSAGE
Entry with the message of the exception that caused the test to fail. Note that this is different from ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_MESSAGE, in which case, the test itself failed unexpectedly. In this case, the entry is used to describe an expected exception for which the Test author probably created a specific error code.

See Also:
Constant Field Values

ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_STACK_TRACE

public static final java.lang.String ENTRY_KEY_REPORTED_TEST_FAILURE_EXCEPTION_STACK_TRACE
Entry with the stack trace that caused the test to fail. Note that this is different from ENTRY_KEY_INTERNAL_TEST_FAILURE_EXCEPTION_STACK_TRACE, in which case, the test itself failed unexpectedly. In this case, the entry is used to describe an expected exception for which the Test author probably created a specific error code.

See Also:
Constant Field Values

ENTRY_KEY_ERROR_CONDITION_STACK_TRACE

public static final java.lang.String ENTRY_KEY_ERROR_CONDITION_STACK_TRACE
Entry with the stack trace for a specific test error condition.

See Also:
Constant Field Values
Method Detail

hasPassed

public boolean hasPassed()
Returns the overall test result


getErrorCode

public java.lang.String getErrorCode()
Returns the error code. This should never be null if the test failed (i.e., if hasPassed returns false).


getDescription

public TestReport.Entry[] getDescription()
Returns an array of Entry objects describing the test result. Accepted value types are String objects, URL objects, File objects and TestReport objects. File objects should be considered as temporary files


addDescriptionEntry

public void addDescriptionEntry(java.lang.String key,
                                java.lang.Object value)
Appends entry to the array of description entry.


getTest

public Test getTest()
Returns the Test object that generated this TestReport


getParentReport

public TestSuiteReport getParentReport()
Returns the parent report in case this TestReport is part of a TestSuiteReport. This may be null.


setParentReport

public void setParentReport(TestSuiteReport parent)
Set this report's parent.