Package 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.- Since:
- 1.343
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description TestResult()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description 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 failedAbstractTestResultAction
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 passedTestResult
getPreviousResult()
Gets the counter part of thisTestResult
in the previous run.Map<String,String>
getProperties()
TestResult
getResultInRun(Run<?,?> build)
Gets the counter part of thisTestResult
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 skippedString
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 resultvoid
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, getFullDisplayName, getFullName, getHistory, getId, getName, getParent, getRelativePathFrom, getResultInBuild, getSafeName, getSearchUrl, getTestAction, getTestActions, getTestResult, getTestResultAction, getTopLevelTestResult, getTotalCount, getUrl, safe, setDescription, uniquifyName
-
Methods inherited from class hudson.tasks.junit.TestObject
getOwner, getRun
-
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
-
-
-
-
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
- Action that points to the top level test result.
-
getParentAction
public AbstractTestResultAction getParentAction()
Returns the action that points to the top level test result includes this test result.- Returns:
- action The action that points to the top level test result.
-
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
- Parent test result.
-
getTitle
public String getTitle()
Gets the human readable title of this result object.- Returns:
- 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 classTestObject
- Returns:
- the time in seconds the test ran.
-
getPassCount
public int getPassCount()
Gets the total number of passed tests.- Specified by:
getPassCount
in classTestObject
- Returns:
- the total number of passed tests.
-
getFailCount
public int getFailCount()
Gets the total number of failed tests.- Specified by:
getFailCount
in classTestObject
- Returns:
- the total number of failed tests.
-
getSkipCount
public int getSkipCount()
Gets the total number of skipped tests.- Specified by:
getSkipCount
in classTestObject
- Returns:
- the total number of skipped tests.
-
getPreviousResult
public TestResult getPreviousResult()
Gets the counter part of thisTestResult
in the previous run.- Specified by:
getPreviousResult
in classTestObject
- Returns:
- null if no such counter part exists.
-
getResultInRun
public TestResult getResultInRun(Run<?,?> build)
Gets the counter part of thisTestResult
in the specified run.- Overrides:
getResultInRun
in classTestObject
- Parameters:
build
- The run for which the run is requested.- 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.- Returns:
- 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.- Returns:
- the run when this test started failing.
-
getStdout
public String getStdout()
The stdout of this test.- Returns:
- the stdout of this test.
-
getStderr
public String getStderr()
The stderr of this test.- Returns:
- 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.- Returns:
- the stack trace of the error or failure.
-
getErrorDetails
public String getErrorDetails()
If there was an error or a failure, this is the text from the message.- Returns:
- the message of the error or failure.
-
isPassed
public boolean isPassed()
- Returns:
- true if the test was not skipped and did not fail, false otherwise.
-
toPrettyString
public String toPrettyString()
-
-