hudson.tasks.test
Class TestResult

java.lang.Object
  hudson.model.AbstractModelObject
      hudson.tasks.junit.TestObject
          hudson.tasks.test.TestObject
              hudson.tasks.test.TestResult

All Implemented Interfaces:

ModelObject, SearchableModelObject, SearchItem, Serializable

Direct Known Subclasses:

CaseResult, SimpleCaseResult, TabulatedResult

public abstract class TestResult
extends TestObject

A class that represents a general concept of a test result, without any language or implementation specifics. Subclasses must add @Exported annotation to the fields they want to export.

See Also:

Serialized Form

Constructor Summary

TestResult()

Method Summary

String	annotate(String text) Annotate some text -- what does this do?
Result	getBuildResult() Mark a build as unstable if there are failures.
float	getDuration() Time it took to run this test.
String	getErrorDetails() If there was an error or a failure, this is the text from the message.
String	getErrorStackTrace() If there was an error or a failure, this is the stack trace, or otherwise null.
int	getFailCount() Gets the total number of failed tests.
int	getFailedSince() If this test failed, then return the build number when this test started failing.
Run<?,?>	getFailedSinceRun() If this test failed, then return the run when this test started failing.
Collection<? extends TestResult>	getFailedTests() Gets the "children" of this test result that failed
AbstractTestResultAction	getParentAction() Returns the action that points to the top level test result includes this test result.
int	getPassCount() Gets the total number of passed tests.
Collection<? extends TestResult>	getPassedTests() Gets the "children" of this test result that passed
TestResult	getPreviousResult() Gets the counter part of this TestResult in the previous run.
TestResult	getResultInBuild(AbstractBuild<?,?> build) Gets the counter part of this TestResult in the specified run.
int	getSkipCount() Gets the total number of skipped tests.
Collection<? extends TestResult>	getSkippedTests() Gets the "children" of this test result that were skipped
String	getStderr() The stderr of this test.
String	getStdout() The stdout of this test.
String	getTitle() Gets the human readable title of this result object.
boolean	isPassed()
void	setParent(TestObject parent) Sets the parent test result
void	setParentAction(AbstractTestResultAction action) If the concept of a parent action is important to a subclass, then it should provide a non-noop implementation of this method.
void	tally() Request that the result update its counts of its children.
String	toPrettyString()

Methods inherited from class hudson.tasks.test.TestObject

doSubmitDescription, findCorrespondingResult, getApi, getDescription, getDurationString, getDynamic, getHistory, getId, getName, getOwner, getParent, getRelativePathFrom, getSafeName, getSearchUrl, getTestAction, getTestActions, getTestResult, getTestResultAction, getTopLevelTestResult, getTotalCount, getUrl, safe, setDescription, uniquifyName

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, getSearchName, makeSearchIndex, requirePOST, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.model.ModelObject

getDisplayName

Constructor Detail

TestResult

public TestResult()

Method Detail

setParentAction

public void setParentAction(AbstractTestResultAction action)

If the concept of a parent action is important to a subclass, then it should provide a non-noop implementation of this method.

Parameters:

action -

getParentAction

public AbstractTestResultAction getParentAction()

Returns the action that points to the top level test result includes this test result.

Returns:

tally

public void tally()

Request that the result update its counts of its children. Does not require a parent action or owner or siblings. Subclasses should implement this, unless they are *always* in a tallied state.

setParent

public void setParent(TestObject parent)

Sets the parent test result

Parameters:

parent -

getTitle

public String getTitle()

Gets the human readable title of this result object.

getBuildResult

public Result getBuildResult()

Mark a build as unstable if there are failures. Otherwise, leave the build result unchanged.

Returns:

Result.UNSTABLE if there are test failures, null otherwise.

getDuration

public float getDuration()

Time it took to run this test. In seconds.

Specified by:

getDuration in class TestObject

getPassCount

public int getPassCount()

Gets the total number of passed tests.

Specified by:

getPassCount in class TestObject

getFailCount

public int getFailCount()

Gets the total number of failed tests.

Specified by:

getFailCount in class TestObject

getSkipCount

public int getSkipCount()

Gets the total number of skipped tests.

Specified by:

getSkipCount in class TestObject

getPreviousResult

public TestResult getPreviousResult()

Gets the counter part of this TestResult in the previous run.

Specified by:

getPreviousResult in class TestObject

Returns:

null if no such counter part exists.

getResultInBuild

public TestResult getResultInBuild(AbstractBuild<?,?> build)

Gets the counter part of this TestResult in the specified run.

Specified by:

getResultInBuild in class TestObject

Returns:

null if no such counter part exists.

getFailedTests

public Collection<? extends TestResult> getFailedTests()

Gets the "children" of this test result that failed

Returns:

the children of this test result, if any, or an empty collection

getPassedTests

public Collection<? extends TestResult> getPassedTests()

Gets the "children" of this test result that passed

Returns:

the children of this test result, if any, or an empty collection

getSkippedTests

public Collection<? extends TestResult> getSkippedTests()

Gets the "children" of this test result that were skipped

Returns:

the children of this test result, if any, or an empty list

getFailedSince

public int getFailedSince()

If this test failed, then return the build number when this test started failing.

getFailedSinceRun

public Run<?,?> getFailedSinceRun()

If this test failed, then return the run when this test started failing.

getStdout

public String getStdout()

The stdout of this test.

getStderr

public String getStderr()

The stderr of this test.

getErrorStackTrace

public String getErrorStackTrace()

If there was an error or a failure, this is the stack trace, or otherwise null.

getErrorDetails

public String getErrorDetails()

If there was an error or a failure, this is the text from the message.

isPassed

public boolean isPassed()

Returns:

true if the test was not skipped and did not fail, false otherwise.

toPrettyString

public String toPrettyString()

annotate

public String annotate(String text)

Annotate some text -- what does this do?

Parameters:

text -

Returns: