BuildResultsSummaryDao (Atlassian Bamboo 6.7.2 API)

All Superinterfaces:

BambooObjectDao<ResultsSummary>

All Known Implementing Classes:

BuildResultsSummaryHibernateDao
```
@Internal
public interface BuildResultsSummaryDao
extends BambooObjectDao<ResultsSummary>
```

Field Summary

Fields
Modifier and Type Field and Description

static int NUMBER_OF_DAYS_TO_FILTER

Fields
Modifier and Type	Field and Description
`static int`	`NUMBER_OF_DAYS_TO_FILTER`

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`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.
`int`	`countBuildResultsSummaries()` Count all result summaries records.
`int`	`countBuildResultsSummaries(String planKey)`
`long`	`countResultSummaries(ResultsSummaryCriteria criteria)` Count the number of `ResultsSummary` objects given a `ResultsSummaryCriteria`.
`int`	`countResultsWithState(PlanKey planKey, int lowerBuildNumber, int upperBuildNumber, BuildState buildState)` Counts results with a given state in a given build number range for plan.
`List<Integer>`	`findAllBuildResultsNumbers(PlanKey planKey)`
`<T extends ResultsSummary> T`	`findAnyResultSummary(ResultsSummaryCriteria criteria, ResultDataRead dataRead)` Searches for any `ResultsSummary` object given a `ResultsSummaryCriteria`.
`Range<Integer>`	`findBuildResultsNumberRange(PlanKey planKey)` Finds minimum and maximum build number for a plan.
`List<ResultsSummary>`	`findBuildResultsSummariesByJiraIssues(List<String> issueKeys)` Get a list of results summaries associated with the list of issue keys.
`List<ResultsSummary>`	`findBuildResultsSummariesByProjectKey(String jiraProjectKey)` Retrieve a list of results summaries associated with given JIRA project key This will not return records marked for deletion.
`List<Pair<ArtifactLink,BuildResultsSummary>>`	`findBuildResultsWithArtifacts(String planKey)` Find all build results which have matching artifacts.
`List<BuildResultsSummary>`	`findBuildsForImageConfiguration(String planKey, ElasticImageConfiguration elasticImageConfiguration, BuildState buildState, int maxResults)` Searcher for builds of an image
`List<PlanResultKey>`	`findChainResultsWithFormatVersionLessThan(int formatVersion, int maxResults)` Deprecated. internal use only
`List<ChainResultsSummary>`	`findChainResultsWithJobLabelled(ResultsSummaryCriteria criteria, List<Label> labels)` Searches through all chains to find any that have jobs which match the given labels.
`Integer`	`findFirstBuildNumberAfter(String planKey, int buildNumber)` Returns the build number of next existing build results.
`ResultsSummary`	`findFirstBuildResultWithBuildStateAfter(String planKey, int buildNumber, BuildState buildState)` Finds the last successful `BuildResultsSummary` after buildNumber
`ResultsSummary`	`findFirstBuildResultWithBuildStateBetween(String planKey, int lowerBuildNumber, int upperBuildNumber, BuildState buildState)` Returns the first build that matches `BuildState` between the given build number range Note that this function is inclusive of the upper and lower bound
`<T extends ResultsSummary> T`	`findFirstResultAfter(String planKey, int buildNumber, Class<T> aClass)` Finds the first successful or failed `BuildResultsSummary` after buildNumber
`Integer`	`findLastBuildNumberBefore(String planKey, int buildNumber)` Returns the build number of previous existing build results.
`<T extends ResultsSummary> T`	`findLastBuildResultBeforeWithTests(PlanResultKey planResultKey, Class<T> aClass, boolean includeOnceOffBuilds)`
`ResultsSummary`	`findLastBuildResultWithBuildStateBefore(String planKey, int buildNumber, BuildState buildState)` Finds the last `BuildResultsSummary` before buildNumber with `BuildState`
`<T extends ResultsSummary> T`	`findLastResultBefore(String planKey, int buildNumber, Class<T> aClass, boolean includeOnceOffBuilds)` Finds the last successful or failed `ResultsSummary` before buildNumber
`<T extends ResultsSummary> T`	`findLastResultSummaryWithState(PlanKey planKey, BuildState buildState, Class<T> aClass)`
`List<ResultsSummary>`	`findLatestFailedResultSummaries()` Find the failed result summaries for all TopLevelPlans in Bamboo that have occurred in the last X days, where x is the constant NUMBER_OF_DAYS_TO_FILTER
`List<ResultsSummary>`	`findLatestResultsSummaries()` Find the result summaries for all TopLevelPlans in Bamboo that have occurred in the last X days, where x is the constant NUMBER_OF_DAYS_TO_FILTER
`Iterable<PlanKey>`	`findPlanKeysFromAllOrphanedResultSummaries()` Scans database for all the `ResultsSummary` objects in the database that do not have a matching `Plan`
`<T extends ResultsSummary> List<T>`	`findResultsSummaries(ResultsSummaryCriteria criteria)` Searches for `ResultsSummary` objects given a `ResultsSummaryCriteria`.
`<T extends ResultsSummary> List<T>`	`findResultSummariesForExpiry(ExpiryCriteria criteria)` Searches for `ResultsSummary` objects given a `ExpiryCriteria`.
`List<ResultsSummary>`	`getAfterSummaries(ImmutablePlan plan, int buildNumber, int maxCount)` Returns build results strictly after given build number.
`<T extends ResultsSummary> Collection<T>`	`getAllActiveResultSummariesForPlan(PlanKey planKey, Class<T> aClass)` Returns all the `ResultsSummary` in a `LifeCycleState.PENDING`, `LifeCycleState.QUEUED`, `LifeCycleState.IN_PROGRESS` state with the given `Class` See also `LifeCycleState.isActive(LifeCycleState)` and `ImmutableResultsSummary.isActive()`
`<T extends ResultsSummary> Collection<T>`	`getAllBuildResultSummariesInBuildState(BuildState state, Class<T> aClass)` Returns all the `BuildResultsSummary` in requested build state.
`<T extends ResultsSummary> Collection<T>`	`getAllBuildResultSummariesInLifeCycleState(LifeCycleState state, Class<T> aClass)` Returns all the `BuildResultsSummary` in requested lifecycle state.
`<T extends ResultsSummary> Collection<T>`	`getAllBuildResultSummariesInUnknownState(Class<T> aClass)` Returns all the `BuildResultsSummary` in a `BuildState.UNKNOWN` state This will not return records marked for deletion.
`Collection<BuildResultsSummary>`	`getAllInProgressBuildResultSummaries()` Returns all the `BuildResultsSummary` in a `LifeCycleState.IN_PROGRESS` state This will not return records marked for deletion.
`<T extends ResultsSummary> Collection<T>`	`getAllInProgressResultSummaries(Class<T> aClass)` Returns all the `ResultsSummary` in a `LifeCycleState.IN_PROGRESS` state with the given `Class` This will not return records marked for deletion.
`<T extends ResultsSummary> Collection<T>`	`getAllPendingResultSummaries(Class<T> aClass)` Returns all the `ResultsSummary` in a `LifeCycleState.PENDING` state with the given `Class` This will not return records marked for deletion.
`<T extends ResultsSummary> Collection<T>`	`getAllQueuedResultSummaries(Class<T> aClass)` Returns all the `ResultsSummary` in a `LifeCycleState.QUEUED` state with the given `Class` This will not return records marked for deletion.
`<T extends ResultsSummary> List<T>`	`getAllResultSummariesForPlan(Plan plan)` Get all the `ResultsSummary`s for the given `Plan`
`List<ResultsSummary>`	`getBeforeSummaries(ImmutablePlan plan, int buildNumber, int maxCount)` Returns build results strictly before given build number.
`ResultsSummary`	`getBreakingBuild(ResultsSummary summary)`
`ChainStageResult`	`getChainStageResultById(long id)` Returns a `ChainStageResult` by its id
`<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`.
`BuildResultsSummary`	`getFirstBuildSummary(PlanKey planKey)` Returns the first available `BuildResultsSummary` for the given `PlanKey`
`ResultsSummary`	`getFixingBuild(ResultsSummary summary)` Returns the first successful `BuildResultsSummary` for given `BuildResultsSummary`.
`List<LinkedJiraIssue>`	`getJiraIssuesForBuildResults(List<ResultsSummary> buildResults)` Retrieves a list of `LinkedJiraIssue` linked to the given build result summaries
`List<LinkedJiraIssue>`	`getJiraIssuesForPlanKey(PlanKey planKey)` Retrieves a list of `LinkedJiraIssue` that are linked to the given build.
`<T extends ResultsSummary> T`	`getLastResultSummary(String planKey, Class<T> aClass)` Returns the latest completed `ResultsSummary` for the plan represented by planKey
`List<ResultsSummary>`	`getNeighbouringSummaries(ImmutablePlan plan, int buildNumber, int maxCount)` Returns build results "around" given build number.
`List<ResultsSummary>`	`getNeighbouringSummaries(Plan plan, int currentBuildNumber)` Returns build results "around" given build number
`int`	`getNumberOfConcurrentlyRunningBuilds(PlanKey planKey)` Get the number of concurrently running builds for planKey
`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 build)` Returns the number of finished results available for the given `Plan`
`ChainResultsSummary`	`getParentResultSummary(ResultsSummary summary)` Get (@link ChainResultsSummary} containing given `ResultsSummary`
`List<PlanKey>`	`getPlanKeysSortedByNumberOfFinalizedResultSummaries()`
`<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, all lazy initialized collections can be eagerly read
`Long`	`getResultsSummaryId(PlanResultKey planResultKey)` Return `ResultsSummary`'s database id.
`<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(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>`	`getResultSummariesForPlan(ImmutablePlan plan, int firstResult, int maxResults)` Get the `ResultsSummary`s for the given `Plan`.
`<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`
`int`	`markResultSummariesForDeletion(PlanKey planKey)` Mass update of all `ResultsSummary` records in the database related to a Plan identified by planKey.
`int`	`moveResultSummaries(PlanKey oldPlanKey, PlanKey newPlanKey)` Reassigns plan key ResultsSummaries associated with selected plan key.
`int`	`removeResultsSummariesForPlan(PlanKey planKey)` Remove all resultSummary objects for the given plan.
`void`	`removeResultsSummary(ResultsSummary buildResultsSummary)` Removes the passed result summary
`long`	`scrollResultSummaries(String buildKey, ResultDataRead resultDataRead, Consumer<ResultsSummary> consumer)` Scroll through and execute function for each of ResultsSummary (Build and Chain) Objects passed to function are not fully initialized.
`long`	`scrollVariableSubstitutionForExport(Consumer<VariableSubstitution> consumer)` Scroll through and execute function for each of VariableSubstitution Objects passed to function are not fully initialized.

Methods inherited from interface com.atlassian.bamboo.persistence3.BambooObjectDao
countAll, countWithRestriction, delete, deleteAll, findAll, findById, merge, save, saveAll

Field Detail
- NUMBER_OF_DAYS_TO_FILTER
```
static final int NUMBER_OF_DAYS_TO_FILTER
```
  See Also:
  
  Constant Field Values

Method Detail

getAllBuildResultSummariesInUnknownState
```
@NotNull
<T extends ResultsSummary> Collection<T> getAllBuildResultSummariesInUnknownState(Class<T> aClass)
```
Returns all the BuildResultsSummary in a BuildState.UNKNOWN state This will not return records marked for deletion.

Returns:

summaries

getAllPendingResultSummaries
```
@NotNull
<T extends ResultsSummary> Collection<T> getAllPendingResultSummaries(Class<T> aClass)
```
Returns all the ResultsSummary in a LifeCycleState.PENDING state with the given Class This will not return records marked for deletion.

Returns:

summaries

getAllQueuedResultSummaries
```
@NotNull
<T extends ResultsSummary> Collection<T> getAllQueuedResultSummaries(Class<T> aClass)
```
Returns all the ResultsSummary in a LifeCycleState.QUEUED state with the given Class This will not return records marked for deletion.

Returns:

summaries

getAllInProgressResultSummaries
```
@NotNull
<T extends ResultsSummary> Collection<T> getAllInProgressResultSummaries(Class<T> aClass)
```
Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state with the given Class This will not return records marked for deletion.

Returns:

summaries

getAllActiveResultSummariesForPlan

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

Returns all the ResultsSummary in a LifeCycleState.PENDING, LifeCycleState.QUEUED, LifeCycleState.IN_PROGRESS state with the given Class See also LifeCycleState.isActive(LifeCycleState) and ImmutableResultsSummary.isActive()

Returns:: summaries

getFinalizedResultSummariesForPlan

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

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

Type Parameters:: T -
Parameters:: planKey -; aClass -; firstResult - - specifies the first result to be included in the list.; maxResults - - specifies the length of the result; 0 for all results;
Returns:

getNumberOfConcurrentlyRunningBuilds
```
int getNumberOfConcurrentlyRunningBuilds(PlanKey planKey)
```
Get the number of concurrently running builds for planKey

Parameters:

planKey -

Returns:

getResultsSummaryId
```
@Internal
 @Nullable
Long getResultsSummaryId(@NotNull
                                              PlanResultKey planResultKey)
```
Return ResultsSummary's database id. This method is intended for internal use (currently in importer)

Parameters:

planResultKey - plan result key of ResultsSummary to be found

Returns:

id of ResultsSummary or null if not found

getResultsSummary

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

Lookup ResultsSummary by PlanResultKey and expected type

Type Parameters:: T -
Parameters:: planResultKey -; aClass -
Returns:: resultSummary

getResultsSummary

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

Lookup ResultsSummary by PlanResultKey and expected type, all lazy initialized collections can be eagerly read

Type Parameters:: T -
Parameters:: planResultKey -; aClass -; dataRead -
Returns:: resultSummary

getAllBuildResultSummariesInBuildState

@NotNull
<T extends ResultsSummary> Collection<T> getAllBuildResultSummariesInBuildState(@NotNull
                                                                                         BuildState state,
                                                                                         Class<T> aClass)

Returns all the BuildResultsSummary in requested build state. This will not return records marked for deletion.

Parameters:: state -; aClass -
Returns:: summaries

getAllBuildResultSummariesInLifeCycleState

@NotNull
<T extends ResultsSummary> Collection<T> getAllBuildResultSummariesInLifeCycleState(@NotNull
                                                                                             LifeCycleState state,
                                                                                             Class<T> aClass)

Returns all the BuildResultsSummary in requested lifecycle state. This will not return records marked for deletion.

Parameters:: state -; aClass -
Returns:: summaries

getAllInProgressBuildResultSummaries
```
@NotNull
Collection<BuildResultsSummary> getAllInProgressBuildResultSummaries()
```
Returns all the BuildResultsSummary in a LifeCycleState.IN_PROGRESS state This will not return records marked for deletion.

Returns:

summaries

getFirstBuildSummary

@Nullable
BuildResultsSummary getFirstBuildSummary(@NotNull
                                                   PlanKey planKey)

Returns the first available BuildResultsSummary for the given PlanKey

Parameters:: planKey -
Returns:: buildResult

getLastResultSummary

<T extends ResultsSummary> T getLastResultSummary(String planKey,
                                                  Class<T> aClass)

Returns the latest completed ResultsSummary for the plan represented by planKey

Parameters:: planKey -
Returns:: buildResult

getNumberOfFinishedResults
```
long getNumberOfFinishedResults(Plan build)
```
Returns the number of finished results available for the given Plan

Parameters:

build -

Returns:

numberOfResults

getNumberOfFinalizedResults
```
long getNumberOfFinalizedResults(@NotNull
                                 ImmutablePlan plan)
```
Get number of the ResultsSummarys in a LifeCycleState.FINISHED or LifeCycleState.NOT_BUILT state for the given Plan

Parameters:

plan -

Returns:

number of summaries

getNeighbouringSummaries

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

Returns build results "around" given build number

Parameters:: plan -; currentBuildNumber -
Returns:

getNeighbouringSummaries
```
@NotNull
List<ResultsSummary> getNeighbouringSummaries(@NotNull
                                                       ImmutablePlan plan,
                                                       int buildNumber,
                                                       int maxCount)
```
Returns build results "around" given build number.

Parameters:

plan - the plan to return results for

buildNumber - the build number to search around

maxCount - the maximum number of builds to return

Returns:

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

getBeforeSummaries
```
@NotNull
List<ResultsSummary> getBeforeSummaries(@NotNull
                                                 ImmutablePlan plan,
                                                 int buildNumber,
                                                 int maxCount)
```
Returns build results strictly before given build number.

Parameters:

plan - the plan to return results for

buildNumber - the build number to search before

maxCount - the maximum number of builds to return

Returns:

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

getAfterSummaries
```
@NotNull
List<ResultsSummary> getAfterSummaries(@NotNull
                                                ImmutablePlan plan,
                                                int buildNumber,
                                                int maxCount)
```
Returns build results strictly after given build number.

Parameters:

plan - the plan to return results for

buildNumber - the build number to search after

maxCount - the maximum number of builds to return

Returns:

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

getBreakingBuild

@Nullable
ResultsSummary getBreakingBuild(ResultsSummary summary)

getFixingBuild
```
@Nullable
ResultsSummary getFixingBuild(ResultsSummary summary)
```
Returns the first successful BuildResultsSummary for given BuildResultsSummary. The input build is returned if it is successful.

Parameters:

summary -

Returns:

null if there is no fixing build.

findAnyResultSummary

@NotNull
<T extends ResultsSummary> T findAnyResultSummary(@NotNull
                                                           ResultsSummaryCriteria criteria,
                                                           ResultDataRead dataRead)

Searches for any ResultsSummary object given a ResultsSummaryCriteria. Note that if criteria does not specify order then result of this method might be non-deterministic.

Parameters:: criteria -
Returns:: List of BuildResultsSummary

findResultsSummaries
```
@NotNull
<T extends ResultsSummary> List<T> findResultsSummaries(@NotNull
                                                                 ResultsSummaryCriteria criteria)
```
Searches for ResultsSummary objects given a ResultsSummaryCriteria. Note that if criteria does not specify maxResults property, a hard cap of 10000 results is applied to search operation.

Parameters:

criteria -

Returns:

List of BuildResultsSummary

moveResultSummaries

@Internal
int moveResultSummaries(@NotNull
                                  PlanKey oldPlanKey,
                                  @NotNull
                                  PlanKey newPlanKey)

Reassigns plan key ResultsSummaries associated with selected plan key.

Parameters:: oldPlanKey - the plan key to move from; newPlanKey - the plan key to move to
Returns:: the number of result summaries updated

countResultSummaries
```
long countResultSummaries(@NotNull
                          ResultsSummaryCriteria criteria)
```
Count the number of ResultsSummary objects given a ResultsSummaryCriteria.

Parameters:

criteria -

Returns:

long representing the count of ResultsSummary that match the criteria.

findResultSummariesForExpiry

@NotNull
<T extends ResultsSummary> List<T> findResultSummariesForExpiry(@NotNull
                                                                         ExpiryCriteria criteria)

Searches for ResultsSummary objects given a ExpiryCriteria.

Type Parameters:: T - type of result objects (determined according to given criteria)
Parameters:: criteria - search constraints
Returns:: List of ResultsSummary

removeResultsSummariesForPlan
```
int removeResultsSummariesForPlan(@NotNull
                                  PlanKey planKey)
```
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

Parameters:

planKey - identifier of plan to remove results for.

Returns:

number of deleted ResultsSummary objects

findPlanKeysFromAllOrphanedResultSummaries
```
Iterable<PlanKey> findPlanKeysFromAllOrphanedResultSummaries()
```
Scans database for all the ResultsSummary objects in the database that do not have a matching Plan

Returns:

list of distinct PlanKeys they reference ordered by BRS, CRS

countBuildResultsSummaries

int countBuildResultsSummaries(@NotNull
                               String planKey)

countBuildResultsSummaries
```
int countBuildResultsSummaries()
```
Count all result summaries records. This will not count records marked for deletion.

Returns:

removeResultsSummary

void removeResultsSummary(@NotNull
                          ResultsSummary buildResultsSummary)

Removes the passed result summary

Parameters:: buildResultsSummary - -

findBuildResultsSummariesByJiraIssues

@NotNull
List<ResultsSummary> findBuildResultsSummariesByJiraIssues(@Nullable
                                                                    List<String> issueKeys)

Get a list of results summaries associated with the list of issue keys. This will not return records marked for deletion.

Parameters:: issueKeys -
Returns:: list of result summaries

findBuildResultsSummariesByProjectKey
```
@NotNull
List<ResultsSummary> findBuildResultsSummariesByProjectKey(@Nullable
                                                                    String jiraProjectKey)
```
Retrieve a list of results summaries associated with given JIRA project key This will not return records marked for deletion.

Parameters:

jiraProjectKey - - JIRA project key (prefix of the jira issues e.g. 'BAM')

Returns:

a list of results summaries associated with given JIRA project key

getJiraIssuesForBuildResults

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

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

Parameters:: buildResults -
Returns:

getJiraIssuesForPlanKey

List<LinkedJiraIssue> getJiraIssuesForPlanKey(@NotNull
                                              PlanKey planKey)

Retrieves a list of LinkedJiraIssue that are linked to the given build.

Parameters:: planKey -
Returns:

findBuildsForImageConfiguration

@NotNull
List<BuildResultsSummary> findBuildsForImageConfiguration(String planKey,
                                                                   ElasticImageConfiguration elasticImageConfiguration,
                                                                   @Nullable
                                                                   BuildState buildState,
                                                                   int maxResults)

Searcher for builds of an image

Parameters:: planKey -; elasticImageConfiguration -; buildState -; maxResults -
Returns:

findLastBuildResultBeforeWithTests

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

Type Parameters:: T - of result
Parameters:: planResultKey - of the result; includeOnceOffBuilds - tells whether we also consider 'once-off' builds (the ones with custom revision) or should we skip them in our calculations; aClass - of
Returns:: resultsSummary

findLastResultBefore

@Nullable
<T extends ResultsSummary> T findLastResultBefore(@NotNull
                                                            String planKey,
                                                            int buildNumber,
                                                            Class<T> aClass,
                                                            boolean includeOnceOffBuilds)

Finds the last successful or failed ResultsSummary before buildNumber

Parameters:: planKey -; buildNumber -; includeOnceOffBuilds - tells whether we also consider 'once-off' builds (the ones with custom revision) or should we skip them in our calculations
Returns:: buildResult

findFirstResultAfter

@Nullable
<T extends ResultsSummary> T findFirstResultAfter(@NotNull
                                                            String planKey,
                                                            int buildNumber,
                                                            Class<T> aClass)

Finds the first successful or failed BuildResultsSummary after buildNumber

Parameters:: planKey -; buildNumber -; aClass -
Returns:: buildResult

findFirstBuildResultWithBuildStateAfter

@Nullable
ResultsSummary findFirstBuildResultWithBuildStateAfter(@NotNull
                                                                 String planKey,
                                                                 int buildNumber,
                                                                 @NotNull
                                                                 BuildState buildState)

Finds the last successful BuildResultsSummary after buildNumber

Parameters:: planKey -; buildNumber -; buildState -
Returns:: buildResult

findLastBuildResultWithBuildStateBefore

ResultsSummary findLastBuildResultWithBuildStateBefore(@NotNull
                                                       String planKey,
                                                       int buildNumber,
                                                       @NotNull
                                                       BuildState buildState)

Finds the last BuildResultsSummary before buildNumber with BuildState

Parameters:: planKey -; buildNumber -; buildState -
Returns:: buildResult

findFirstBuildResultWithBuildStateBetween

@Nullable
ResultsSummary findFirstBuildResultWithBuildStateBetween(@NotNull
                                                                   String planKey,
                                                                   int lowerBuildNumber,
                                                                   int upperBuildNumber,
                                                                   @NotNull
                                                                   BuildState buildState)

Returns the first build that matches BuildState between the given build number range Note that this function is inclusive of the upper and lower bound

Parameters:: planKey -; lowerBuildNumber -; upperBuildNumber -; buildState -
Returns:: buildResult

findFirstBuildNumberAfter

@Nullable
Integer findFirstBuildNumberAfter(@NotNull
                                            String planKey,
                                            int buildNumber)

Returns the build number of next existing build results.

Parameters:: planKey -; buildNumber -
Returns:: null if no build result summary with higher number exists

findLastBuildNumberBefore

@Nullable
Integer findLastBuildNumberBefore(@NotNull
                                            String planKey,
                                            int buildNumber)

Returns the build number of previous existing build results.

Parameters:: planKey -; buildNumber -
Returns:: null if no build result summary with lower number exists

findBuildResultsWithArtifacts
```
List<Pair<ArtifactLink,BuildResultsSummary>> findBuildResultsWithArtifacts(String planKey)
```
Find all build results which have matching artifacts. Sorted by buildNumber, ascending

Parameters:

planKey -

Returns:

scrollResultSummaries
```
long scrollResultSummaries(@NotNull
                           String buildKey,
                           @NotNull
                           ResultDataRead resultDataRead,
                           @NotNull
                           Consumer<ResultsSummary> consumer)
```
Scroll through and execute function for each of ResultsSummary (Build and Chain) Objects passed to function are not fully initialized. Collections are empty and related objects have only id set.

Parameters:

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

consumer - consumer to accept each of the BuildResultSummaries

resultDataRead - if the data should be loaded lazy or eagerly

Returns:

number of traversed rows

getChainStageResultById
```
@Nullable
ChainStageResult getChainStageResultById(long id)
```
Returns a ChainStageResult by its id

Returns:

chainStageResult

getAllResultSummariesForPlan

<T extends ResultsSummary> List<T> getAllResultSummariesForPlan(@NotNull
                                                                Plan plan)

Get all the ResultsSummarys for the given Plan

Type Parameters:: T -
Parameters:: plan -
Returns:: summaries

getResultSummariesForPlan
```
@NotNull
<T extends ResultsSummary> List<T> getResultSummariesForPlan(@NotNull
                                                                      ImmutablePlan plan,
                                                                      int firstResult,
                                                                      int maxResults)
```
Get the ResultsSummarys for the given Plan. Results are sorted by build number (descending). User can skip first n result and request maximum number of results. Note: fetching huge amount of data in single call should be avoided.

Type Parameters:

T -

Parameters:

plan -

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

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

Returns:

summaries

getResultSummariesForPlanByLifeCycleState

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

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

Type Parameters:: T -
Parameters:: plan -; lifeCycleState -; firstResult - specifies the first item to be return (0 base index). Negative values treated as 0.; maxResults - specifies amount of the results to be returned. Value <= 0 returns everything.
Returns:: summaries

getResultSummariesByChangeSetId
```
<T extends ResultsSummary> List<T> getResultSummariesByChangeSetId(@NotNull
                                                                   String changeSetId,
                                                                   @NotNull
                                                                   Class<T> discriminator)
```
Get a list of all build results containing a commit with the given 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 getResultSummariesByCheckoutChangesetId(String, Class).

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
```
<T extends ResultsSummary> 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.

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 getResultSummariesByChangeSetId(String, Class).

Parameters:

changesetId - of the 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

<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. This will not return records marked for deletion.

Type Parameters:: T - extends ResultSummary
Parameters:: repositoryId - of the repository; changeSetId - of the commit; discriminator - class of the ResultSummary interface required
Returns:: List of ResultsSummary (ResultSummary as determined by discriminator) containing a commit with the given changeSetId
Since:: 5.7

getResultSummariesByChangeSetIds

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

Get a list of all build results containing a commit with any of the given changeset IDs. This will not return records marked for deletion.

Parameters:: changeSetIds - of the commits; discriminator - class of the ResultSummary interface required
Returns:: List of ResultsSummary (ResultSummary as determined by discriminator) containing a commit with the any of the given changeSetIds

getParentResultSummary
```
@Nullable
ChainResultsSummary getParentResultSummary(ResultsSummary summary)
```
Get (@link ChainResultsSummary} containing given ResultsSummary

Parameters:

summary -

Returns:

getStageForResult
```
@Nullable
ChainStageResult getStageForResult(ResultsSummary resultsSummary)
```
Get (@link ChainStageResult} containing given ResultsSummary

Parameters:

resultsSummary -

Returns:

findLatestResultsSummaries
```
List<ResultsSummary> findLatestResultsSummaries()
```
Find the result summaries for all TopLevelPlans in Bamboo that have occurred in the last X days, where x is the constant NUMBER_OF_DAYS_TO_FILTER

Returns:

list of latest results summaries

findLatestFailedResultSummaries
```
List<ResultsSummary> findLatestFailedResultSummaries()
```
Find the failed result summaries for all TopLevelPlans in Bamboo that have occurred in the last X days, where x is the constant NUMBER_OF_DAYS_TO_FILTER

Returns:

list of latest results summaries

findChainResultsWithJobLabelled
```
List<ChainResultsSummary> findChainResultsWithJobLabelled(ResultsSummaryCriteria criteria,
                                                          List<Label> labels)
```
Searches through all chains to find any that have jobs which match the given labels. The list of chains is then filtered if required, using other criteria elements. Currently the only used criteria are:
- buildKey
- toBuildDate
- toBuildNumber
This is to ensure performance is consistent and reduce the possibility of conflicts.
Parameters:

criteria - containing the restrictions for the chains to be returned

labels - that the jobs can be associated with

Returns:

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

findLastResultSummaryWithState

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

Type Parameters:: T -
Parameters:: planKey -; buildState -; aClass -
Returns:: the last ResultsSummary with the provided BuildState

countResultsWithState

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

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

Parameters:: planKey - the key of plan to analyse; lowerBuildNumber - the build number to start the count with; upperBuildNumber - the build number to end the count with; buildState - the state that will be counted
Returns:: the count

scrollVariableSubstitutionForExport
```
long scrollVariableSubstitutionForExport(@NotNull
                                         Consumer<VariableSubstitution> consumer)
```
Scroll through and execute function for each of VariableSubstitution Objects passed to function are not fully initialized. Collections are empty and related objects have only id set.

Parameters:

consumer - consumer to accept each of the VariableSubstitution

Returns:

number of traversed rows

markResultSummariesForDeletion
```
int markResultSummariesForDeletion(@NotNull
                                   PlanKey planKey)
```
Mass update of all ResultsSummary records in the database related to a Plan identified by planKey.

Parameters:

planKey - key of a plan

Returns:

number of updated records

getPlanKeysSortedByNumberOfFinalizedResultSummaries

@NotNull
List<PlanKey> getPlanKeysSortedByNumberOfFinalizedResultSummaries()

calculateQueueDuration
```
@Nullable
Long calculateQueueDuration(@NotNull
                                      ChainResultsSummary resultsSummary)
```
Calculates queueDuration value for a chain result as a maximum value of (vcsUpdateTime - queueTime) for all related job results.

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

queueDuration value or null if there are no related BuildResultsSummary records

Since:

5.4

calculateVcsUpdateDuration
```
@Nullable
Long calculateVcsUpdateDuration(@NotNull
                                          ChainResultsSummary resultsSummary)
```
Calculates vcsUpdateDuration value for a chain result as a maximum value of (buildDate - vcsUpdateTime) for all related job results.

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

vcsUpdateDuration value or null if there are no related BuildResultsSummary records

Since:

5.4

findAllBuildResultsNumbers

List<Integer> findAllBuildResultsNumbers(PlanKey planKey)

findBuildResultsNumberRange
```
@NotNull
Range<Integer> findBuildResultsNumberRange(PlanKey planKey)
```
Finds minimum and maximum build number for a plan. Works for both chains and jobs.

Parameters:

planKey -

Returns:

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

findChainResultsWithFormatVersionLessThan

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

Deprecated. internal use only

Interface BuildResultsSummaryDao

Field Summary

Method Summary

Methods inherited from interface com.atlassian.bamboo.persistence3.BambooObjectDao

Field Detail

NUMBER_OF_DAYS_TO_FILTER

Method Detail

getAllBuildResultSummariesInUnknownState

getAllPendingResultSummaries

getAllQueuedResultSummaries

getAllInProgressResultSummaries

getAllActiveResultSummariesForPlan

getFinalizedResultSummariesForPlan

getNumberOfConcurrentlyRunningBuilds

getResultsSummaryId

getResultsSummary

getResultsSummary

getAllBuildResultSummariesInBuildState

getAllBuildResultSummariesInLifeCycleState

getAllInProgressBuildResultSummaries

getFirstBuildSummary

getLastResultSummary

getNumberOfFinishedResults

getNumberOfFinalizedResults

getNeighbouringSummaries

getNeighbouringSummaries

getBeforeSummaries

getAfterSummaries

getBreakingBuild

getFixingBuild

findAnyResultSummary

findResultsSummaries

moveResultSummaries

countResultSummaries

findResultSummariesForExpiry

removeResultsSummariesForPlan

findPlanKeysFromAllOrphanedResultSummaries

countBuildResultsSummaries

countBuildResultsSummaries

removeResultsSummary

findBuildResultsSummariesByJiraIssues

findBuildResultsSummariesByProjectKey

getJiraIssuesForBuildResults

getJiraIssuesForPlanKey

findBuildsForImageConfiguration

findLastBuildResultBeforeWithTests

findLastResultBefore

findFirstResultAfter

findFirstBuildResultWithBuildStateAfter

findLastBuildResultWithBuildStateBefore

findFirstBuildResultWithBuildStateBetween

findFirstBuildNumberAfter

findLastBuildNumberBefore

findBuildResultsWithArtifacts

scrollResultSummaries

getChainStageResultById

getAllResultSummariesForPlan

getResultSummariesForPlan

getResultSummariesForPlanByLifeCycleState

getResultSummariesByChangeSetId

getResultSummariesByCheckoutChangesetId

getResultSummariesByChangeSetIdAndRepository

getResultSummariesByChangeSetIds

getParentResultSummary

getStageForResult

findLatestResultsSummaries

findLatestFailedResultSummaries

findChainResultsWithJobLabelled

findLastResultSummaryWithState

countResultsWithState

scrollVariableSubstitutionForExport

markResultSummariesForDeletion

getPlanKeysSortedByNumberOfFinalizedResultSummaries

calculateQueueDuration

calculateVcsUpdateDuration

findAllBuildResultsNumbers

findBuildResultsNumberRange

findChainResultsWithFormatVersionLessThan