BuildResultsSummaryManagerImpl (Atlassian Bamboo 6.0.0 API)

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 and Description

BuildResultsSummaryManagerImpl()

Constructors
Constructor and Description
`BuildResultsSummaryManagerImpl()`

Method Summary

All Methods Instance Methods Concrete 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 resultsSummary)` 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`
`<T extends ResultsSummary> T`	`createResultsSummary(ChainResultsSummary chainResultsSummary, BuildContext buildContext, Class<T> aClass)`
`List<Integer>`	`findAllBuildResultsNumbers(PlanKey planKey)`
`Range<Integer>`	`findBuildResultNumbersRange(PlanKey planKey)` Finds minimum and maximum build number for a plan.
`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
`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(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
`List<ResultsSummary>`	`getAfterSummaries(ImmutablePlan plan, int buildNumber, int maxCount)` Returns all the `ResultsSummary` objects that represent build results strictly after the given build number.
`<T extends ResultsSummary> Collection<T>`	`getAllActiveResultSummariesForPlan(PlanKey planKey, Class<T> aClass)` Returns all the `ResultsSummary` in a `LifeCycleState.IN_PROGRESS` state
`<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
`<T extends ResultsSummary> T`	`getAnyResultSummary(ResultsSummaryCriteria criteria, ResultDataRead dataRead)` Generic search to find any result summary basing on the criteria provided.
`long`	`getAverageBuildTime(ImmutableBuildable plan, int numberOfResults)` Returns average build duration for given number of builds
`long`	`getAveragePlanExecutionDuration(ImmutablePlan plan, int numberOfResults)` Get average duration from n last results summaries in finished state for a plan.
`List<ResultsSummary>`	`getBeforeSummaries(ImmutablePlan plan, int buildNumber, int maxCount)` Returns all the `ResultsSummary` objects that represent build results strictly before the given build number.
`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<ResultsSummary>`	`getLastNFailedResultsSummaries(Plan plan, 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<ResultsSummary>`	`getNeighbouringSummaries(ImmutablePlan plan, int buildNumber, int maxCount)` Returns all the `ResultsSummary` objects that represent build results "around" the given build number.
`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 `ResultsSummary`s in a `LifeCycleState.FINISHED` or `LifeCycleState.NOT_BUILT` state for the given `Plan`
`long`	`getNumberOfFinishedResults(Plan plan)` Get number of the `ResultsSummary`s in `LifeCycleState.FINISHED` state for the given `Plan`
`long`	`getNumberOfResults()` Get number of all `ResultsSummary`s
`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 resultsSummaryCriteria)` Generic search to find any result summaries basing 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 changeset 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 changeset 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 changeset 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 changeset IDs.
`<T extends ResultsSummary> List<T>`	`getResultSummariesByCheckoutChangesetId(String changeSetId, Class<T> discriminator)` Get a list of all build results containing repositories checked out with the given changeset ID.
`<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 `ResultsSummary`s for the given `Plan` in any `LifeCycleState`.
`<T extends ResultsSummary> List<T>`	`getResultSummariesForPlanByLifeCycleState(Plan plan, LifeCycleState lifeCycleState, int firstResult, int maxResults)` Get the `ResultsSummary`s 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)`
`void`	`logVariablesForSubstitution(BuildContext buildContext, ResultsSummary resultsSummary)`
`int`	`markResultSummariesForDeletion(PlanKey planKey)` Mass update of all `ResultsSummary` records in the database related to a Plan identified by 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 maxIgnoredSize)` 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 maxIgnoredSize)` 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(ImmutablePlan plan, int buildNumber)` Remove plan result summary and all associated objects.
`void`	`removeResultSummary(ImmutablePlan 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`	`setArtifactLinkManager(ArtifactLinkManager artifactLinkManager)`
`void`	`setBranchIntegrationService(BranchIntegrationService branchIntegrationService)`
`void`	`setBuildExecutionManager(BuildExecutionManager buildExecutionManager)`
`void`	`setBuildResultsIndexer(BuildResultsIndexer buildResultsIndexer)`
`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`	`setTestsManager(TestsManager testsManager)`
`void`	`setVariableContextBaselineDao(VariableContextBaselineDao variableContextBaselineDao)`
`void`	`setVcsRepositoryManager(VcsRepositoryManager vcsRepositoryManager)`
`BuildResultsSummary`	`updateBuildSummaryFromBuildResults(BuildContext buildContext, CurrentlyBuilding currentlyBuilding, BuildResults buildResults)` Updates BuildResultsSummary after build is completed.
`void`	`updateLifeCycleState(BuildIdentifier buildIdentifier, 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 resultSummary, 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.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - BuildResultsSummaryManagerImpl
```
public BuildResultsSummaryManagerImpl()
```
- Method Detail
  - getResultSummariesForPlanByLifeCycleState
```
@NotNull
public <T extends ResultsSummary> List<T> getResultSummariesForPlanByLifeCycleState(@NotNull
                                                                                             Plan plan,
                                                                                             @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> List<T> getResultSummariesForPlan(@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 ChainStageResult getChainStageResultById(@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 ResultsSummary getResultsSummary(@NotNull
                                                  PlanResultKey planResultKey)
```
    Description copied from interface: ResultsSummaryManager
    
    Lookup the ResultsSummary by PlanResultKey
    
    Specified by:
    
    getResultsSummary in interface ResultsSummaryManager
    
    Returns:
    
    resultsSummary
  - getResultsSummary
```
@Nullable
public ResultsSummary getResultsSummary(@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
                                                                PlanResultKey planResultKey,
                                                                @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
                                                                PlanResultKey planResultKey,
                                                                @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
                                         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
                                                      ResultsSummary resultsSummary,
                                                      @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
                                            ResultsSummary resultsSummary,
                                            @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
                                       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
                                            ResultsSummary resultsSummary,
                                            @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> 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> 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> 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> 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> 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> 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
                                                         BuildContext buildContext,
                                                         @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
                                                         ChainResultsSummary chainResultsSummary,
                                                         @NotNull
                                                         BuildContext buildContext,
                                                         @NotNull
                                                         Class<T> aClass)
                                                  throws ResultsSummaryCreationException
```
    Specified by:
    
    createResultsSummary in interface BuildResultsSummaryManager
    
    Throws:
    
    ResultsSummaryCreationException
  - updateResultSummaryWithBuildChanges
```
public void updateResultSummaryWithBuildChanges(@NotNull
                                                BuildContext buildContext)
                                         throws ResultsSummaryCreationException
```
    Specified by:
    
    updateResultSummaryWithBuildChanges in interface ResultsSummaryManager
    
    Throws:
    
    ResultsSummaryCreationException
  - updateBuildSummaryFromBuildResults
```
@NotNull
public BuildResultsSummary updateBuildSummaryFromBuildResults(BuildContext buildContext,
                                                                       @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
                                 ResultsSummary resultsSummary,
                                 @NotNull
                                 LifeCycleState lifeCycleState,
                                 @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
  - updateLifeCycleState
```
public void updateLifeCycleState(@NotNull
                                 BuildIdentifier buildIdentifier,
                                 @NotNull
                                 LifeCycleState lifeCycleState,
                                 @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
  - updatePlanCompletedDate
```
public void updatePlanCompletedDate(@NotNull
                                    ChainResultsSummary resultSummary,
                                    @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
                                          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 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 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
```
@NotNull
public <T extends ResultsSummary> T getAnyResultSummary(@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.
  - getResultSummaries
```
@NotNull
public <T extends ResultsSummary> List<T> getResultSummaries(@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> List<T> getResultSummariesForExpiry(@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 List<ResultsSummary> getLastNResultsSummaries(@NotNull
                                                              ImmutablePlan plan,
                                                              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:
    
    plan - - to get the results for
    
    numberOfResults - - number of summaries you would like
    
    Returns:
    
    list<ResultsSummary>
  - getLastNFailedResultsSummaries
```
@NotNull
public List<ResultsSummary> getLastNFailedResultsSummaries(@NotNull
                                                                    Plan plan,
                                                                    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
    
    Returns:
  - findResultsSummariesByJiraIssues
```
@NotNull
public List<? extends ResultsSummary> findResultsSummariesByJiraIssues(@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 List<? extends ResultsSummary> findResultsSummariesByProjectKey(@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 List<LinkedJiraIssue> findJiraIssuesForResults(@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 List<LinkedJiraIssue> findJiraIssuesForPlanKey(@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
                                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(@NotNull
                                ImmutablePlan plan,
                                @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
                            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
                            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
                                    ResultsSummary resultsSummary,
                                    @NotNull
                                    com.google.common.base.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
                            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
                            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 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 List<ResultsSummary> getNeighbouringSummaries(@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 List<ResultsSummary> getBeforeSummaries(@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 List<ResultsSummary> getAfterSummaries(@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
                                         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
                              ResultsSummary resultsSummary)
```
    Description copied from interface: ResultsSummaryManager
    
    Saves the ResultsSummary
    
    Specified by:
    
    saveResultSummary in interface ResultsSummaryManager
  - getLastSuccessfulResultSummary
```
public ResultsSummary getLastSuccessfulResultSummary(@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 ResultsSummary findLastSuccessfulBuildResultBefore(@NotNull
                                                                    PlanResultKey planResultKey)
```
    Description copied from interface: ResultsSummaryManager
    
    Finds the last successful ResultsSummary before build
    
    Specified by:
    
    findLastSuccessfulBuildResultBefore in interface ResultsSummaryManager
    
    Returns:
    
    buildResult
  - findFirstResultAfter
```
@Nullable
public <T extends ResultsSummary> T findFirstResultAfter(@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
                                                                   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
                                                                   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
                                                                   PlanKey planKey,
                                                                   @NotNull
                                                                   BuildState buildState,
                                                                   @NotNull
                                                                   Class<T> aClass)
```
    Specified by:
    
    findLastResultSummaryWithState in interface ResultsSummaryManager
    
    Returns:
    
    the last ResultsSummary with the provided BuildState
  - getResultSummariesByChangeSetId
```
@NotNull
public <T extends ResultsSummary> List<T> getResultSummariesByChangeSetId(@NotNull
                                                                                   String changeSetId,
                                                                                   @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> List<T> getResultSummariesByCheckoutChangesetId(@NotNull
                                                                                           String changeSetId,
                                                                                           @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
                                                                                       String changeSetId,
                                                                                       @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> List<T> getResultSummariesByChangeSetIds(@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> List<T> getResultSummariesByChangeSetIds(@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 List<UnassociatedCommit> getCommitsForUser(@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 ResultsSummary findLastBuildResultBefore(@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
                                                                       PlanResultKey planResultKey,
                                                                       @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 ResultsSummary findFirstFailedBuildResultAfter(@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 ResultsSummary findFirstSuccessfulBuildResultAfter(@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 ResultsSummary findLastFailingBuildResultBefore(@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
  - findFirstFailedBuildResultBetween
```
@Nullable
public ResultsSummary findFirstFailedBuildResultBetween(@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
  - getParentResultSummary
```
@Nullable
public 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 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
                                       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
                                        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
  - 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
  - getAverageBuildTime
```
public long getAverageBuildTime(@NotNull
                                ImmutableBuildable plan,
                                int numberOfResults)
```
    Description copied from interface: BuildResultsSummaryManager
    
    Returns average build duration for given number of builds
    
    Specified by:
    
    getAverageBuildTime in interface BuildResultsSummaryManager
    
    numberOfResults - - How many build results to use in the average. must be greater 0 @return Average build time. 0 if no build found.
  - getAveragePlanExecutionDuration
```
public long getAveragePlanExecutionDuration(@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
                                 PlanKey planKey,
                                 int lowerBuildNumber,
                                 int upperBuildNumber,
                                 @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
                                                                    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:
  - moveResultSummaries
```
public void moveResultSummaries(@NotNull
                                Plan newParentPlan,
                                @NotNull
                                PlanKey oldPlanKey,
                                @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
                                  String buildKey,
                                  @NotNull
                                  com.google.common.base.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
                                  String buildKey,
                                  ResultDataRead resultDataRead,
                                  @NotNull
                                  com.google.common.base.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
  - logVariablesForSubstitution
```
public void logVariablesForSubstitution(@NotNull
                                        BuildContext buildContext,
                                        @NotNull
                                        ResultsSummary resultsSummary)
```
    Specified by:
    
    logVariablesForSubstitution in interface ResultsSummaryManager
  - logSubstitutedVariables
```
public void logSubstitutedVariables(@NotNull
                                    BuildContext buildContext,
                                    @NotNull
                                    ResultsSummary resultsSummary)
```
    Specified by:
    
    logSubstitutedVariables in interface ResultsSummaryManager
  - removeMergeResultSummary
```
public void removeMergeResultSummary(@NotNull
                                     MergeResultSummary mergeResult)
```
    Description copied from interface: ResultsSummaryManager
    
    Removes merge result. Use with care.
    
    Specified by:
    
    removeMergeResultSummary in interface ResultsSummaryManager
  - getPlanKeysSortedByNumberOfFinalizedResultSummaries
```
@NotNull
public List<PlanKey> getPlanKeysSortedByNumberOfFinalizedResultSummaries()
```
    Specified by:
    
    getPlanKeysSortedByNumberOfFinalizedResultSummaries in interface ResultsSummaryManager
  - calculateQueueDuration
```
@Nullable
public Long calculateQueueDuration(@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 Long calculateVcsUpdateDuration(@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 List<Integer> findAllBuildResultsNumbers(PlanKey planKey)
```
    Specified by:
    
    findAllBuildResultsNumbers in interface ResultsSummaryManager
  - invalidateLogSize
```
public void invalidateLogSize(@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
  - findBuildResultNumbersRange
```
@NotNull
public Range<Integer> findBuildResultNumbersRange(@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.
  - setBuildResultsSummaryDao
```
public void setBuildResultsSummaryDao(BuildResultsSummaryDao buildResultsSummaryDao)
```
  - setExtendedAuthorManager
```
public void setExtendedAuthorManager(ExtendedAuthorManager extendedAuthorManager)
```
  - setBuildResultsIndexer
```
public void setBuildResultsIndexer(BuildResultsIndexer buildResultsIndexer)
```
  - 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)
```
  - setTestsManager
```
public void setTestsManager(TestsManager testsManager)
```
  - 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)
```

Class BuildResultsSummaryManagerImpl

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

BuildResultsSummaryManagerImpl

Method Detail

getResultSummariesForPlanByLifeCycleState

getResultSummariesForPlan

getChainStageResultById

getResultsSummary

getResultsSummary

getResultsSummary

getResultsSummary

getResultsSummary

resetResultSummary

addVariableContextSnapshotToResultSummary

updateVariablesOnContinuedBuild

clearVariablesOnRerunBuild

postBuildVariableSnapshotUpdate

getAllPendingResultSummaries

getAllQueuedResultSummaries

getAllInProgressResultSummaries

getAllActiveResultSummariesForPlan

getFinalizedResultSummariesForPlan

getNumberOfConcurrentlyRunningBuilds

getAllBuildResultSummariesInUnknownState

createResultsSummary

createResultsSummary

updateResultSummaryWithBuildChanges

updateBuildSummaryFromBuildResults

calculateAndSetDeltaState

updateLifeCycleState

updateLifeCycleState

updatePlanCompletedDate

updateProcessingDuration

markResultSummariesForDeletion

getBreakingBuild

getFixingBuild

getAnyResultSummary

getResultSummaries

getResultSummariesForExpiry

getLastNResultsSummaries

getLastNFailedResultsSummaries

findResultsSummariesByJiraIssues

findResultsSummariesByProjectKey

findJiraIssuesForResults

findJiraIssuesForPlanKey

removeResultSummary

removeResultSummary

removeBuildLogs

removeBuildLogs

removeBuildLogs

removeBuildLogs

removeMatchingArtifacts

removeArtifacts

removeArtifacts

findChainResultsWithJobLabelled

getNeighbouringSummaries

getNeighbouringSummaries

getBeforeSummaries

getAfterSummaries

removeResultsSummariesForPlan

removeAllOrphanedResultSummaries

saveResultSummary

getLastSuccessfulResultSummary

findLastSuccessfulBuildResultBefore

findFirstResultAfter

findLastResultBefore

findLastResultBefore

findLastResultSummaryWithState

getResultSummariesByChangeSetId

getResultSummariesByCheckoutChangesetId

getResultSummariesByChangeSetIdAndRepository

getResultSummariesByChangeSetIds

getResultSummariesByChangeSetIds

getCommitsForUser

findLastBuildResultBefore

findLastBuildResultBeforeWithTests

findFirstFailedBuildResultAfter