Package com.atlassian.bamboo.resultsummary

Class BuildResultsSummaryManagerImpl

java.lang.Object

com.atlassian.bamboo.resultsummary.BuildResultsSummaryManagerImpl

All Implemented Interfaces:

BuildResultsSummaryManager, ResultsSummaryManager

public class BuildResultsSummaryManagerImpl
extends Object
implements BuildResultsSummaryManager, ResultsSummaryManager

Constructor Summary

Constructors

Constructor	Description
BuildResultsSummaryManagerImpl()

Method Summary

Modifier and Type	Method	Description
void	addVariableContextSnapshotToResultSummary(@NotNull ResultsSummary resultsSummary, @NotNull 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.
@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.
@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.
void	cleanPendingLifeCycleState(@NotNull PlanResultKey planResultKey)	Cleans state of pending result.
void	clearVariablesOnRerunBuild(@NotNull ResultsSummary resultsSummary)	Clear stored stage manual variables when build is fully rerun.
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.
<T extends ResultsSummary> T	createResultsSummary(@NotNull BuildContext buildContext, @NotNull Class<T> aClass)	Creates a ResultsSummary of the given Class
<T extends ResultsSummary> T	createResultsSummary(@Nullable ChainResultsSummary chainResultsSummary, @NotNull BuildContext buildContext, @NotNull Class<T> aClass)
@NotNull List<Integer>	findAllBuildResultsNumbers(PlanKey planKey)
@NotNull Range<Integer>	findBuildResultNumbersRange(@NotNull PlanKey planKey)	Finds minimum and maximum build number for a plan.
@NotNull List<PlanResultKey>	findChainResultsWithFormatVersionLessThan(int formatVersion, int maxResults)
List<ChainResultsSummary>	findChainResultsWithJobLabelled(ResultsSummaryCriteria criteria, List<Label> labels)	Searches through all chains to find any that have jobs which match the given labels.
@Nullable ResultsSummary	findFirstFailedBuildResultAfter(@NotNull String buildKey, int buildNumber)	Finds the first failed ResultsSummary after buildNumber
@Nullable ResultsSummary	findFirstFailedBuildResultBetween(@NotNull ImmutablePlan build, int lowerBuildNumber, int upperBuildNumber)	Finds the first failed build between the upper and lower build numbers inclusively.
@Nullable ResultsSummary	findFirstFailedBuildResultBetween(@NotNull PlanKey planKey, int lowerBuildNumber, int upperBuildNumber)	Finds the first failed build between the upper and lower build numbers inclusively.*
<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.
@Nullable ResultsSummary	findFirstSuccessfulBuildResultAfter(@NotNull PlanResultKey planResultKey)	Finds the last successful ResultsSummary after buildNumber
@NotNull List<LinkedJiraIssue>	findJiraIssuesForPlanKey(@NotNull PlanKey planKey)	Retrieves a list of LinkedJiraIssue linked to the given plan key
@NotNull List<LinkedJiraIssue>	findJiraIssuesForResults(@NotNull List<ResultsSummary> buildResults)	Retrieves a list of LinkedJiraIssue linked to the given build result summaries
@NotNull List<PlanKey>	findJobKeysFromExistingChainResults(@NotNull PlanKey chainKey)	Find keys of jobs for which results associated with given plan exist.
@Nullable ResultsSummary	findLastBuildResultBefore(@NotNull String buildKey, int buildNumber)	Finds the last successful or failing BuildResultsSummary before buildNumber
<T extends ResultsSummary> T	findLastBuildResultBeforeWithTests(@NotNull PlanResultKey planResultKey, @NotNull Class<T> aClass, boolean includeOnceOffBuilds)	Finds the last successful or failing BuildResultsSummary before buildNumber
@Nullable ResultsSummary	findLastFailingBuildResultBefore(@NotNull ImmutablePlan build, int buildNumber)	Finds the last failing ResultsSummary before buildNumber
@Nullable ResultsSummary	findLastFailingBuildResultBefore(@NotNull PlanKey planKey, int buildNumber)	Finds the last failing ResultsSummary before buildNumber
<T extends ResultsSummary> T	findLastResultBefore(@NotNull PlanResultKey planResultKey, Class<T> aClass)	Finds the last successful or failing ResultsSummary before planResultKey.getBuildNumber
<T extends ResultsSummary> T	findLastResultBefore(@NotNull PlanResultKey planResultKey, Class<T> aClass, boolean includeOnceOffBuilds)	Finds the last ResultsSummary before planResultKey.getBuildNumber
<T extends ResultsSummary> T	findLastResultSummaryWithState(@NotNull PlanKey planKey, @NotNull BuildState buildState, @NotNull Class<T> aClass)
<T extends ResultsSummary> T	findLastResultSummaryWithState(@NotNull PlanKey planKey, @NotNull BuildState buildState, @NotNull Class<T> aClass, boolean ignoreSpecsResults)
@Nullable ResultsSummary	findLastSuccessfulBuildResultBefore(@NotNull PlanResultKey planResultKey)	Finds the last successful ResultsSummary before build
@Nullable ResultsSummary	findLastSuccessfulBuildResultBefore(@NotNull PlanResultKey planResultKey, boolean includeOnceOffBuilds)	Finds the last successful ResultsSummary before build
int	findMinimumBuildNumberForNLatest(@NotNull PlanKey planKey, int n)	Find a build number for which exist n non-specs results with a build number greater or equal.
@NotNull List<? extends ResultsSummary>	findResultsSummariesByJiraIssues(@Nullable List<String> issueKeys)	Finds a list of results which are linked to the given issue keys
@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
@NotNull List<ResultsSummary>	getAfterSummaries(@NotNull ImmutablePlan plan, int buildNumber, int maxCount)	Returns all the ResultsSummary objects that represent build results strictly after the given build number.
<T extends ResultsSummary> @NotNull Collection<T>	getAllActiveResultSummariesForPlan(PlanKey planKey, Class<T> aClass)	Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state
<T extends ResultsSummary> @NotNull Collection<T>	getAllBuildResultSummariesInUnknownState(Class<T> aClass)	Returns all the BuildResultsSummary in a BuildState.UNKNOWN state
<T extends ResultsSummary> @NotNull Collection<T>	getAllInProgressResultSummaries(Class<T> aClass)	Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state
<T extends ResultsSummary> @NotNull Collection<T>	getAllPendingResultSummaries(Class<T> aClass)	Returns all the ResultsSummary in a LifeCycleState.PENDING state
<T extends ResultsSummary> @NotNull Collection<T>	getAllQueuedResultSummaries(Class<T> aClass)	Returns all the ResultsSummary in a LifeCycleState.QUEUED state
<T extends ResultsSummary> T	getAnyResultSummary(@NotNull ResultsSummaryCriteria criteria, ResultDataRead dataRead)	Generic search to find any result summary basing on the criteria provided.
long	getAveragePlanExecutionDuration(@NotNull ImmutablePlan plan, int numberOfResults)	Get average duration from n last results summaries in finished state for a plan.
@NotNull List<ResultsSummary>	getBeforeSummaries(@NotNull ImmutablePlan plan, int buildNumber, int maxCount)	Returns all the ResultsSummary objects that represent build results strictly before the given build number.
@Nullable ResultsSummary	getBreakingBuild(ResultsSummary buildResultsSummary)	Returns the first failing build after the last successful build.
@Nullable ChainStageResult	getChainStageResultById(@NotNull Long id)	Returns a ChainStageResult by its id
@NotNull List<UnassociatedCommit>	getCommitsForUser(@NotNull String username, int max)	Retrieve a list of recent Commits for the given user.
<T extends ResultsSummary> @NotNull 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.
@Nullable ResultsSummary	getFixingBuild(ResultsSummary buildResultsSummary)	Returns the first successful ResultsSummary for given ResultsSummary.
@NotNull List<ResultsSummary>	getLastNFailedResultsSummaries(@NotNull PlanIdentifier planIdentifier, int numberOfResults)	Returns the most recent n failed build results.
@NotNull List<ResultsSummary>	getLastNResultsSummaries(@NotNull PlanIdentifier planIdentifier, int numberOfResults)	Provides a list of the latest N results summaries for the given plan, newest first.
<T extends ResultsSummary> T	getLastResultsSummary(@NotNull String planKey, Class<T> aClass)	Get the last ResultsSummary for planKey and Class
<T extends ResultsSummary> T	getLastResultsSummary(@NotNull String planKey, Class<T> aClass, boolean ignoreSpecsResults)	Get the last ResultsSummary for planKey and Class with possible skip of specs results.
ResultsSummary	getLastSuccessfulResultSummary(@NotNull 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
@NotNull List<ResultsSummary>	getNeighbouringSummaries(@NotNull ImmutablePlan plan, int buildNumber, int maxCount)	Returns all the ResultsSummary objects that represent build results "around" the given build number.
@NotNull 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(@NotNull ImmutablePlan plan)	Get number of the ResultsSummarys in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state for the given Plan
long	getNumberOfFinalizedResults(@NotNull PlanKey planKey)	Get number of the ResultsSummarys in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state for the given Plan
long	getNumberOfFinishedResults(@NotNull Plan plan)	Get number of the ResultsSummarys in LifeCycleState.FINISHED state for the given Plan
long	getNumberOfResults()	Get number of all ResultsSummarys
@Nullable ChainResultsSummary	getParentResultSummary(ResultsSummary resultsSummary)	Get (@link ChainResultsSummary} containing given ResultsSummary
@NotNull List<PlanKey>	getPlanKeysSortedByNumberOfFinalizedResultSummaries()
ResultsSummary	getResultsSummary(long id)	Lookup the ResultsSummary by id
@Nullable ResultsSummary	getResultsSummary(@NotNull PlanResultKey planResultKey)	Lookup the ResultsSummary by PlanResultKey
<T extends ResultsSummary> T	getResultsSummary(@NotNull PlanResultKey planResultKey, @NotNull Class<T> aClass)	Lookup ResultsSummary by PlanResultKey and expected type
<T extends ResultsSummary> T	getResultsSummary(@NotNull PlanResultKey planResultKey, @NotNull Class<T> aClass, ResultDataRead dataRead)	Lookup ResultsSummary by PlanResultKey and expected type.
@Nullable ResultsSummary	getResultsSummary(@NotNull PlanResultKey planResultKey, ResultDataRead dataRead)	Lookup the ResultsSummary by PlanResultKey.
<T extends ResultsSummary> @NotNull List<T>	getResultSummaries(@NotNull ResultsSummaryCriteria resultsSummaryCriteria)	Generic search to find any result summaries basing on the criteria provided.
<T extends ResultsSummary> @NotNull List<T>	getResultSummariesByChangeSetId(@NotNull String changeSetId, @NotNull Class<T> discriminator)	Get a list of all build results containing a commit with the given changeset ID.
<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 changeset ID that are in the given repository.
<T extends ResultsSummary> @NotNull 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 changeset IDs and which are in the supplied list of repository datas.
<T extends ResultsSummary> @NotNull 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 changeset IDs.
<T extends ResultsSummary> @NotNull List<T>	getResultSummariesByCheckoutChangesetId(@NotNull String changeSetId, @NotNull Class<T> discriminator)	Get a list of all build results containing repositories checked out with the given changeset ID.
<T extends ResultsSummary> @NotNull List<T>	getResultSummariesForExpiry(@NotNull ExpiryCriteria expiryCriteria)	Searches for result summaries according to the given criteria for use in build expiry.
<T extends ResultsSummary> @NotNull List<T>	getResultSummariesForPlan(@NotNull ImmutablePlan plan, int firstResult, int maxResults)	Get the ResultsSummarys for the given Plan in any LifeCycleState.
<T extends ResultsSummary> @NotNull 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).
@Nullable ChainStageResult	getStageForResult(ResultsSummary resultsSummary)	Get (@link ChainStageResult} containing given ResultsSummary
protected void	init()
void	invalidateLogSize(@NotNull PlanResultKey planResultKey)	Invalidates the log size of a ResultsSummary with the given PlanResultKey.
int	markResultSummariesForDeletion(@NotNull PlanKey planKey)	Mass update of all ResultsSummary records in the database related to a Plan identified by planKey.
void	moveResultSummaries(@NotNull Plan newParentPlan, @NotNull PlanKey oldPlanKey, @NotNull PlanKey newPlanKey)	Reassigns plan key ResultsSummaries associated with selected plan key.
void	postBuildVariableSnapshotUpdate(@NotNull ResultsSummary resultsSummary, @NotNull 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(@NotNull ImmutablePlan plan, int buildNumber)	Remove any artifacts stored for this plan result
void	removeArtifacts(@NotNull ResultsSummary resultsSummary)	Remove any artifacts stored for this plan result
void	removeBuildLogs(@NotNull ResultsSummary resultsSummary)	Remove any build logs stored for this plan result
void	removeBuildLogs(@NotNull ResultsSummary resultsSummary, long maxIgnoredSize)	Remove build logs stored for this plan result that are greater than given size (in bytes).
void	removeBuildLogs(ImmutablePlan plan, int buildNumber)	Remove any build logs stored for this plan result
void	removeBuildLogs(ImmutablePlan plan, int buildNumber, long maxIgnoredSize)	Remove build logs stored for this plan result that are greater than given size (in bytes).
void	removeMatchingArtifacts(@NotNull ResultsSummary resultsSummary, @NotNull Predicate<ArtifactLink> predicate)	Remove artifacts from results summary that match a predicate.
void	removeMergeResultSummary(@NotNull MergeResultSummary mergeResult)	Removes merge result.
int	removeResultsSummariesForPlan(@NotNull Plan plan)	Remove all resultSummary objects for the given plan.
void	removeResultSummary(@NotNull ImmutablePlan plan, int buildNumber)	Remove plan result summary and all associated objects.
void	removeResultSummary(@NotNull PlanResultKey planResultKey)	Remove plan result summary and all associated objects.
void	removeResultSummary(@NotNull ResultsSummary resultsSummary)	Remove plan result summary and all associated objects.
void	removeResultSummary(@Nullable ImmutablePlan plan, @NotNull ResultsSummary resultsSummary)	Remove plan result summary and all associated objects.
ResultsSummary	resetResultSummary(@NotNull BuildResultsSummary resultsSummary)	Prepare result summry to be reuse for plan rerun
void	saveResultSummary(@NotNull ResultsSummary resultsSummary)	Saves the ResultsSummary
long	scrollResultSummaries(@NotNull String buildKey, @NotNull Function<ResultsSummary,Void> function)	Scroll through and execute function for each of BuildResultsSummary Objects passed to function are not fully initialized.
long	scrollResultSummaries(@NotNull String buildKey, ResultDataRead resultDataRead, @NotNull 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	setArtifactLinkManager(ArtifactLinkManager artifactLinkManager)
void	setBranchIntegrationService(BranchIntegrationService branchIntegrationService)
void	setBuildExecutionManager(BuildExecutionManager buildExecutionManager)
void	setBuildResultsSummaryDao(BuildResultsSummaryDao buildResultsSummaryDao)
void	setCommentManager(CommentManager commentManager)
void	setCommitDao(CommitDao commitDao)
void	setEventPublisher(com.atlassian.event.api.EventPublisher eventPublisher)
void	setExtendedAuthorManager(ExtendedAuthorManager extendedAuthorManager)
void	setJiraIssueUtils(JiraIssueUtils jiraIssueUtils)
void	setMergeResultSummaryDao(MergeResultSummaryDao mergeResultSummaryDao)
void	setPlanManager(PlanManager planManager)
void	setRepositoryDefinitionManager(RepositoryDefinitionManager repositoryDefinitionManager)
void	setVariableContextBaselineDao(VariableContextBaselineDao variableContextBaselineDao)
void	setVcsRepositoryManager(VcsRepositoryManager vcsRepositoryManager)
@NotNull BuildResultsSummary	updateBuildSummaryFromBuildResults(BuildContext buildContext, @NotNull CurrentlyBuilding currentlyBuilding, BuildResults buildResults)	Updates BuildResultsSummary after build is completed.
void	updateLifeCycleState(@NotNull ResultsSummary resultsSummary, @NotNull LifeCycleState lifeCycleState, @NotNull BuildState buildState)	Update LifeCycleState and saves the given ResultsSummary
void	updateLifeCycleState(@NotNull BuildIdentifier buildIdentifier, @NotNull LifeCycleState lifeCycleState, @NotNull BuildState buildState)	Update LifeCycleState and saves the ResultsSummary for given BuildContext Updates also timing information
void	updateLifeCycleState(@NotNull CurrentlyBuilding currentlyBuilding, @NotNull LifeCycleState lifeCycleState, @NotNull BuildState buildState)	Update LifeCycleState and saves the ResultsSummary for given BuildContext Updates also timing information.
void	updatePlanCompletedDate(@NotNull ChainResultsSummary resultSummary, @NotNull 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(@NotNull BuildContext buildContext)
void	updateVariablesOnContinuedBuild(@NotNull ResultsSummary resultsSummary, @NotNull VariableContext variableContext)	Add manual variables added when starting manual stage or restarting failed stage.

Methods inherited from class java.lang.Object

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

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

getLastNFailedResultsSummaries, getLastNResultsSummaries

Constructor Details

BuildResultsSummaryManagerImpl

public BuildResultsSummaryManagerImpl()

Method Details

init

@PostConstruct
protected void init()

getResultSummariesForPlanByLifeCycleState

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

Description copied from interface: ResultsSummaryManager

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.

Specified by:

getResultSummariesForPlanByLifeCycleState in interface ResultsSummaryManager

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

getResultSummariesForPlan

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

Description copied from interface: ResultsSummaryManager

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.

Specified by:

getResultSummariesForPlan in interface ResultsSummaryManager

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

getChainStageResultById

@Nullable
public @Nullable ChainStageResult getChainStageResultById(@NotNull
 @NotNull Long id)

Description copied from interface: ResultsSummaryManager

Returns a ChainStageResult by its id

Specified by:

getChainStageResultById in interface ResultsSummaryManager

Returns:

chainStageResult

getResultsSummary

@Nullable
public @Nullable ResultsSummary getResultsSummary(@NotNull
 @NotNull PlanResultKey planResultKey)

Description copied from interface: ResultsSummaryManager

Lookup the ResultsSummary by PlanResultKey

Specified by:

getResultsSummary in interface ResultsSummaryManager

Returns:

resultsSummary

getResultsSummary

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultsSummary in interface ResultsSummaryManager

Returns:

resultsSummary

getResultsSummary

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

Description copied from interface: ResultsSummaryManager

Lookup ResultsSummary by PlanResultKey and expected type

Specified by:

getResultsSummary in interface ResultsSummaryManager

Returns:

resultSummary

getResultsSummary

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultsSummary in interface ResultsSummaryManager

Returns:

resultSummary

getResultsSummary

public ResultsSummary getResultsSummary(long id)

Description copied from interface: ResultsSummaryManager

Lookup the ResultsSummary by id

Specified by:

getResultsSummary in interface ResultsSummaryManager

Parameters:

id - - database id

Returns:

resultsSummary

resetResultSummary

public ResultsSummary resetResultSummary(@NotNull
 @NotNull BuildResultsSummary resultsSummary)
                                  throws IOException

Description copied from interface: ResultsSummaryManager

Prepare result summry to be reuse for plan rerun

Specified by:

resetResultSummary in interface ResultsSummaryManager

Returns:

Throws:

IOException

addVariableContextSnapshotToResultSummary

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

Description copied from interface: ResultsSummaryManager

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.

Specified by:

addVariableContextSnapshotToResultSummary in interface ResultsSummaryManager

updateVariablesOnContinuedBuild

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

updateVariablesOnContinuedBuild in interface ResultsSummaryManager

clearVariablesOnRerunBuild

public void clearVariablesOnRerunBuild(@NotNull
 @NotNull ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

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

Specified by:

clearVariablesOnRerunBuild in interface ResultsSummaryManager

postBuildVariableSnapshotUpdate

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

postBuildVariableSnapshotUpdate in interface ResultsSummaryManager

getAllPendingResultSummaries

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

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary in a LifeCycleState.PENDING state

Specified by:

getAllPendingResultSummaries in interface ResultsSummaryManager

Returns:

pendingSummaries

getAllQueuedResultSummaries

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

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary in a LifeCycleState.QUEUED state

Specified by:

getAllQueuedResultSummaries in interface ResultsSummaryManager

Returns:

summaries

getAllInProgressResultSummaries

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

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state

Specified by:

getAllInProgressResultSummaries in interface ResultsSummaryManager

Returns:

summaries

getAllActiveResultSummariesForPlan

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

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state

Specified by:

getAllActiveResultSummariesForPlan in interface ResultsSummaryManager

Returns:

summaries

getFinalizedResultSummariesForPlan

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getFinalizedResultSummariesForPlan in interface ResultsSummaryManager

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

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

Returns:

getNumberOfConcurrentlyRunningBuilds

public int getNumberOfConcurrentlyRunningBuilds(PlanKey planKey)

Description copied from interface: ResultsSummaryManager

Gets the number of concurrently running builds

Specified by:

getNumberOfConcurrentlyRunningBuilds in interface ResultsSummaryManager

Returns:

getAllBuildResultSummariesInUnknownState

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

Description copied from interface: ResultsSummaryManager

Returns all the BuildResultsSummary in a BuildState.UNKNOWN state

Specified by:

getAllBuildResultSummariesInUnknownState in interface ResultsSummaryManager

Returns:

summaries

createResultsSummary

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

Description copied from interface: ResultsSummaryManager

Creates a ResultsSummary of the given Class

Specified by:

createResultsSummary in interface ResultsSummaryManager

Returns:

resultsSummary

Throws:

ResultsSummaryCreationException

createResultsSummary

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

Specified by:

createResultsSummary in interface BuildResultsSummaryManager

Throws:

ResultsSummaryCreationException

updateResultSummaryWithBuildChanges

public void updateResultSummaryWithBuildChanges(@NotNull
 @NotNull BuildContext buildContext)
                                         throws ResultsSummaryCreationException

Specified by:

updateResultSummaryWithBuildChanges in interface ResultsSummaryManager

Throws:

ResultsSummaryCreationException

updateBuildSummaryFromBuildResults

@NotNull
public @NotNull BuildResultsSummary updateBuildSummaryFromBuildResults(BuildContext buildContext,
 @NotNull
 @NotNull CurrentlyBuilding currentlyBuilding,
 BuildResults buildResults)

Description copied from interface: BuildResultsSummaryManager

Updates BuildResultsSummary after build is completed. All fiedls are initialized at this moment.

Specified by:

updateBuildSummaryFromBuildResults in interface BuildResultsSummaryManager

Returns:

updated build result summary

calculateAndSetDeltaState

public void calculateAndSetDeltaState(ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

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.

Specified by:

calculateAndSetDeltaState in interface ResultsSummaryManager

Parameters:

resultsSummary - to update

updateLifeCycleState

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

Description copied from interface: ResultsSummaryManager

Update LifeCycleState and saves the given ResultsSummary

Specified by:

updateLifeCycleState in interface ResultsSummaryManager

Parameters:

resultsSummary - ResultsSummary to be updated and saved

lifeCycleState - LifeCycleState to be set

buildState - BuildState to be set

cleanPendingLifeCycleState

public void cleanPendingLifeCycleState(@NotNull
 @NotNull PlanResultKey planResultKey)

Description copied from interface: ResultsSummaryManager

Cleans state of pending result.

Specified by:

cleanPendingLifeCycleState in interface ResultsSummaryManager

updateLifeCycleState

public void updateLifeCycleState(@NotNull
 @NotNull BuildIdentifier buildIdentifier,
 @NotNull
 @NotNull LifeCycleState lifeCycleState,
 @NotNull
 @NotNull BuildState buildState)

Description copied from interface: ResultsSummaryManager

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

Specified by:

updateLifeCycleState in interface ResultsSummaryManager

Parameters:

buildIdentifier - BuildIdentifier used to get information on ResultsSummary

lifeCycleState - LifeCycleState to be set

buildState - BuildState to be set

updateLifeCycleState

public void updateLifeCycleState(@NotNull
 @NotNull CurrentlyBuilding currentlyBuilding,
 @NotNull
 @NotNull LifeCycleState lifeCycleState,
 @NotNull
 @NotNull BuildState buildState)

Description copied from interface: ResultsSummaryManager

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

Specified by:

updateLifeCycleState in interface ResultsSummaryManager

Parameters:

currentlyBuilding - in-memory state of the build

lifeCycleState - LifeCycleState to be set

buildState - BuildState to be set

updatePlanCompletedDate

public void updatePlanCompletedDate(@NotNull
 @NotNull ChainResultsSummary resultSummary,
 @NotNull
 @NotNull Date completionDate)

Description copied from interface: ResultsSummaryManager

Update completed date and duration of ChainResultsSummary

Specified by:

updatePlanCompletedDate in interface ResultsSummaryManager

updateProcessingDuration

public void updateProcessingDuration(ChainResultsSummary resultSummary)

Description copied from interface: ResultsSummaryManager

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

Specified by:

updateProcessingDuration in interface ResultsSummaryManager

markResultSummariesForDeletion

public int markResultSummariesForDeletion(@NotNull
 @NotNull PlanKey planKey)

Description copied from interface: ResultsSummaryManager

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

Specified by:

markResultSummariesForDeletion in interface ResultsSummaryManager

Parameters:

planKey - key of a plan

Returns:

number of updated records

getBreakingBuild

@Nullable
public @Nullable ResultsSummary getBreakingBuild(ResultsSummary buildResultsSummary)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getBreakingBuild in interface ResultsSummaryManager

Parameters:

buildResultsSummary - of the current build

Returns:

null if there is no breaking build.

getFixingBuild

@Nullable
public @Nullable ResultsSummary getFixingBuild(ResultsSummary buildResultsSummary)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getFixingBuild in interface ResultsSummaryManager

Returns:

null if there is no fixing build.

getAnyResultSummary

@Nullable
public <T extends ResultsSummary> T getAnyResultSummary(@NotNull
 @NotNull ResultsSummaryCriteria criteria,
 ResultDataRead dataRead)

Description copied from interface: ResultsSummaryManager

Generic search to find any result summary basing on the criteria provided. Note that if criteria does not specify order then result of this method might be non-deterministic.

Specified by:

getAnyResultSummary in interface ResultsSummaryManager

Parameters:

criteria - containing all the search constraints

Returns:

any resultSummary matching the criteria or null.

getResultSummaries

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultSummaries in interface ResultsSummaryManager

Parameters:

resultsSummaryCriteria - containing all the search constraints

Returns:

list of resultsSummaries matching the criteria.

getResultSummariesForExpiry

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultSummariesForExpiry in interface ResultsSummaryManager

Type Parameters:

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

Parameters:

expiryCriteria - search constraints

Returns:

list of results summaries matching the criteria

getLastNResultsSummaries

@NotNull
public @NotNull List<ResultsSummary> getLastNResultsSummaries(@NotNull
 @NotNull PlanIdentifier planIdentifier,
 int numberOfResults)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getLastNResultsSummaries in interface ResultsSummaryManager

Parameters:

planIdentifier - - to get the results for

numberOfResults - - number of summaries you would like

Returns:

list<ResultsSummary>

getLastNFailedResultsSummaries

@NotNull
public @NotNull List<ResultsSummary> getLastNFailedResultsSummaries(@NotNull
 @NotNull PlanIdentifier planIdentifier,
 int numberOfResults)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getLastNFailedResultsSummaries in interface ResultsSummaryManager

numberOfResults - must be > 0

findResultsSummariesByJiraIssues

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

findResultsSummariesByJiraIssues in interface ResultsSummaryManager

Parameters:

issueKeys - to search for

Returns:

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

findResultsSummariesByProjectKey

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

findResultsSummariesByProjectKey in interface ResultsSummaryManager

Parameters:

projectKey - - jira project key

Returns:

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

findJiraIssuesForResults

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

findJiraIssuesForResults in interface ResultsSummaryManager

Parameters:

buildResults - to look for issues attached to

Returns:

a list of LinkedJiraIssue linked to the given build result summaries

findJiraIssuesForPlanKey

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

Description copied from interface: ResultsSummaryManager

Retrieves a list of LinkedJiraIssue linked to the given plan key

Specified by:

findJiraIssuesForPlanKey in interface ResultsSummaryManager

Parameters:

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

Returns:

a list of LinkedJiraIssue linked to the given Plan

removeResultSummary

public void removeResultSummary(@NotNull
 @NotNull ImmutablePlan plan,
 int buildNumber)

Description copied from interface: ResultsSummaryManager

Remove plan result summary and all associated objects.

Specified by:

removeResultSummary in interface ResultsSummaryManager

removeResultSummary

public void removeResultSummary(@Nullable
 @Nullable ImmutablePlan plan,
 @NotNull
 @NotNull ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

Remove plan result summary and all associated objects.

Specified by:

removeResultSummary in interface ResultsSummaryManager

Parameters:

plan - not used

removeResultSummary

public void removeResultSummary(@NotNull
 @NotNull PlanResultKey planResultKey)

Description copied from interface: ResultsSummaryManager

Remove plan result summary and all associated objects.

Specified by:

removeResultSummary in interface ResultsSummaryManager

removeResultSummary

public void removeResultSummary(@NotNull
 @NotNull ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

Remove plan result summary and all associated objects.

Specified by:

removeResultSummary in interface ResultsSummaryManager

removeBuildLogs

public void removeBuildLogs(ImmutablePlan plan,
 int buildNumber)

Description copied from interface: ResultsSummaryManager

Remove any build logs stored for this plan result

Specified by:

removeBuildLogs in interface ResultsSummaryManager

removeBuildLogs

public void removeBuildLogs(ImmutablePlan plan,
 int buildNumber,
 long maxIgnoredSize)

Description copied from interface: ResultsSummaryManager

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

Specified by:

removeBuildLogs in interface ResultsSummaryManager

removeBuildLogs

public void removeBuildLogs(@NotNull
 @NotNull ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

Remove any build logs stored for this plan result

Specified by:

removeBuildLogs in interface ResultsSummaryManager

removeBuildLogs

public void removeBuildLogs(@NotNull
 @NotNull ResultsSummary resultsSummary,
 long maxIgnoredSize)

Description copied from interface: ResultsSummaryManager

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

Specified by:

removeBuildLogs in interface ResultsSummaryManager

removeMatchingArtifacts

public void removeMatchingArtifacts(@NotNull
 @NotNull ResultsSummary resultsSummary,
 @NotNull
 @NotNull Predicate<ArtifactLink> predicate)
                             throws IOException

Description copied from interface: ResultsSummaryManager

Remove artifacts from results summary that match a predicate.

Specified by:

removeMatchingArtifacts in interface ResultsSummaryManager

Throws:

IOException

removeArtifacts

public void removeArtifacts(@NotNull
 @NotNull ImmutablePlan plan,
 int buildNumber)
                     throws IOException

Description copied from interface: ResultsSummaryManager

Remove any artifacts stored for this plan result

Specified by:

removeArtifacts in interface ResultsSummaryManager

Throws:

IOException

removeArtifacts

public void removeArtifacts(@NotNull
 @NotNull ResultsSummary resultsSummary)
                     throws IOException

Description copied from interface: ResultsSummaryManager

Remove any artifacts stored for this plan result

Specified by:

removeArtifacts in interface ResultsSummaryManager

Throws:

IOException

findChainResultsWithJobLabelled

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

Description copied from interface: ResultsSummaryManager

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.

Specified by:

findChainResultsWithJobLabelled in interface ResultsSummaryManager

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

getNeighbouringSummaries

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

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary objects that matches the passed build numbers

Specified by:

getNeighbouringSummaries in interface ResultsSummaryManager

Returns:

List of BuildResultsSummary

getNeighbouringSummaries

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

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary objects that represent build results "around" the given build number.

Specified by:

getNeighbouringSummaries in interface ResultsSummaryManager

Parameters:

plan - the plan to return results for

buildNumber - the build number to search around

maxCount - the maximum number of builds to return

Returns:

List of BuildResultsSummary in ascending order. At most there will be maxCount items in the list, inclusive of the result for buildNumber (if present).

getBeforeSummaries

@NotNull
public @NotNull List<ResultsSummary> getBeforeSummaries(@NotNull
 @NotNull ImmutablePlan plan,
 int buildNumber,
 int maxCount)

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary objects that represent build results strictly before the given build number.

Specified by:

getBeforeSummaries in interface ResultsSummaryManager

Parameters:

plan - the plan to return results for

buildNumber - the build number to search before

maxCount - the maximum number of builds to return

Returns:

List of BuildResultsSummary in ascending order. At most there will be maxCount items in the list, exclusive of the result for buildNumber (if present).

getAfterSummaries

@NotNull
public @NotNull List<ResultsSummary> getAfterSummaries(@NotNull
 @NotNull ImmutablePlan plan,
 int buildNumber,
 int maxCount)

Description copied from interface: ResultsSummaryManager

Returns all the ResultsSummary objects that represent build results strictly after the given build number.

Specified by:

getAfterSummaries in interface ResultsSummaryManager

Parameters:

plan - the plan to return results for

buildNumber - the build number to search after

maxCount - the maximum number of builds to return

Returns:

List of BuildResultsSummary in ascending order. At most there will be maxCount items in the list, exclusive of the result for buildNumber (if present).

removeResultsSummariesForPlan

public int removeResultsSummariesForPlan(@NotNull
 @NotNull Plan plan)

Description copied from interface: ResultsSummaryManager

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.

Specified by:

removeResultsSummariesForPlan in interface ResultsSummaryManager

Parameters:

plan - to remove results for.

Returns:

number of ResultsSummarys removed

removeAllOrphanedResultSummaries

public int removeAllOrphanedResultSummaries()

Description copied from interface: ResultsSummaryManager

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

Specified by:

removeAllOrphanedResultSummaries in interface ResultsSummaryManager

Returns:

number of ResultsSummarys removed

saveResultSummary

public void saveResultSummary(@NotNull
 @NotNull ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

Saves the ResultsSummary

Specified by:

saveResultSummary in interface ResultsSummaryManager

getLastSuccessfulResultSummary

public ResultsSummary getLastSuccessfulResultSummary(@NotNull
 @NotNull PlanKey planKey)

Description copied from interface: ResultsSummaryManager

Get the last successful ResultsSummary for planKey

Specified by:

getLastSuccessfulResultSummary in interface ResultsSummaryManager

Returns:

findLastSuccessfulBuildResultBefore

@Nullable
public @Nullable ResultsSummary findLastSuccessfulBuildResultBefore(@NotNull
 @NotNull PlanResultKey planResultKey)

Description copied from interface: ResultsSummaryManager

Finds the last successful ResultsSummary before build

Specified by:

findLastSuccessfulBuildResultBefore in interface ResultsSummaryManager

Returns:

buildResult

findLastSuccessfulBuildResultBefore

@Nullable
public @Nullable ResultsSummary findLastSuccessfulBuildResultBefore(@NotNull
 @NotNull PlanResultKey planResultKey,
 boolean includeOnceOffBuilds)

Description copied from interface: ResultsSummaryManager

Finds the last successful ResultsSummary before build

Specified by:

findLastSuccessfulBuildResultBefore in interface ResultsSummaryManager

findFirstResultAfter

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

findFirstResultAfter in interface ResultsSummaryManager

Returns:

findLastResultBefore

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

Description copied from interface: ResultsSummaryManager

Finds the last successful or failing ResultsSummary before planResultKey.getBuildNumber

Specified by:

findLastResultBefore in interface ResultsSummaryManager

Returns:

findLastResultBefore

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

Description copied from interface: ResultsSummaryManager

Finds the last ResultsSummary before planResultKey.getBuildNumber

Specified by:

findLastResultBefore in interface ResultsSummaryManager

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

Returns:

findLastResultSummaryWithState

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

Specified by:

findLastResultSummaryWithState in interface ResultsSummaryManager

Returns:

the last ResultsSummary with the provided BuildState

findLastResultSummaryWithState

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

Specified by:

findLastResultSummaryWithState in interface ResultsSummaryManager

Returns:

the last ResultsSummary with the provided BuildState

getResultSummariesByChangeSetId

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

Description copied from interface: ResultsSummaryManager

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

Please note that a build result summary contains list of commits which were added in a given build (compared to a previous one). It means that a list of commits may be empty if there were no repository changes. A list of commits is also empty in case of a first build in a plan or a first build of a plan's branch. A build results summary may also contain no commits if no version control system was used.

This will not return records marked for deletion.

In case you need to find build results based on commit which was checked out into a build workspace, see the ResultsSummaryManager.getResultSummariesByCheckoutChangesetId(String, Class)

Specified by:

getResultSummariesByChangeSetId in interface ResultsSummaryManager

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

getResultSummariesByCheckoutChangesetId

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

Description copied from interface: ResultsSummaryManager

Get a list of all build results containing repositories checked out with the given changeset ID.

A build may use one or more repositories, each checked out with a certain changeset. This method returns build results having exact changeset ID checked out (note that it does not search for intermediate commits between two changeset IDs).

This will not return records marked for deletion.

In case you need to find build results based on commits which were added in certain build (compared to a previous one), see the ResultsSummaryManager.getResultSummariesByChangeSetId(String, Class)

Specified by:

getResultSummariesByCheckoutChangesetId in interface ResultsSummaryManager

Type Parameters:

T - extends ResultSummary

Parameters:

changeSetId - of the checkout commit

discriminator - class of the ResultSummary interface required

Returns:

List of ResultsSummary (ResultSummary as determined by discriminator) containing a repository which was checked out with a changeSetId commit

getResultSummariesByChangeSetIdAndRepository

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultSummariesByChangeSetIdAndRepository in interface ResultsSummaryManager

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

getResultSummariesByChangeSetIds

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultSummariesByChangeSetIds in interface ResultsSummaryManager

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
public <T extends ResultsSummary> @NotNull List<T> getResultSummariesByChangeSetIds(@NotNull
 @NotNull Iterable<Pair<String,RepositoryData>> changeSetIds,
 Class<T> discriminator)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getResultSummariesByChangeSetIds in interface ResultsSummaryManager

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
public @NotNull List<UnassociatedCommit> getCommitsForUser(@NotNull
 @NotNull String username,
 int max)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getCommitsForUser in interface ResultsSummaryManager

Parameters:

username - to filter commits by

max - maximum number of commits to get.

Returns:

a list of recent Commits for the given user

findLastBuildResultBefore

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

Description copied from interface: ResultsSummaryManager

Finds the last successful or failing BuildResultsSummary before buildNumber

Specified by:

findLastBuildResultBefore in interface ResultsSummaryManager

Returns:

findLastBuildResultBeforeWithTests

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

Description copied from interface: ResultsSummaryManager

Finds the last successful or failing BuildResultsSummary before buildNumber

Specified by:

findLastBuildResultBeforeWithTests in interface ResultsSummaryManager

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

Returns:

resultsSummary

findFirstFailedBuildResultAfter

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

Description copied from interface: ResultsSummaryManager

Finds the first failed ResultsSummary after buildNumber

Specified by:

findFirstFailedBuildResultAfter in interface ResultsSummaryManager

Returns:

buildResult

findFirstSuccessfulBuildResultAfter

@Nullable
public @Nullable ResultsSummary findFirstSuccessfulBuildResultAfter(@NotNull
 @NotNull PlanResultKey planResultKey)

Description copied from interface: ResultsSummaryManager

Finds the last successful ResultsSummary after buildNumber

Specified by:

findFirstSuccessfulBuildResultAfter in interface ResultsSummaryManager

Returns:

buildResult

findLastFailingBuildResultBefore

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

Description copied from interface: ResultsSummaryManager

Finds the last failing ResultsSummary before buildNumber

Specified by:

findLastFailingBuildResultBefore in interface ResultsSummaryManager

Returns:

buildResult

findLastFailingBuildResultBefore

@Nullable
public @Nullable ResultsSummary findLastFailingBuildResultBefore(@NotNull
 @NotNull PlanKey planKey,
 int buildNumber)

Description copied from interface: ResultsSummaryManager

Finds the last failing ResultsSummary before buildNumber

Specified by:

findLastFailingBuildResultBefore in interface ResultsSummaryManager

Returns:

buildResult

findFirstFailedBuildResultBetween

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

findFirstFailedBuildResultBetween in interface ResultsSummaryManager

Returns:

buildResults

findFirstFailedBuildResultBetween

@Nullable
public @Nullable ResultsSummary findFirstFailedBuildResultBetween(@NotNull
 @NotNull PlanKey planKey,
 int lowerBuildNumber,
 int upperBuildNumber)

Description copied from interface: ResultsSummaryManager

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

Specified by:

findFirstFailedBuildResultBetween in interface ResultsSummaryManager

getParentResultSummary

@Nullable
public @Nullable ChainResultsSummary getParentResultSummary(ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

Get (@link ChainResultsSummary} containing given ResultsSummary

Specified by:

getParentResultSummary in interface ResultsSummaryManager

Returns:

getStageForResult

@Nullable
public @Nullable ChainStageResult getStageForResult(ResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

Get (@link ChainStageResult} containing given ResultsSummary

Specified by:

getStageForResult in interface ResultsSummaryManager

Returns:

getNumberOfResults

public long getNumberOfResults()

Description copied from interface: ResultsSummaryManager

Get number of all ResultsSummarys

Specified by:

getNumberOfResults in interface ResultsSummaryManager

Returns:

number of summaries

getNumberOfFinishedResults

public long getNumberOfFinishedResults(@NotNull
 @NotNull Plan plan)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getNumberOfFinishedResults in interface ResultsSummaryManager

Returns:

number of summaries

getNumberOfFinalizedResults

public long getNumberOfFinalizedResults(@NotNull
 @NotNull ImmutablePlan plan)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getNumberOfFinalizedResults in interface ResultsSummaryManager

Returns:

number of summaries

getNumberOfFinalizedResults

public long getNumberOfFinalizedResults(@NotNull
 @NotNull PlanKey planKey)

Description copied from interface: ResultsSummaryManager

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

Specified by:

getNumberOfFinalizedResults in interface ResultsSummaryManager

Returns:

number of summaries

getLatestResultSummaries

public List<ResultsSummary> getLatestResultSummaries()

Description copied from interface: ResultsSummaryManager

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

Specified by:

getLatestResultSummaries in interface ResultsSummaryManager

Returns:

List of ResultsSummary

getLatestFailedResultSummaries

public List<ResultsSummary> getLatestFailedResultSummaries()

Description copied from interface: ResultsSummaryManager

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

Specified by:

getLatestFailedResultSummaries in interface ResultsSummaryManager

Returns:

List of ResultsSummary

getAveragePlanExecutionDuration

public long getAveragePlanExecutionDuration(@NotNull
 @NotNull ImmutablePlan plan,
 int numberOfResults)

Description copied from interface: ResultsSummaryManager

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.

Specified by:

getAveragePlanExecutionDuration in interface ResultsSummaryManager

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

Returns:

average duration in milliseconds or 0 if there is no results

countResultsWithState

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

Description copied from interface: ResultsSummaryManager

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

Specified by:

countResultsWithState in interface ResultsSummaryManager

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

getLastResultsSummary

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

Description copied from interface: ResultsSummaryManager

Get the last ResultsSummary for planKey and Class

Specified by:

getLastResultsSummary in interface ResultsSummaryManager

Returns:

getLastResultsSummary

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

Description copied from interface: ResultsSummaryManager

Get the last ResultsSummary for planKey and Class with possible skip of specs results.

Specified by:

getLastResultsSummary in interface ResultsSummaryManager

Returns:

moveResultSummaries

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

Description copied from interface: ResultsSummaryManager

Reassigns plan key ResultsSummaries associated with selected plan key.

Specified by:

moveResultSummaries in interface ResultsSummaryManager

Parameters:

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

scrollResultSummaries

public long scrollResultSummaries(@NotNull
 @NotNull String buildKey,
 @NotNull
 @NotNull Function<ResultsSummary,Void> function)

Description copied from interface: ResultsSummaryManager

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.

Specified by:

scrollResultSummaries in interface ResultsSummaryManager

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

public long scrollResultSummaries(@NotNull
 @NotNull String buildKey,
 ResultDataRead resultDataRead,
 @NotNull
 @NotNull Function<ResultsSummary,Void> function)

Description copied from interface: ResultsSummaryManager

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.

Specified by:

scrollResultSummaries in interface ResultsSummaryManager

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

removeMergeResultSummary

public void removeMergeResultSummary(@NotNull
 @NotNull MergeResultSummary mergeResult)

Description copied from interface: ResultsSummaryManager

Removes merge result. Use with care.

Specified by:

removeMergeResultSummary in interface ResultsSummaryManager

getPlanKeysSortedByNumberOfFinalizedResultSummaries

@NotNull
public @NotNull List<PlanKey> getPlanKeysSortedByNumberOfFinalizedResultSummaries()

Specified by:

getPlanKeysSortedByNumberOfFinalizedResultSummaries in interface ResultsSummaryManager

calculateQueueDuration

@Nullable
public @Nullable Long calculateQueueDuration(@NotNull
 @NotNull ChainResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

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

Specified by:

calculateQueueDuration in interface ResultsSummaryManager

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

queueDuration value or null if there are no related BuildResultsSummary records

calculateVcsUpdateDuration

@Nullable
public @Nullable Long calculateVcsUpdateDuration(@NotNull
 @NotNull ChainResultsSummary resultsSummary)

Description copied from interface: ResultsSummaryManager

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

Specified by:

calculateVcsUpdateDuration in interface ResultsSummaryManager

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

vcsUpdateDuration value or null if there are no related BuildResultsSummary records

findAllBuildResultsNumbers

@NotNull
public @NotNull List<Integer> findAllBuildResultsNumbers(PlanKey planKey)

Specified by:

findAllBuildResultsNumbers in interface ResultsSummaryManager

invalidateLogSize

public void invalidateLogSize(@NotNull
 @NotNull PlanResultKey planResultKey)

Description copied from interface: ResultsSummaryManager

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

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

Specified by:

invalidateLogSize in interface ResultsSummaryManager

Parameters:

planResultKey - result key

findChainResultsWithFormatVersionLessThan

@NotNull
public @NotNull List<PlanResultKey> findChainResultsWithFormatVersionLessThan(int formatVersion,
 int maxResults)

Specified by:

findChainResultsWithFormatVersionLessThan in interface ResultsSummaryManager

findBuildResultNumbersRange

@NotNull
public @NotNull Range<Integer> findBuildResultNumbersRange(@NotNull
 @NotNull PlanKey planKey)

Description copied from interface: ResultsSummaryManager

Finds minimum and maximum build number for a plan. Works for both chains and jobs.

Specified by:

findBuildResultNumbersRange in interface ResultsSummaryManager

Returns:

(min, max) pair or (0,0) if there are no results.

findJobKeysFromExistingChainResults

@NotNull
public @NotNull List<PlanKey> findJobKeysFromExistingChainResults(@NotNull
 @NotNull PlanKey chainKey)

Description copied from interface: ResultsSummaryManager

Find keys of jobs for which results associated with given plan exist. The jobs themselves might no longer exist. Internal use only

Specified by:

findJobKeysFromExistingChainResults in interface ResultsSummaryManager

findMinimumBuildNumberForNLatest

public int findMinimumBuildNumberForNLatest(@NotNull
 @NotNull PlanKey planKey,
 int n)

Description copied from interface: ResultsSummaryManager

Find a build number for which exist n non-specs results with a build number greater or equal. If the build has less that n such results, the lowest build number is returned.

Specified by:

findMinimumBuildNumberForNLatest in interface ResultsSummaryManager

setBuildResultsSummaryDao

public void setBuildResultsSummaryDao(BuildResultsSummaryDao buildResultsSummaryDao)

setExtendedAuthorManager

public void setExtendedAuthorManager(ExtendedAuthorManager extendedAuthorManager)

setEventPublisher

public void setEventPublisher(com.atlassian.event.api.EventPublisher eventPublisher)

setJiraIssueUtils

public void setJiraIssueUtils(JiraIssueUtils jiraIssueUtils)

setArtifactLinkManager

public void setArtifactLinkManager(ArtifactLinkManager artifactLinkManager)

setCommitDao

public void setCommitDao(CommitDao commitDao)

setBuildExecutionManager

public void setBuildExecutionManager(BuildExecutionManager buildExecutionManager)

setRepositoryDefinitionManager

public void setRepositoryDefinitionManager(RepositoryDefinitionManager repositoryDefinitionManager)

setCommentManager

public void setCommentManager(CommentManager commentManager)

setBranchIntegrationService

public void setBranchIntegrationService(BranchIntegrationService branchIntegrationService)

setMergeResultSummaryDao

public void setMergeResultSummaryDao(MergeResultSummaryDao mergeResultSummaryDao)

setVariableContextBaselineDao

public void setVariableContextBaselineDao(VariableContextBaselineDao variableContextBaselineDao)

setVcsRepositoryManager

public void setVcsRepositoryManager(VcsRepositoryManager vcsRepositoryManager)

setPlanManager

public void setPlanManager(PlanManager planManager)