hudson.tasks.test

Class AbstractTestResultAction<T extends AbstractTestResultAction>

java.lang.Object

hudson.tasks.test.AbstractTestResultAction<T>

All Implemented Interfaces:

hudson.model.Action, hudson.model.HealthReportingAction, hudson.model.ModelObject, jenkins.model.RunAction2

Direct Known Subclasses:

AggregatedTestResultAction, AggregatedTestResultPublisher.TestResultAction, TestResultAction

@ExportedBean
public abstract class AbstractTestResultAction<T extends AbstractTestResultAction>
extends Object
implements hudson.model.HealthReportingAction, jenkins.model.RunAction2

Common base class for recording test result.

Project and Build recognizes Actions that derive from this, and displays it nicely (regardless of the underlying implementation.)

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractTestResultAction.Summarizer

Field Summary

Fields

Modifier and Type	Field and Description
hudson.model.AbstractBuild<?,?>	owner Deprecated.
hudson.model.Run<?,?>	run

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractTestResultAction()
protected	AbstractTestResultAction(hudson.model.AbstractBuild owner) Deprecated.
protected	AbstractTestResultAction(hudson.model.Run owner) Deprecated. Use the default constructor and just call Run.addAction(hudson.model.Action) to associate the build with the action.

Method Summary

Methods

Modifier and Type	Method and Description
void	doGraph(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp) Generates a PNG image for the test result trend.
void	doGraphMap(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp) Generates a clickable map HTML for doGraph(StaplerRequest, StaplerResponse).
TestResult	findCorrespondingResult(String id)
TestResult	findPreviousCorresponding(TestResult test)
hudson.model.Api	getApi() Exposes this object to the remote API.
hudson.model.HealthReport	getBuildHealth()
protected String	getDescription(TestObject object) TestObjects do not have their own persistence mechanism, so updatable data of TestObjects need to be persisted by the owning AbstractTestResultAction, and this method and setDescription(TestObject, String) provides that logic.
String	getDisplayName()
abstract int	getFailCount() Gets the number of failed tests.
List<? extends TestResult>	getFailedTests() A shortcut for summary.jelly
String	getFailureDiffString() Gets the diff string of failures.
double	getHealthScaleFactor() Returns how much to scale the test related health by.
String	getIconFileName()
T	getPreviousResult() Gets the test result of the previous build, if it's recorded, or null.
abstract Object	getResult() Returns the object that represents the actual test result.
int	getSkipCount() Gets the number of skipped tests.
String	getTestResultPath(TestResult it) Returns a full path down to a test result
abstract int	getTotalCount() Gets the total number of tests.
String	getUrlName()
void	onAttached(hudson.model.Run<?,?> r)
void	onLoad(hudson.model.Run<?,?> r)
Object	readResolve()
protected void	setDescription(TestObject object, String description)

Methods inherited from class java.lang.Object

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

Field Detail

run

public transient hudson.model.Run<?,?> run

Since:

1.2-beta-1

owner

@Deprecated
public transient hudson.model.AbstractBuild<?,?> owner

Deprecated.

Constructor Detail

AbstractTestResultAction

protected AbstractTestResultAction()

Since:

1.545

AbstractTestResultAction

@Deprecated
protected AbstractTestResultAction(hudson.model.Run owner)

Deprecated. Use the default constructor and just call Run.addAction(hudson.model.Action) to associate the build with the action.

Since:

1.2-beta-1

AbstractTestResultAction

@Deprecated
protected AbstractTestResultAction(hudson.model.AbstractBuild owner)

Deprecated.

Method Detail

onAttached

public void onAttached(hudson.model.Run<?,?> r)

Specified by:

onAttached in interface jenkins.model.RunAction2

onLoad

public void onLoad(hudson.model.Run<?,?> r)

Specified by:

onLoad in interface jenkins.model.RunAction2

getFailCount

@Exported(visibility=2)
public abstract int getFailCount()

Gets the number of failed tests.

getSkipCount

@Exported(visibility=2)
public int getSkipCount()

Gets the number of skipped tests.

getTotalCount

@Exported(visibility=2)
public abstract int getTotalCount()

Gets the total number of tests.

getFailureDiffString

public final String getFailureDiffString()

Gets the diff string of failures.

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface hudson.model.Action

Specified by:

getDisplayName in interface hudson.model.ModelObject

getUrlName

@Exported(visibility=2)
public String getUrlName()

Specified by:

getUrlName in interface hudson.model.Action

getIconFileName

public String getIconFileName()

Specified by:

getIconFileName in interface hudson.model.Action

getBuildHealth

public hudson.model.HealthReport getBuildHealth()

Specified by:

getBuildHealth in interface hudson.model.HealthReportingAction

getHealthScaleFactor

public double getHealthScaleFactor()

Returns how much to scale the test related health by.

Returns:

a factor of 1.0 to have the test health be the percentage of tests passing so 20% of tests failing will report as 80% health. A factor of 2.0 will mean that 20% of tests failing will report as 60% health. A factor of 2.5 will mean that 20% of test failing will report as 50% health. A factor of 4.0 will mean that 20% of tests failing will report as 20% health. A factor of 5.0 will mean that 20% (or more) of tests failing will report as 0% health. A factor of 0.0 will disable test health reporting.

getApi

public hudson.model.Api getApi()

Exposes this object to the remote API.

getResult

public abstract Object getResult()

Returns the object that represents the actual test result. This method is used by the remote API so that the XML/JSON that we are sending won't contain unnecessary indirection (that is, AbstractTestResultAction in between.

If such a concept doesn't make sense for a particular subtype, return this.

getPreviousResult

public T getPreviousResult()

Gets the test result of the previous build, if it's recorded, or null.

findPreviousCorresponding

public TestResult findPreviousCorresponding(TestResult test)

findCorrespondingResult

public TestResult findCorrespondingResult(String id)

getFailedTests

public List<? extends TestResult> getFailedTests()

A shortcut for summary.jelly

Returns:

List of failed tests from associated test result.

doGraph

public void doGraph(org.kohsuke.stapler.StaplerRequest req,
           org.kohsuke.stapler.StaplerResponse rsp)
             throws IOException

Generates a PNG image for the test result trend.

Throws:

IOException

doGraphMap

public void doGraphMap(org.kohsuke.stapler.StaplerRequest req,
              org.kohsuke.stapler.StaplerResponse rsp)
                throws IOException

Generates a clickable map HTML for doGraph(StaplerRequest, StaplerResponse).

Throws:

IOException

getTestResultPath

public String getTestResultPath(TestResult it)

Returns a full path down to a test result

getDescription

protected String getDescription(TestObject object)

TestObjects do not have their own persistence mechanism, so updatable data of TestObjects need to be persisted by the owning AbstractTestResultAction, and this method and setDescription(TestObject, String) provides that logic.

The default implementation stores information in the 'this' object.

See Also:

TestObject.getDescription()

setDescription

protected void setDescription(TestObject object,
                  String description)

readResolve

public Object readResolve()