com.atlassian.bamboo.resultsummary

Interface ResultsSummaryManager

All Known Subinterfaces:

BuildResultsSummaryManager

@PublicApi
public interface ResultsSummaryManager

Manager for all ResultsSummary derivatives that supersedes BuildResultsSummaryManager

Since:

2.7

Method Summary

Methods

Modifier and Type	Method and Description
void	addVariableContextSnapshotToResultSummary(ResultsSummary resultsSummary, VariableContext variableContext) Adds state of global and plan variables to result at the beginning of execution.
void	calculateAndSetDeltaState(ResultsSummary resultsSummary) Figures out the delta state for the provided results summary, if a 'fixing' build will also calculate how long it took to fix.
Long	calculateQueueDuration(ChainResultsSummary resultsSummary) Calculates queueDuration value for a chain result as a maximum value of (vcsUpdateTime - queueTime) for all related job results.
Long	calculateVcsUpdateDuration(ChainResultsSummary resultsSummary) Calculates vcsUpdateDuration value for a chain result as a maximum value of (buildDate - vcsUpdateTime) for all related job results.
void	clearVariablesOnRerunBuild(ResultsSummary resultSummary) Clear stored stage manual variables when build is fully rerun.
int	countResultsWithState(PlanKey planKey, int lowerBuildNumber, int upperBuildNumber, BuildState buildState) Counts results with a given state in a given build number range for plan.
<T extends ResultsSummary> T	createResultsSummary(BuildContext buildContext, Class<T> aClass) Creates a ResultsSummary of the given Class
List<Integer>	findAllBuildResultsNumbers(PlanKey planKey)
List<ChainResultsSummary>	findChainResultsWithJobLabelled(ResultsSummaryCriteria criteria, List<Label> labels) Searches through all chains to find any that have jobs which match the given labels.
ResultsSummary	findFirstFailedBuildResultAfter(String buildKey, int buildNumber) Finds the first failed ResultsSummary after buildNumber
ResultsSummary	findFirstFailedBuildResultBetween(ImmutablePlan build, int lowerBuildNumber, int upperBuildNumber) Finds the first failed build between the upper and lower build numbers inclusively.
<T extends ResultsSummary> T	findFirstResultAfter(PlanResultKey planResultKey, Class<T> aClass) Finds the first ResultsSummary after a specified build which is either FINISHED or can be FINISHED, i.e.
ResultsSummary	findFirstSuccessfulBuildResultAfter(PlanResultKey planResultKey) Finds the last successful ResultsSummary after buildNumber
ResultsSummary	findFirstSuccessfulBuildResultAfter(String buildKey, int buildNumber) Deprecated. since 5.2 use findFirstSuccessfulBuildResultAfter(PlanResultKey)
List<LinkedJiraIssue>	findJiraIssuesForPlan(ImmutablePlan plan) Deprecated. replaced by #findJiraIssuesForPlanKey(String)}
List<LinkedJiraIssue>	findJiraIssuesForPlanKey(PlanKey planKey) Retrieves a list of LinkedJiraIssue linked to the given plan key
List<LinkedJiraIssue>	findJiraIssuesForResults(List<ResultsSummary> buildResults) Retrieves a list of LinkedJiraIssue linked to the given build result summaries
ResultsSummary	findLastBuildResultBefore(String buildKey, int buildNumber) Finds the last successful or failing BuildResultsSummary before buildNumber
<T extends ResultsSummary> T	findLastBuildResultBeforeWithTests(PlanResultKey planResultKey, Class<T> aClass, boolean includeOnceOffBuilds) Finds the last successful or failing BuildResultsSummary before buildNumber
ResultsSummary	findLastFailingBuildResultBefore(ImmutablePlan build, int buildNumber) Finds the last failing ResultsSummary before buildNumber
<T extends ResultsSummary> T	findLastResultBefore(PlanResultKey planResultKey, Class<T> aClass) Finds the last successful or failing ResultsSummary before planResultKey.getBuildNumber
<T extends ResultsSummary> T	findLastResultBefore(PlanResultKey planResultKey, Class<T> aClass, boolean includeOnceOffBuilds) Finds the last ResultsSummary before planResultKey.getBuildNumber
<T extends ResultsSummary> T	findLastResultSummaryWithState(PlanKey planKey, BuildState buildState, Class<T> aClass)
ResultsSummary	findLastSuccessfulBuildResultBefore(ImmutablePlan build, int buildNumber) Deprecated. Use findLastSuccessfulBuildResultBefore(PlanResultKey) instead. Since v5.2.
ResultsSummary	findLastSuccessfulBuildResultBefore(PlanResultKey planResultKey) Finds the last successful ResultsSummary before build
List<? extends ResultsSummary>	findResultsSummariesByJiraIssues(List<String> issueKeys) Finds a list of results which are linked to the given issue keys
List<? extends ResultsSummary>	findResultsSummariesByProjectKey(String projectKey) Provide a list of results which are linked to any issues under the given jira project key
<T extends ResultsSummary> Collection<T>	getAllActiveResultSummariesForPlan(PlanKey planKey, Class<T> aClass) Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state
List<BuildResultsSummary>	getAllBuildResultsSummariesForAgent(Long agentId) Returns all BuildResultsSummary for the passed BuildAgent's id.
<T extends ResultsSummary> Collection<T>	getAllBuildResultSummariesInUnknownState(Class<T> aClass) Returns all the BuildResultsSummary in a BuildState.UNKNOWN state
<T extends ResultsSummary> Collection<T>	getAllInProgressResultSummaries(Class<T> aClass) Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state
<T extends ResultsSummary> Collection<T>	getAllPendingResultSummaries(Class<T> aClass) Returns all the ResultsSummary in a LifeCycleState.PENDING state
<T extends ResultsSummary> Collection<T>	getAllQueuedResultSummaries(Class<T> aClass) Returns all the ResultsSummary in a LifeCycleState.QUEUED state
long	getAveragePlanExecutionDuration(ImmutablePlan plan, int numberOfResults) Get average duration from n last results summaries in finished state for a plan.
ResultsSummary	getBreakingBuild(ResultsSummary buildResultsSummary) Returns the first failing build after the last successful build.
ChainStageResult	getChainStageResultById(Long id) Returns a ChainStageResult by its id
List<UnassociatedCommit>	getCommitsForUser(String username, int max) Retrieve a list of recent Commits for the given user.
<T extends ResultsSummary> List<T>	getFinalizedResultSummariesForPlan(PlanKey planKey, Class<T> aClass, int firstResult, int maxResults) Returns all the ResultsSummary in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state with the given Class.
ResultsSummary	getFixingBuild(ResultsSummary buildResultsSummary) Returns the first successful ResultsSummary for given ResultsSummary.
List<BuildResultsSummary>	getLastNBuildResultsSummaries(ImmutableBuildable buildable, int numberOfResults) Deprecated. since 2.7 use getLastNResultsSummaries(com.atlassian.bamboo.plan.cache.ImmutablePlan, int) instead
List<ResultsSummary>	getLastNFailedResultsSummaries(Plan build, int numberOfResults) Returns the most recent n failed build results.
List<ResultsSummary>	getLastNResultsSummaries(ImmutablePlan plan, int numberOfResults) Provides a list of the latest N results summaries for the given plan, newest first.
<T extends ResultsSummary> T	getLastResultsSummary(String planKey, Class<T> aClass) Get the last ResultsSummary for planKey and Class
ResultsSummary	getLastSuccessfulResultSummary(PlanKey planKey) Get the last successful ResultsSummary for planKey
List<ResultsSummary>	getLatestFailedResultSummaries() Retrieve list of failed build results (for all builds) in the last few days (number of days is specified in the DAO) This method is filtered to remove results that user doesn't have permission to see
List<ResultsSummary>	getLatestResultSummaries() Retrieve list of build results (for all builds) in the last few days (number of days is specified in the DAO) This method is filtered to remove results that user doesn't have permission to see
List<BuildResultsSummary>	getLatestSummariesForAgent(Long agentId, Date fromDate) Retrieves build summaries for agent id not older than certain date.
List<BuildResultsSummary>	getLatestSummariesForAgent(Long agentId, int maxCount) Retrieves n last build summaries for agent.
BuildResultsSummary	getLatestSummaryForAgent(long agentId)
List<ResultsSummary>	getNeighbouringSummaries(ImmutablePlan plan, int buildNumber, int neighbouringSummariesMaxCount) Returns all the ResultsSummary objects that matches the passed build numbers
List<ResultsSummary>	getNeighbouringSummaries(Plan plan, int buildNumber) Returns all the ResultsSummary objects that matches the passed build numbers
int	getNumberOfConcurrentlyRunningBuilds(PlanKey planKey) Gets the number of concurrently running builds
long	getNumberOfFinalizedResults(ImmutablePlan plan) Get number of the ResultsSummarys in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state for the given Plan
long	getNumberOfFinishedResults(Plan plan) Get number of the ResultsSummarys in LifeCycleState.FINISHED state for the given Plan
long	getNumberOfResults() Get number of all ResultsSummarys
ChainResultsSummary	getParentResultSummary(ResultsSummary resultsSummary) Get (@link ChainResultsSummary} containing given ResultsSummary
List<PlanKey>	getPlanKeysSortedByNumberOfFinalizedResultSummaries()
ResultsSummary	getResultsSummary(long id) Lookup the ResultsSummary by id
ResultsSummary	getResultsSummary(PlanResultKey planResultKey) Lookup the ResultsSummary by PlanResultKey
<T extends ResultsSummary> T	getResultsSummary(PlanResultKey planResultKey, Class<T> aClass) Lookup ResultsSummary by PlanResultKey and expected type
<T extends ResultsSummary> T	getResultsSummary(PlanResultKey planResultKey, Class<T> aClass, ResultDataRead dataRead) Lookup ResultsSummary by PlanResultKey and expected type.
ResultsSummary	getResultsSummary(PlanResultKey planResultKey, ResultDataRead dataRead) Lookup the ResultsSummary by PlanResultKey.
<T extends ResultsSummary> List<T>	getResultSummaries(ResultsSummaryCriteria criteria) Generic search to find any result summaries bases on the criteria provided.
<T extends ResultsSummary> List<T>	getResultSummariesByChangeSetId(String changeSetId, Class<T> discriminator) Get a list of all build results containing a commit with the given change set ID.
<T extends ResultsSummary> List<T>	getResultSummariesByChangeSetIdAndRepository(long repositoryId, String changeSetId, Class<T> discriminator) Get a list of all build results containing a commit with the given change set ID that are in the given repository.
<T extends ResultsSummary> List<T>	getResultSummariesByChangeSetIds(Iterable<Pair<String,RepositoryData>> changeSetIds, Class<T> discriminator) Get a list of all build results containing a commit with any of the given change set IDs and which are in the supplied list of repository datas.
<T extends ResultsSummary> List<T>	getResultSummariesByChangeSetIds(List<String> changeSetIds, Class<T> discriminator) Get a list of all build results containing a commit with any of the given change set IDs.
<T extends ResultsSummary> List<T>	getResultSummariesForExpiry(ExpiryCriteria expiryCriteria) Searches for result summaries according to the given criteria for use in build expiry.
<T extends ResultsSummary> List<T>	getResultSummariesForPlan(ImmutablePlan plan, int firstResult, int maxResults) Get the ResultsSummarys for the given Plan in any LifeCycleState.
<T extends ResultsSummary> List<T>	getResultSummariesForPlanByLifeCycleState(Plan plan, LifeCycleState lifeCycleState, int firstResult, int maxResults) Get the ResultsSummarys for the given Plan in give LifeCycleState that are Results are sorted by build number (descending).
ChainStageResult	getStageForResult(ResultsSummary resultsSummary) Get (@link ChainStageResult} containing given ResultsSummary
void	invalidateLogSize(PlanResultKey planResultKey) Invalidates the log size of a ResultsSummary with the given PlanResultKey.
void	logSubstitutedVariables(BuildContext buildContext, ResultsSummary resultsSummary) Adds variable substitution result to ResultsSummary This method logs substitution after it was performed and will use only REALLY substituted values
void	logVariablesForSubstitution(BuildContext buildContext, ResultsSummary resultsSummary) Adds expected variable substitution to ResultsSummary This method logs substitution before build was performed and is used basically to log substitution against plan result as there will be no possibility to track it afterwards
int	markResultSummariesForDeletion(PlanKey planKey) Mass update of all ResultsSummary records in the database related to a Plan identified by planKey.
void	moveResultSummaries(PlanKey oldPlanKey, PlanKey newPlanKey) Deprecated. since 3.2, use moveResultSummaries(Plan, PlanKey, PlanKey)
void	moveResultSummaries(Plan newParentPlan, PlanKey oldPlanKey, PlanKey newPlanKey) Reassigns plan key ResultsSummaries associated with selected plan key.
void	postBuildVariableSnapshotUpdate(ResultsSummary resultsSummary, VariableContext variableContext) Saves result variables produced in a job.
int	removeAllOrphanedResultSummaries() Removes all the ResultsSummary objects in the database that do not have a matching Plan
void	removeArtifacts(ImmutablePlan plan, int buildNumber) Remove any artifacts stored for this plan result
void	removeArtifacts(ResultsSummary resultsSummary) Remove any artifacts stored for this plan result
void	removeBuildLogs(ImmutablePlan plan, int buildNumber) Remove any build logs stored for this plan result
void	removeBuildLogs(ImmutablePlan plan, int buildNumber, long maxIgnoredLogSize) Remove build logs stored for this plan result that are greater than given size (in bytes).
void	removeBuildLogs(ResultsSummary resultsSummary) Remove any build logs stored for this plan result
void	removeBuildLogs(ResultsSummary resultsSummary, long maxIgnoredLogSize) Remove build logs stored for this plan result that are greater than given size (in bytes).
void	removeMatchingArtifacts(ResultsSummary resultsSummary, com.google.common.base.Predicate<ArtifactLink> predicate) Remove artifacts from results summary that match a predicate.
void	removeMergeResultSummary(MergeResultSummary mergeResult) Removes merge result.
int	removeResultsSummariesForPlan(Plan plan) Remove all resultSummary objects for the given plan.
void	removeResultSummary(Plan plan, int buildNumber) Remove plan result summary and all associated objects.
void	removeResultSummary(Plan plan, ResultsSummary resultsSummary) Remove plan result summary and all associated objects.
ResultsSummary	resetResultSummary(BuildResultsSummary resultsSummary) Prepare result summry to be reuse for plan rerun
void	saveResultSummary(ResultsSummary resultsSummary) Saves the ResultsSummary
long	scrollResultSummaries(String buildKey, com.google.common.base.Function<ResultsSummary,Void> function) Scroll through and execute function for each of BuildResultsSummary Objects passed to function are not fully initialized.
long	scrollResultSummaries(String buildKey, ResultDataRead resultDataRead, com.google.common.base.Function<ResultsSummary,Void> function) Scroll through and execute function for each of ResultsSummary (Build and Chain) Objects passed to function are not fully initialized.
void	updateCancelledDetails(ResultsSummary resultsSummary) Deprecated. since 5.4 use com.atlassian.bamboo.resultsummary.ResultSummaryHelper#updateCancellationDetails(ResultsSummary, com.atlassian.bamboo.v2.build.BuildCancelledDetails) and saveResultSummary(ResultsSummary)
void	updateLifeCycleState(BuildContext buildContext, LifeCycleState lifeCycleState, BuildState buildState) Update LifeCycleState and saves the ResultsSummary for given BuildContext Updates also timing information
void	updateLifeCycleState(ResultsSummary resultsSummary, LifeCycleState lifeCycleState, BuildState buildState) Update LifeCycleState and saves the given ResultsSummary
void	updatePlanCompletedDate(ChainResultsSummary resultsSummary, Date completionDate) Update completed date and duration of ChainResultsSummary
void	updateProcessingDuration(ChainResultsSummary resultSummary) Updates ImmutableResultsSummary.getProcessingDuration() and ChainStageResult.getProcessingDuration() based on chain execution.
void	updateResultSummaryWithBuildChanges(BuildContext buildContext)
void	updateVariablesOnContinuedBuild(ResultsSummary resultsSummary, VariableContext variableContext) Add manual variables added when starting manual stage or restarting failed stage.

Method Detail

createResultsSummary

<T extends ResultsSummary> T createResultsSummary(@NotNull
                                                BuildContext buildContext,
                                                @NotNull
                                                Class<T> aClass)
                                              throws ResultsSummaryCreationException

Creates a ResultsSummary of the given Class

Type Parameters:

T -

Parameters:

buildContext -

aClass -

Returns:

resultsSummary

Throws:

ResultsSummaryCreationException

getResultsSummary

@Nullable
ResultsSummary getResultsSummary(@NotNull
                                        PlanResultKey planResultKey)

Lookup the ResultsSummary by PlanResultKey

Parameters:

planResultKey -

Returns:

resultsSummary

getResultsSummary

@Nullable
ResultsSummary getResultsSummary(long id)

Lookup the ResultsSummary by id

Parameters:

id - - database id

Returns:

resultsSummary

getResultsSummary

@Nullable
ResultsSummary getResultsSummary(@NotNull
                                        PlanResultKey planResultKey,
                                        ResultDataRead dataRead)

Lookup the ResultsSummary by PlanResultKey. All lazy initialized collections can be eagerly fetched to avoid session problems. Use with caution - expensive call

Parameters:

planResultKey -

dataRead -

Returns:

resultsSummary

getResultsSummary

@Nullable
<T extends ResultsSummary> T getResultsSummary(@NotNull
                                                      PlanResultKey planResultKey,
                                                      @NotNull
                                                      Class<T> aClass)

Lookup ResultsSummary by PlanResultKey and expected type

Type Parameters:

T -

Parameters:

planResultKey -

aClass -

Returns:

resultSummary

getResultsSummary

@Nullable
<T extends ResultsSummary> T getResultsSummary(@NotNull
                                                      PlanResultKey planResultKey,
                                                      @NotNull
                                                      Class<T> aClass,
                                                      ResultDataRead dataRead)

Lookup ResultsSummary by PlanResultKey and expected type. All lazy initialized collections can be eagerly fetched to avoid session problems. Use with caution - expensive call

Type Parameters:

T -

Parameters:

planResultKey -

aClass -

dataRead -

Returns:

resultSummary

updateLifeCycleState

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

Update LifeCycleState and saves the given ResultsSummary

Parameters:

resultsSummary - ResultsSummary to be updated and saved

lifeCycleState - LifeCycleState to be set

buildState - BuildState to be set

updateLifeCycleState

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

Update LifeCycleState and saves the ResultsSummary for given BuildContext Updates also timing information

Parameters:

buildContext - BuildContext used to get information on ResultsSummary

lifeCycleState - LifeCycleState to be set

buildState - BuildState to be set

updatePlanCompletedDate

void updatePlanCompletedDate(@NotNull
                           ChainResultsSummary resultsSummary,
                           @NotNull
                           Date completionDate)

Update completed date and duration of ChainResultsSummary

Parameters:

resultsSummary -

completionDate -

calculateAndSetDeltaState

void calculateAndSetDeltaState(ResultsSummary resultsSummary)

Figures out the delta state for the provided results summary, if a 'fixing' build will also calculate how long it took to fix. This method only updates the values on the provided results summary object, it does not save it to the database. Assumes buildState has already been set on resultsSummary.

Parameters:

resultsSummary - to update

saveResultSummary

void saveResultSummary(@NotNull
                     ResultsSummary resultsSummary)

Saves the ResultsSummary

Parameters:

resultsSummary -

addVariableContextSnapshotToResultSummary

void addVariableContextSnapshotToResultSummary(@NotNull
                                             ResultsSummary resultsSummary,
                                             @NotNull
                                             VariableContext variableContext)

Adds state of global and plan variables to result at the beginning of execution. If first argument is chain result, also adds snapshot of manual variables.

Parameters:

resultsSummary -

variableContext -

updateVariablesOnContinuedBuild

void updateVariablesOnContinuedBuild(@NotNull
                                   ResultsSummary resultsSummary,
                                   @NotNull
                                   VariableContext variableContext)

Add manual variables added when starting manual stage or restarting failed stage. Does nothing for job results.

Parameters:

resultsSummary -

variableContext -

clearVariablesOnRerunBuild

void clearVariablesOnRerunBuild(@NotNull
                              ResultsSummary resultSummary)

Clear stored stage manual variables when build is fully rerun. Does nothing for job results.

Parameters:

resultSummary -

postBuildVariableSnapshotUpdate

void postBuildVariableSnapshotUpdate(@NotNull
                                   ResultsSummary resultsSummary,
                                   @NotNull
                                   VariableContext variableContext)

Saves result variables produced in a job. Does nothing for chain results.

Parameters:

resultsSummary -

variableContext -

getAllPendingResultSummaries

@NotNull
<T extends ResultsSummary> Collection<T> getAllPendingResultSummaries(Class<T> aClass)

Returns all the ResultsSummary in a LifeCycleState.PENDING state

Returns:

pendingSummaries

getAllQueuedResultSummaries

@NotNull
<T extends ResultsSummary> Collection<T> getAllQueuedResultSummaries(Class<T> aClass)

Returns all the ResultsSummary in a LifeCycleState.QUEUED state

Returns:

summaries

getAllInProgressResultSummaries

@NotNull
<T extends ResultsSummary> Collection<T> getAllInProgressResultSummaries(Class<T> aClass)

Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state

Parameters:

aClass -

Returns:

summaries

getAllActiveResultSummariesForPlan

@NotNull
<T extends ResultsSummary> Collection<T> getAllActiveResultSummariesForPlan(PlanKey planKey,
                                                                                  Class<T> aClass)

Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state

Parameters:

aClass -

Returns:

summaries

getFinalizedResultSummariesForPlan

@NotNull
<T extends ResultsSummary> List<T> getFinalizedResultSummariesForPlan(PlanKey planKey,
                                                                            Class<T> aClass,
                                                                            int firstResult,
                                                                            int maxResults)

Returns all the ResultsSummary in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state with the given Class. Results are sorted descending by build number.

Type Parameters:

T -

Parameters:

planKey -

aClass -

firstResult - - specifies the first result to be included in the list.

maxResults - - specifies the length of the result; 0 for all results;

Returns:

getNeighbouringSummaries

@NotNull
List<ResultsSummary> getNeighbouringSummaries(Plan plan,
                                                    int buildNumber)

Returns all the ResultsSummary objects that matches the passed build numbers

Parameters:

plan -

buildNumber -

Returns:

List of BuildResultsSummary

getNeighbouringSummaries

@NotNull
List<ResultsSummary> getNeighbouringSummaries(ImmutablePlan plan,
                                                    int buildNumber,
                                                    int neighbouringSummariesMaxCount)

Returns all the ResultsSummary objects that matches the passed build numbers

Parameters:

plan -

buildNumber -

neighbouringSummariesMaxCount -

Returns:

List of BuildResultsSummary

getNumberOfConcurrentlyRunningBuilds

int getNumberOfConcurrentlyRunningBuilds(PlanKey planKey)

Gets the number of concurrently running builds

Parameters:

planKey -

Returns:

getAllBuildResultSummariesInUnknownState

@NotNull
<T extends ResultsSummary> Collection<T> getAllBuildResultSummariesInUnknownState(Class<T> aClass)

Returns all the BuildResultsSummary in a BuildState.UNKNOWN state

Returns:

summaries

findLastResultBefore

@Nullable
<T extends ResultsSummary> T findLastResultBefore(@NotNull
                                                         PlanResultKey planResultKey,
                                                         Class<T> aClass)

Finds the last successful or failing ResultsSummary before planResultKey.getBuildNumber

Parameters:

planResultKey -

aClass -

Returns:

findLastResultBefore

@Nullable
<T extends ResultsSummary> T findLastResultBefore(@NotNull
                                                         PlanResultKey planResultKey,
                                                         Class<T> aClass,
                                                         boolean includeOnceOffBuilds)

Finds the last ResultsSummary before planResultKey.getBuildNumber

Parameters:

planResultKey -

aClass -

includeOnceOffBuilds - - should we skip once-off builds or include them in the search

Returns:

getChainStageResultById

@Nullable
ChainStageResult getChainStageResultById(@NotNull
                                                Long id)

Returns a ChainStageResult by its id

Returns:

chainStageResult

getNumberOfResults

long getNumberOfResults()

Get number of all ResultsSummarys

Returns:

number of summaries

getNumberOfFinishedResults

long getNumberOfFinishedResults(@NotNull
                              Plan plan)

Get number of the ResultsSummarys in LifeCycleState.FINISHED state for the given Plan

Parameters:

plan -

Returns:

number of summaries

getNumberOfFinalizedResults

long getNumberOfFinalizedResults(@NotNull
                               ImmutablePlan plan)

Get number of the ResultsSummarys in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state for the given Plan

Parameters:

plan -

Returns:

number of summaries

getResultSummariesForPlan

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesForPlan(@NotNull
                                                                   ImmutablePlan plan,
                                                                   int firstResult,
                                                                   int maxResults)

Get the ResultsSummarys for the given Plan in any LifeCycleState. Results are sorted by build number (descending). User can skip first n result and request maximum number of results.

Type Parameters:

T -

Parameters:

plan -

firstResult - specifies the first item to be return (0 base index). Negative values treated as 0.

maxResults - specifies amount of the results to be returned. Value <= 0 returns everything.

Returns:

summaries

getResultSummariesForPlanByLifeCycleState

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesForPlanByLifeCycleState(@NotNull
                                                                                   Plan plan,
                                                                                   @NotNull
                                                                                   LifeCycleState lifeCycleState,
                                                                                   int firstResult,
                                                                                   int maxResults)

Get the ResultsSummarys for the given Plan in give LifeCycleState that are Results are sorted by build number (descending). User can skip first n result and request maximum number of results.

Type Parameters:

T -

Parameters:

plan -

lifeCycleState -

firstResult - specifies the first item to be return (0 base index). Negative values treated as 0.

maxResults - specifies amount of the results to be returned. Value <= 0 returns everything.

Returns:

summaries

getAveragePlanExecutionDuration

long getAveragePlanExecutionDuration(@NotNull
                                   ImmutablePlan plan,
                                   int numberOfResults)

Get average duration from n last results summaries in finished state for a plan. Results in SUCCESSFUL state are preferred; only if there are none those in FAILED state are selected.

Parameters:

plan -

numberOfResults - amount of results to be taken into account for average calculation

Returns:

average duration in milliseconds or 0 if there is no results

getLastResultsSummary

<T extends ResultsSummary> T getLastResultsSummary(@NotNull
                                                 String planKey,
                                                 Class<T> aClass)

Get the last ResultsSummary for planKey and Class

Type Parameters:

T -

Parameters:

planKey -

aClass -

Returns:

getLastSuccessfulResultSummary

@Nullable
ResultsSummary getLastSuccessfulResultSummary(@NotNull
                                                     PlanKey planKey)

Get the last successful ResultsSummary for planKey

Parameters:

planKey -

Returns:

removeResultsSummariesForPlan

int removeResultsSummariesForPlan(Plan plan)

Remove all resultSummary objects for the given plan. Time-cost of this method might be significant if there are thousands of ResultsSummary objects to be deleted in such case #scheduleResultsSummariesForDelayedDeletion(Plan) should be considered.

Parameters:

plan - to remove results for.

Returns:

number of ResultsSummarys removed

removeAllOrphanedResultSummaries

int removeAllOrphanedResultSummaries()

Removes all the ResultsSummary objects in the database that do not have a matching Plan

Returns:

number of ResultsSummarys removed

findFirstFailedBuildResultAfter

@Nullable
ResultsSummary findFirstFailedBuildResultAfter(@NotNull
                                                      String buildKey,
                                                      int buildNumber)

Finds the first failed ResultsSummary after buildNumber

Parameters:

buildKey -

buildNumber -

Returns:

buildResult

findFirstSuccessfulBuildResultAfter

@Nullable
@Deprecated
ResultsSummary findFirstSuccessfulBuildResultAfter(@NotNull
                                                                     String buildKey,
                                                                     int buildNumber)

Deprecated. since 5.2 use findFirstSuccessfulBuildResultAfter(PlanResultKey)

Finds the last successful ResultsSummary after buildNumber

Parameters:

buildKey -

buildNumber -

Returns:

buildResult

findFirstSuccessfulBuildResultAfter

@Nullable
ResultsSummary findFirstSuccessfulBuildResultAfter(@NotNull
                                                          PlanResultKey planResultKey)

Finds the last successful ResultsSummary after buildNumber

Parameters:

planResultKey -

Returns:

buildResult

findLastSuccessfulBuildResultBefore

@Deprecated
@Nullable
ResultsSummary findLastSuccessfulBuildResultBefore(@NotNull
                                                                     ImmutablePlan build,
                                                                     int buildNumber)

Deprecated. Use findLastSuccessfulBuildResultBefore(PlanResultKey) instead. Since v5.2.

Finds the last successful ResultsSummary before buildNumber

Parameters:

build -

buildNumber -

Returns:

buildResult

findLastSuccessfulBuildResultBefore

@Nullable
ResultsSummary findLastSuccessfulBuildResultBefore(@NotNull
                                                          PlanResultKey planResultKey)

Finds the last successful ResultsSummary before build

Parameters:

planResultKey -

Returns:

buildResult

findLastFailingBuildResultBefore

@Nullable
ResultsSummary findLastFailingBuildResultBefore(@NotNull
                                                       ImmutablePlan build,
                                                       int buildNumber)

Finds the last failing ResultsSummary before buildNumber

Parameters:

build -

buildNumber -

Returns:

buildResult

findFirstFailedBuildResultBetween

@Nullable
ResultsSummary findFirstFailedBuildResultBetween(@NotNull
                                                        ImmutablePlan build,
                                                        int lowerBuildNumber,
                                                        int upperBuildNumber)

Finds the first failed build between the upper and lower build numbers inclusively.

Parameters:

build -

lowerBuildNumber -

upperBuildNumber -

Returns:

buildResults

findLastBuildResultBefore

@Nullable
ResultsSummary findLastBuildResultBefore(@NotNull
                                                String buildKey,
                                                int buildNumber)

Finds the last successful or failing BuildResultsSummary before buildNumber

Parameters:

buildKey -

buildNumber -

Returns:

findLastBuildResultBeforeWithTests

@Nullable
<T extends ResultsSummary> T findLastBuildResultBeforeWithTests(@NotNull
                                                                       PlanResultKey planResultKey,
                                                                       @NotNull
                                                                       Class<T> aClass,
                                                                       boolean includeOnceOffBuilds)

Finds the last successful or failing BuildResultsSummary before buildNumber

Parameters:

planResultKey -

includeOnceOffBuilds - should once-off builds be considered or ignored in the search

aClass -

Returns:

resultsSummary

getBreakingBuild

@Nullable
ResultsSummary getBreakingBuild(ResultsSummary buildResultsSummary)

Returns the first failing build after the last successful build. ie the latest build before this one with the delta state "broken"

Parameters:

buildResultsSummary - of the current build

Returns:

null if there is no breaking build.

getFixingBuild

@Nullable
ResultsSummary getFixingBuild(ResultsSummary buildResultsSummary)

Returns the first successful ResultsSummary for given ResultsSummary. The input build is returned if it is successful.

Parameters:

buildResultsSummary -

Returns:

null if there is no fixing build.

updateCancelledDetails

@Deprecated
void updateCancelledDetails(@NotNull
                                     ResultsSummary resultsSummary)

Deprecated. since 5.4 use com.atlassian.bamboo.resultsummary.ResultSummaryHelper#updateCancellationDetails(ResultsSummary, com.atlassian.bamboo.v2.build.BuildCancelledDetails) and saveResultSummary(ResultsSummary)

getLatestResultSummaries

List<ResultsSummary> getLatestResultSummaries()

Retrieve list of build results (for all builds) in the last few days (number of days is specified in the DAO) This method is filtered to remove results that user doesn't have permission to see

Returns:

List of ResultsSummary

getLatestFailedResultSummaries

List<ResultsSummary> getLatestFailedResultSummaries()

Retrieve list of failed build results (for all builds) in the last few days (number of days is specified in the DAO) This method is filtered to remove results that user doesn't have permission to see

Returns:

List of ResultsSummary

getLastNResultsSummaries

@NotNull
List<ResultsSummary> getLastNResultsSummaries(@NotNull
                                                    ImmutablePlan plan,
                                                    int numberOfResults)

Provides a list of the latest N results summaries for the given plan, newest first.

Parameters:

plan - - to get the results for

numberOfResults - - number of summaries you would like

Returns:

list.

getLastNFailedResultsSummaries

@NotNull
List<ResultsSummary> getLastNFailedResultsSummaries(@NotNull
                                                          Plan build,
                                                          int numberOfResults)

Returns the most recent n failed build results. Sorted by newest first.

Parameters:

build -

numberOfResults - must be > 0

Returns:

getLastNBuildResultsSummaries

@NotNull
@Deprecated
List<BuildResultsSummary> getLastNBuildResultsSummaries(@NotNull
                                                                         ImmutableBuildable buildable,
                                                                         int numberOfResults)

Deprecated. since 2.7 use getLastNResultsSummaries(com.atlassian.bamboo.plan.cache.ImmutablePlan, int) instead

Returns the most recent n build results. Sorted by newest first.

Parameters:

buildable -

numberOfResults - must be > 0 @return

Returns:

the most recent n build results. Sorted by newest first.

getResultSummaries

@NotNull
<T extends ResultsSummary> List<T> getResultSummaries(@NotNull
                                                            ResultsSummaryCriteria criteria)

Generic search to find any result summaries bases on the criteria provided.

Parameters:

criteria - containing all the search constraints

Returns:

list of resultsSummaries matching the criteria.

getResultSummariesForExpiry

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesForExpiry(@NotNull
                                                                     ExpiryCriteria expiryCriteria)

Searches for result summaries according to the given criteria for use in build expiry.

Type Parameters:

T - type of returned results (determined by the criteria)

Parameters:

expiryCriteria - search constraints

Returns:

list of results summaries matching the criteria

findJiraIssuesForResults

@NotNull
List<LinkedJiraIssue> findJiraIssuesForResults(@NotNull
                                                     List<ResultsSummary> buildResults)

Retrieves a list of LinkedJiraIssue linked to the given build result summaries

Parameters:

buildResults - to look for issues attached to

Returns:

a list of LinkedJiraIssue linked to the given build result summaries

findJiraIssuesForPlan

@Deprecated
@NotNull
List<LinkedJiraIssue> findJiraIssuesForPlan(@NotNull
                                                             ImmutablePlan plan)

Deprecated. replaced by #findJiraIssuesForPlanKey(String)}

Retrieves a list of LinkedJiraIssue linked to the given Plan

Parameters:

plan - to look for issues associated with

Returns:

a list of LinkedJiraIssue linked to the given Plan

findJiraIssuesForPlanKey

@NotNull
List<LinkedJiraIssue> findJiraIssuesForPlanKey(@NotNull
                                                     PlanKey planKey)

Retrieves a list of LinkedJiraIssue linked to the given plan key

Parameters:

planKey - to look for issues associated with plan of this key

Returns:

a list of LinkedJiraIssue linked to the given Plan

findResultsSummariesByJiraIssues

@NotNull
List<? extends ResultsSummary> findResultsSummariesByJiraIssues(@Nullable
                                                                      List<String> issueKeys)

Finds a list of results which are linked to the given issue keys

Parameters:

issueKeys - to search for

Returns:

al list of ResultsSummary associated with any of the given list of issue keys

findResultsSummariesByProjectKey

@NotNull
List<? extends ResultsSummary> findResultsSummariesByProjectKey(@Nullable
                                                                      String projectKey)

Provide a list of results which are linked to any issues under the given jira project key

Parameters:

projectKey - - jira project key

Returns:

a list of results which are linked to any issues under the given jira project key

getAllBuildResultsSummariesForAgent

@NotNull
List<BuildResultsSummary> getAllBuildResultsSummariesForAgent(@NotNull
                                                                    Long agentId)

Returns all BuildResultsSummary for the passed BuildAgent's id.

Parameters:

agentId - id of the agent to get the result summaries for

Returns:

all BuildResultsSummary for the passed BuildAgent's id.

getLatestSummariesForAgent

@NotNull
List<BuildResultsSummary> getLatestSummariesForAgent(@NotNull
                                                           Long agentId,
                                                           @NotNull
                                                           Date fromDate)

Retrieves build summaries for agent id not older than certain date.

Parameters:

agentId - id of an agent

fromDate - beginning of the search period

Returns:

List of BuildResultsSummary

getLatestSummariesForAgent

@NotNull
List<BuildResultsSummary> getLatestSummariesForAgent(@NotNull
                                                           Long agentId,
                                                           int maxCount)

Retrieves n last build summaries for agent.

Parameters:

agentId - id of an agent

maxCount - maximum number of elements to retrieve

Returns:

List of BuildResultsSummary

getLatestSummaryForAgent

@Nullable
BuildResultsSummary getLatestSummaryForAgent(long agentId)

getParentResultSummary

@Nullable
ChainResultsSummary getParentResultSummary(ResultsSummary resultsSummary)

Get (@link ChainResultsSummary} containing given ResultsSummary

Parameters:

resultsSummary -

Returns:

getStageForResult

@Nullable
ChainStageResult getStageForResult(ResultsSummary resultsSummary)

Get (@link ChainStageResult} containing given ResultsSummary

Parameters:

resultsSummary -

Returns:

removeResultSummary

void removeResultSummary(@NotNull
                       Plan plan,
                       int buildNumber)

Remove plan result summary and all associated objects.

Parameters:

plan -

buildNumber -

removeResultSummary

void removeResultSummary(@NotNull
                       Plan plan,
                       @NotNull
                       ResultsSummary resultsSummary)

Remove plan result summary and all associated objects.

Parameters:

plan -

resultsSummary -

removeArtifacts

void removeArtifacts(@NotNull
                   ImmutablePlan plan,
                   int buildNumber)

Remove any artifacts stored for this plan result

Parameters:

plan -

buildNumber -

removeArtifacts

void removeArtifacts(@NotNull
                   ResultsSummary resultsSummary)

Remove any artifacts stored for this plan result

Parameters:

resultsSummary -

removeMatchingArtifacts

void removeMatchingArtifacts(@NotNull
                           ResultsSummary resultsSummary,
                           @NotNull
                           com.google.common.base.Predicate<ArtifactLink> predicate)

Remove artifacts from results summary that match a predicate.

Parameters:

resultsSummary -

predicate -

removeBuildLogs

void removeBuildLogs(ImmutablePlan plan,
                   int buildNumber)

Remove any build logs stored for this plan result

Parameters:

plan -

buildNumber -

removeBuildLogs

void removeBuildLogs(@NotNull
                   ResultsSummary resultsSummary)

Remove any build logs stored for this plan result

Parameters:

resultsSummary -

removeBuildLogs

void removeBuildLogs(ImmutablePlan plan,
                   int buildNumber,
                   long maxIgnoredLogSize)

Remove build logs stored for this plan result that are greater than given size (in bytes).

Parameters:

plan -

buildNumber -

maxIgnoredLogSize -

removeBuildLogs

void removeBuildLogs(@NotNull
                   ResultsSummary resultsSummary,
                   long maxIgnoredLogSize)

Remove build logs stored for this plan result that are greater than given size (in bytes).

Parameters:

resultsSummary -

maxIgnoredLogSize -

findChainResultsWithJobLabelled

List<ChainResultsSummary> findChainResultsWithJobLabelled(ResultsSummaryCriteria criteria,
                                                        List<Label> labels)

Searches through all chains to find any that have jobs which match the given labels. The list of chains is then filtered if required, using other criteria elements. Currently the only used criteria are:

buildKey toBuildDate toBuildNumber This is to ensure performance is consistant and reduce the possibility of conflicts.

Parameters:

criteria - containing the restrictions for the chains to be returned

labels - that the jobs can be associated with

Returns:

list of ChainResultSummary that match the criteria and have jobs with any of the given labels

moveResultSummaries

@Deprecated
void moveResultSummaries(PlanKey oldPlanKey,
                                  PlanKey newPlanKey)

Deprecated. since 3.2, use moveResultSummaries(Plan, PlanKey, PlanKey)

Reassigns plan key ResultsSummaries associated with selected plan key.

moveResultSummaries

void moveResultSummaries(@NotNull
                       Plan newParentPlan,
                       @NotNull
                       PlanKey oldPlanKey,
                       @NotNull
                       PlanKey newPlanKey)

Reassigns plan key ResultsSummaries associated with selected plan key.

Parameters:

newParentPlan - the new parent plan of result summaries. This should be a plan, not a job.

scrollResultSummaries

long scrollResultSummaries(@NotNull
                         String buildKey,
                         @NotNull
                         com.google.common.base.Function<ResultsSummary,Void> function)

Scroll through and execute function for each of BuildResultsSummary Objects passed to function are not fully initialized. Collections are empty and related objects have only id set.

Parameters:

buildKey - of the plan you want to scroll the result summaries for

function - function to be executed on each of the BuildResultSummary

Returns:

number of traversed rows

scrollResultSummaries

long scrollResultSummaries(@NotNull
                         String buildKey,
                         ResultDataRead resultDataRead,
                         @NotNull
                         com.google.common.base.Function<ResultsSummary,Void> function)

Scroll through and execute function for each of ResultsSummary (Build and Chain) Objects passed to function are not fully initialized. Collections are empty and related objects have only id set.

Parameters:

buildKey - of the plan you want to scroll the result summaries for

resultDataRead - if the data should be loaded lazy or eagerly

function - function to be executed on each of the BuildResultSummary

Returns:

number of traversed rows

findFirstResultAfter

@Nullable
<T extends ResultsSummary> T findFirstResultAfter(@NotNull
                                                         PlanResultKey planResultKey,
                                                         Class<T> aClass)

Finds the first ResultsSummary after a specified build which is either FINISHED or can be FINISHED, i.e. is not in NOT_BUILT state.

Parameters:

planResultKey -

aClass -

Returns:

findLastResultSummaryWithState

@Nullable
<T extends ResultsSummary> T findLastResultSummaryWithState(@NotNull
                                                                   PlanKey planKey,
                                                                   @NotNull
                                                                   BuildState buildState,
                                                                   @NotNull
                                                                   Class<T> aClass)

Type Parameters:

T -

Parameters:

planKey -

buildState -

aClass -

Returns:

the last ResultsSummary with the provided BuildState

getResultSummariesByChangeSetId

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesByChangeSetId(@NotNull
                                                                         String changeSetId,
                                                                         @NotNull
                                                                         Class<T> discriminator)

Get a list of all build results containing a commit with the given change set ID.

Type Parameters:

T - extends ResultSummary

Parameters:

changeSetId - of the commit

discriminator - class of the ResultSummary interface required

Returns:

List of ResultsSummary (ResultSummary as determined by discriminator) containing a commit with the given changeSetId

getResultSummariesByChangeSetIdAndRepository

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesByChangeSetIdAndRepository(long repositoryId,
                                                                                      @NotNull
                                                                                      String changeSetId,
                                                                                      @NotNull
                                                                                      Class<T> discriminator)

Get a list of all build results containing a commit with the given change set ID that are in the given repository.

Type Parameters:

T - extends ResultSummary

Parameters:

repositoryId - of the repository

changeSetId - of the commit

discriminator - class of the ResultSummary interface required

Returns:

List of ResultsSummary (ResultSummary as determined by discriminator) containing a commit with the given changeSetId

Since:

5.7

getResultSummariesByChangeSetIds

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesByChangeSetIds(@NotNull
                                                                          List<String> changeSetIds,
                                                                          Class<T> discriminator)

Get a list of all build results containing a commit with any of the given change set IDs.

Type Parameters:

T - extends ResultSummary

Parameters:

changeSetIds - of the commit

discriminator - class of the ResultSummary interface required

Returns:

List of ResultsSummary (ResultSummary as determined by discriminator) containing a commit with any of the given changeSetIds

getResultSummariesByChangeSetIds

@NotNull
<T extends ResultsSummary> List<T> getResultSummariesByChangeSetIds(@NotNull
                                                                          Iterable<Pair<String,RepositoryData>> changeSetIds,
                                                                          Class<T> discriminator)

Get a list of all build results containing a commit with any of the given change set IDs and which are in the supplied list of repository datas.

Type Parameters:

T - extends ResultSummary

Parameters:

changeSetIds - of the commit anding with the repository that commit came from

discriminator - class of the ResultSummary interface required

Returns:

List of ResultsSummary (ResultSummary as determined by discriminator) containing a commit with any of the given changeSetIds

getCommitsForUser

@NotNull
List<UnassociatedCommit> getCommitsForUser(@NotNull
                                                 String username,
                                                 int max)

Retrieve a list of recent Commits for the given user. Items in the collection are unique and sorted by date.

Parameters:

username - to filter commits by

max - maximum number of commits to get.

Returns:

a list of recent Commits for the given user

countResultsWithState

int countResultsWithState(@NotNull
                        PlanKey planKey,
                        int lowerBuildNumber,
                        int upperBuildNumber,
                        @NotNull
                        BuildState buildState)

Counts results with a given state in a given build number range for plan.

Parameters:

planKey - the key of plan to analyse

lowerBuildNumber - the build number to start the count with

upperBuildNumber - the build number to end the count with

buildState - the state that will be counted

Returns:

the count

logVariablesForSubstitution

void logVariablesForSubstitution(@NotNull
                               BuildContext buildContext,
                               @NotNull
                               ResultsSummary resultsSummary)

Adds expected variable substitution to ResultsSummary This method logs substitution before build was performed and is used basically to log substitution against plan result as there will be no possibility to track it afterwards

logSubstitutedVariables

void logSubstitutedVariables(@NotNull
                           BuildContext buildContext,
                           @NotNull
                           ResultsSummary resultsSummary)

Adds variable substitution result to ResultsSummary This method logs substitution after it was performed and will use only REALLY substituted values

updateProcessingDuration

void updateProcessingDuration(ChainResultsSummary resultSummary)

Updates ImmutableResultsSummary.getProcessingDuration() and ChainStageResult.getProcessingDuration() based on chain execution.

Parameters:

resultSummary -

markResultSummariesForDeletion

int markResultSummariesForDeletion(@NotNull
                                 PlanKey planKey)

Mass update of all ResultsSummary records in the database related to a Plan identified by planKey.

Parameters:

planKey - key of a plan

Returns:

number of updated records

updateResultSummaryWithBuildChanges

void updateResultSummaryWithBuildChanges(@NotNull
                                       BuildContext buildContext)
                                         throws ResultsSummaryCreationException

Throws:

ResultsSummaryCreationException

resetResultSummary

ResultsSummary resetResultSummary(@NotNull
                                BuildResultsSummary resultsSummary)

Prepare result summry to be reuse for plan rerun

Parameters:

resultsSummary -

Returns:

removeMergeResultSummary

void removeMergeResultSummary(@NotNull
                            MergeResultSummary mergeResult)

Removes merge result. Use with care.

Since:

5.0

getPlanKeysSortedByNumberOfFinalizedResultSummaries

@Internal
@NotNull
List<PlanKey> getPlanKeysSortedByNumberOfFinalizedResultSummaries()

calculateQueueDuration

@Nullable
Long calculateQueueDuration(@NotNull
                                   ChainResultsSummary resultsSummary)

Calculates queueDuration value for a chain result as a maximum value of (vcsUpdateTime - queueTime) for all related job results.

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

queueDuration value or null if there are no related BuildResultsSummary records

Since:

5.4

calculateVcsUpdateDuration

@Nullable
Long calculateVcsUpdateDuration(@NotNull
                                       ChainResultsSummary resultsSummary)

Calculates vcsUpdateDuration value for a chain result as a maximum value of (buildDate - vcsUpdateTime) for all related job results.

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

vcsUpdateDuration value or null if there are no related BuildResultsSummary records

Since:

5.4

findAllBuildResultsNumbers

@NotNull
List<Integer> findAllBuildResultsNumbers(PlanKey planKey)

invalidateLogSize

void invalidateLogSize(@NotNull
                     PlanResultKey planResultKey)

Invalidates the log size of a ResultsSummary with the given PlanResultKey.

For a BuildResultsSummary the ChainResultsSummary's max log size will also be invalidated.

Parameters:

planResultKey - result key