com.atlassian.bamboo.resultsummary

Interface ResultsSummary

All Superinterfaces:

BambooCustomDataAware, BambooIdProvider, BambooObject, Comparable<ImmutableResultsSummary>, Deletable, ImmutableDeletable, ImmutableResultsSummary, PlanResultKeyProvider, ResultStatisticsProvider

All Known Subinterfaces:

BuildResultsSummary, ChainResultsSummary, MutableBuildKeyResultsSummary

All Known Implementing Classes:

AbstractResultsSummary, BuildResultsSummaryDocument, BuildResultsSummaryImpl, ChainResultsSummaryDocument, ChainResultsSummaryImpl

@PublicApi
public interface ResultsSummary
extends BambooObject, Deletable, ImmutableResultsSummary, BambooCustomDataAware, PlanResultKeyProvider

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

Fields inherited from interface com.atlassian.bamboo.plan.PlanResultKeyProvider

getPlanKey

Method Summary

Modifier and Type	Method and Description
String	getBuildKey() Deprecated. since 4.3, use ImmutableResultsSummary.getPlanKey()
String	getBuildResultKey() Deprecated. since 4.3, use ImmutableResultsSummary.getPlanResultKey()
int	getFormatVersion()
ImmutablePlan	getImmutablePlan() Gets the ImmutablePlan that this result belongs directly belongs to.
Long	getVariableContextBaselineId()
int	incrementRestartCount() Increments number of build restarts and returns the new value
void	resetTestClassResults(List<TestClassResult> testClassResults) Overrides all current testClassResults with the new ones
void	setBuildAgentId(long buildAgentId)
void	setBuildCancelledDate(Date buildCancelledDate)
void	setBuildCompletedDate(Date completionDate)
void	setBuildDate(Date buildDate)
void	setCustomBuild(boolean customBuild)
void	setDeltaState(DeltaState deltaState) Sets the DeltaState for the summary.
void	setDuration(long duration)
void	setLogSize(Long logSize) Sets the size of the log file associated with this result, eg.
void	setOnceOff(boolean onceOff)
void	setProcessingDuration(long processingDuration)
void	setQueueTime(Date queueDate)
void	setRebuild(boolean rebuild)
void	setTestResultsSummary(TestResultsSummary testResultsSummary) Set the test summary information from this build
void	setTimeToFix(Long timeToFix) A stored version of how long (milli seconds) it took for this build to fix a failure.
void	setTriggerReason(TriggerReason triggerReason)
void	updateFormatVersion() Sets format version to current Bamboo build number.
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, getCommits, getCustomBuildData, getDeltaState, getDuration, getDurationDescription, getFixingJiraIssues, getFullPlanName, getImmutableChain, getJiraIssueKeys, getJiraIssues, getLabellings, getLabelNames, getLifeCycleState, getLogSize, getManuallyOverriddenVariables, getPlanIfExists, getPlanKey, getPlanName, 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, 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, getStatDate

Methods inherited from interface java.lang.Comparable

compareTo

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

updateCustomDataEntry

Methods inherited from interface com.atlassian.bamboo.plan.PlanResultKeyProvider

getPlanResultKey

Method Detail

getImmutablePlan

@NotNull
ImmutablePlan getImmutablePlan()

Gets the ImmutablePlan that this result belongs directly belongs to. Since version 6.9 it is possible that ImmutableJob no longer exists but its results do, therefore it is recommended to use ImmutableResultsSummary.getPlanIfExists() instead when operating on job results.

Specified by:

getImmutablePlan in interface ImmutableResultsSummary

Returns:

the owning plan for the result

Throws:

IllegalStateException - if the plan doesn't exist.

getBuildKey

@Deprecated
 @NotNull
String getBuildKey()

Deprecated. since 4.3, use ImmutableResultsSummary.getPlanKey()

Returns:

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

getBuildResultKey

@Deprecated
 @NotNull
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)

setLogSize

void setLogSize(@Nullable
                Long logSize)

Sets the size of the log file associated with this result, eg. size of the log produced by a Job or largest log produced by Chain's Jobs.

Parameters:

logSize - size of the largest log associated with the result (use null if unknown)

setDuration

void setDuration(long duration)

Parameters:

duration - duration of the build in milliseconds

setProcessingDuration

void setProcessingDuration(long processingDuration)

Parameters:

processingDuration -

setBuildCompletedDate

void setBuildCompletedDate(@Nullable
                           Date completionDate)

setBuildCancelledDate

void setBuildCancelledDate(Date buildCancelledDate)

setTimeToFix

void setTimeToFix(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
                           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(Date buildDate)

Parameters:

buildDate -

setQueueTime

void setQueueTime(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(long buildAgentId)

getVariableContextBaselineId

@Nullable
Long getVariableContextBaselineId()

getFormatVersion

int getFormatVersion()

Returns:

build number of Bamboo version in which this result was created

updateFormatVersion

void updateFormatVersion()

Sets format version to current Bamboo build number.