com.atlassian.bamboo.resultsummary
Interface ResultsSummary

All Superinterfaces:

BambooCustomDataAware, BambooIdProvider, BambooObject, java.lang.Comparable<ImmutableResultsSummary>, Deletable, ImmutableDeletable, ImmutableResultsSummary, ResultStatisticsProvider

All Known Subinterfaces:

BuildResultsSummary, ChainResultsSummary, MutableBuildKeyResultsSummary

All Known Implementing Classes:

AbstractResultsSummary, BuildResultsSummaryDocument, BuildResultsSummaryImpl, ChainResultsSummaryDocument, ChainResultsSummaryImpl

public interface ResultsSummary
extends BambooObject, Deletable, ImmutableResultsSummary, BambooCustomDataAware

Used to store the result of all Plan executions

Since:

2.7

Field Summary

Fields inherited from interface com.atlassian.bamboo.resultsummary.ImmutableResultsSummary

CUSTOM_DATA_BUILD_KEY

Method Summary

java.lang.String	getBuildKey() Deprecated. since 4.3, use ImmutableResultsSummary.getPlanKey()
java.lang.String	getBuildResultKey() Deprecated. since 4.3, use ImmutableResultsSummary.getPlanResultKey()
ImmutablePlan	getImmutablePlan() Gets the Plan that this result belongs directly belongs to
Plan	getPlan() Deprecated. since 5.0 use getImmutablePlan()
VariableContextBaseline	getVariableContextBaseline()
int	incrementRestartCount() Increments number of build restarts and returns the new value
void	resetTestClassResults(java.util.List<TestClassResult> testClassResults) Overrides all current testClassResults with the new ones
void	setBuildAgentId(java.lang.Long buildAgentId)
void	setBuildCancelledDate(java.util.Date buildCancelledDate)
void	setBuildCompletedDate(java.util.Date completionDate)
void	setBuildDate(java.util.Date buildDate)
void	setCustomBuild(boolean customBuild)
void	setDeltaState(DeltaState deltaState) Sets the DeltaState for the summary.
void	setDuration(long duration)
void	setOnceOff(boolean onceOff)
void	setProcessingDuration(long processingDuration)
void	setQueueTime(java.util.Date queueDate)
void	setRebuild(boolean rebuild)
void	setTestResultsSummary(TestResultsSummary testResultsSummary) Set the test summary information from this build
void	setTimeToFix(java.lang.Long timeToFix) A stored version of how long (milli seconds) it took for this build to fix a failure.
void	setTriggerReason(TriggerReason triggerReason)
void	setVariableContextBaseline(VariableContextBaseline variableContextBaseline)
void	updateLifeCycleState(LifeCycleState lifeCycleState, BuildState buildState) Update lifeCycleState and buildState in one go.

Methods inherited from interface com.atlassian.bamboo.deletion.Deletable

setMarkedForDeletion

Methods inherited from interface com.atlassian.bamboo.core.BambooObject

setId

Methods inherited from interface com.atlassian.bamboo.core.BambooIdProvider

getId

Methods inherited from interface com.atlassian.bamboo.plan.cache.ImmutableDeletable

isMarkedForDeletion

Methods inherited from interface com.atlassian.bamboo.resultsummary.ImmutableResultsSummary

getArtifactLinks, getArtifactLinksThatExist, getBuildAgentId, getBuildCancelledDate, getBuildCompletedDate, getBuildTime, getChangesListSummary, getComments, getCommentsToDisplay, getCommits, getCustomBuildData, getDeltaState, getDuration, getDurationDescription, getFixingJiraIssues, getJiraIssueKeys, getJiraIssues, getLabellings, getLabelNames, getLifeCycleState, getManuallyOverriddenVariables, getPlanKey, getPlanResultKey, getProcessingDuration, getProcessingDurationDescription, getQueueTime, getReasonSummary, getRelatedJiraIssues, getRelativeBuildDate, getRelativeBuildDate, getRelativeBuildStartedDate, getRelativeBuildStartedDate, getRelativeQueueDate, getRelativeQueueDate, getRepositoryChangesets, getRestartCount, getShortReasonSummary, getSubscriptions, getSubstitutedVariables, getTestResultsSummary, getTestSummary, getTimeToFix, getTriggerReason, getUniqueAuthors, getVariableContext, getVariableContextLogs, hasChanges, hasComments, hasCommentsToDisplay, isActive, isCustomBuild, isFailed, isFinished, isInProgress, isNotBuilt, isNotRunYet, isOnceOff, isPending, isQueued, isRebuild, isSuccessful, isWaiting

Methods inherited from interface com.atlassian.bamboo.resultsummary.ResultStatisticsProvider

getBuildDate, getBuildNumber, getBuildState, getDurationInSeconds, getStatDate

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface com.atlassian.bamboo.core.BambooCustomDataAware

updateCustomDataEntry

Method Detail

getImmutablePlan

@NotNull
ImmutablePlan getImmutablePlan()

Gets the Plan that this result belongs directly belongs to

Specified by:

getImmutablePlan in interface ImmutableResultsSummary

Returns:

the owning plan for the result

Throws:

{@link - IllegalStateException} if the plan doesn't exist

getPlan

@NotNull
@Deprecated
Plan getPlan()

Deprecated. since 5.0 use getImmutablePlan()

Gets the Plan that this result belongs directly belongs to

Specified by:

getPlan in interface ImmutableResultsSummary

Returns:

the owning plan for the result

Throws:

{@link - IllegalStateException} if the plan doesn't exist.

getBuildKey

@Deprecated
@NotNull
java.lang.String getBuildKey()

Deprecated. since 4.3, use ImmutableResultsSummary.getPlanKey()

Returns:

full key of the plan. e.g BAM-MAIN

getBuildResultKey

@Deprecated
@NotNull
java.lang.String getBuildResultKey()

Deprecated. since 4.3, use ImmutableResultsSummary.getPlanResultKey()

Returns:

full build result key e.g. BAM-MAIN-100

setTriggerReason

void setTriggerReason(TriggerReason triggerReason)

setDeltaState

void setDeltaState(DeltaState deltaState)

Sets the DeltaState for the summary. Provides a status relative to the previous summary.

Parameters:

deltaState - - the relative status for this summary

setOnceOff

void setOnceOff(boolean onceOff)

setCustomBuild

void setCustomBuild(boolean customBuild)

setRebuild

void setRebuild(boolean rebuild)

setDuration

void setDuration(long duration)

Parameters:

duration - duration of the build in milliseconds

setProcessingDuration

void setProcessingDuration(long processingDuration)

Parameters:

processingDuration -

setBuildCompletedDate

void setBuildCompletedDate(java.util.Date completionDate)

setBuildCancelledDate

void setBuildCancelledDate(java.util.Date buildCancelledDate)

setTimeToFix

void setTimeToFix(java.lang.Long timeToFix)

A stored version of how long (milli seconds) it took for this build to fix a failure.

Parameters:

timeToFix - how long (milli seconds) it took for this build to fix a failure.

resetTestClassResults

void resetTestClassResults(@NotNull
                           java.util.List<TestClassResult> testClassResults)

Overrides all current testClassResults with the new ones

Parameters:

testClassResults - to set

setTestResultsSummary

void setTestResultsSummary(@NotNull
                           TestResultsSummary testResultsSummary)

Set the test summary information from this build

Parameters:

testResultsSummary - the test summary information

setBuildDate

void setBuildDate(java.util.Date buildDate)

Parameters:

buildDate -

setQueueTime

void setQueueTime(java.util.Date queueDate)

Parameters:

queueDate -

updateLifeCycleState

void updateLifeCycleState(@NotNull
                          LifeCycleState lifeCycleState,
                          @NotNull
                          BuildState buildState)

Update lifeCycleState and buildState in one go. Can throw IllegalArgumentException when values passed make no sense: - lifeCycleState == LifeCycleState.NOT_BUILT && buildState != BuildState.UNKNOWN

Parameters:

lifeCycleState - lifeCycleState to be set

buildState - buildState to be set

incrementRestartCount

int incrementRestartCount()

Increments number of build restarts and returns the new value

Returns:

setBuildAgentId

void setBuildAgentId(java.lang.Long buildAgentId)

getVariableContextBaseline

@Nullable
VariableContextBaseline getVariableContextBaseline()

setVariableContextBaseline

void setVariableContextBaseline(@Nullable
                                VariableContextBaseline variableContextBaseline)