com.atlassian.bamboo.resultsummary
Interface BuildResultsSummaryManager

All Known Implementing Classes:

BuildResultsSummaryManagerImpl

public interface BuildResultsSummaryManager

Primarily manages interactions with the BuildResultsSummary from the database. Slowly, it will encompass all methods that deals with the all build results interaction.

Method Summary

int	countBuildResultsSummaries()
int	countBuildResultsSummaries(java.lang.String planKey)
int	countBuildResultsSummariesForAgent(BuildAgent buildAgent)
int	countFailedBuildResultsSummariesForAgent(BuildAgent buildAgent)
java.util.List<ExtendedBuildResultsSummary>	findBuildResultsSummaries(BuildResultsSummaryCriteria criteria) Searches for BuildResultsSummary objects given a BuildResultsSummaryCriteria
java.util.List<ExtendedBuildResultsSummary>	findBuildResultsSummariesByJiraIssues(java.util.List<java.lang.String> issueKeys)
java.util.List<ExtendedBuildResultsSummary>	findBuildResultsSummariesByProjectKey(java.lang.String projectKey)
java.util.List<LinkedJiraIssue>	findJiraIssuesForBuild(Build build) Retrieves a list of LinkedJiraIssue linked to the given Build
java.util.List<LinkedJiraIssue>	findJiraIssuesForBuildResults(java.util.List<BuildResultsSummary> buildResults) Retrieves a list of LinkedJiraIssue linked to the given build result summaries
BuildResultsSummary	generateSummaryFromBuildResults(BuildContext buildContext, CurrentlyBuilding currentlyBuilding, BuildResults buildResults)
BuildResultsSummary	generateSummaryFromBuildResults(BuildContext buildContext, CurrentlyBuilding currentlyBuilding, BuildResults buildResults, Build build)
java.util.List<ExtendedBuildResultsSummary>	getAllBuildResultsSummaries(Build build) Returns all ExtendedBuildResultsSummary for the passed Build.
java.util.List<ExtendedBuildResultsSummary>	getAllBuildResultsSummariesForAgent(java.lang.Long agentId) Returns all ExtendedBuildResultsSummary for the passed BuildAgent's id.
java.util.List<ExtendedBuildResultsSummary>	getAllFailedResultsSummaries(Build build) Returns all Failed ExtendedBuildResultsSummary for the passed Build.
long	getAverageBuildTime(Build build, int numberOfResults) Returns average build duration for given number of builds
BuildResultsSummary	getBreakingBuild(BuildResultsSummary buildResultsSummary)
ExtendedBuildResultsSummary	getBuildResultsSummary(Build build, int buildNumber)
ExtendedBuildResultsSummary	getBuildResultsSummary(java.lang.String buildKey, int buildNumber)
BuildResultsSummary	getBuildResultsSummaryById(long id)
BuildResultsSummary	getFirstBuildSummary(Build build)
ExtendedBuildResultsSummary	getLastBuildForAgent(java.lang.String planKey, java.lang.Long agentId)
ExtendedBuildResultsSummary	getLastBuildForImageConfiguration(java.lang.String planKey, ElasticImageConfiguration configuration)
ExtendedBuildResultsSummary	getLastBuildSummary(Build build)
ExtendedBuildResultsSummary	getLastBuildSummary(java.lang.String planKey)
java.util.List<ExtendedBuildResultsSummary>	getLastNBuildResultsSummaries(Build build, int numberOfResults) Returns the most recent n build results.
java.util.List<ExtendedBuildResultsSummary>	getLastNFailedResultsSummaries(Build build, int numberOfResults) Returns the most recent n failed build results.
ExtendedBuildResultsSummary	getLastSuccessfulBuildForAgent(java.lang.String planKey, java.lang.Long agentId)
ExtendedBuildResultsSummary	getLastSuccessfulBuildForImageConfiguration(java.lang.String planKey, ElasticImageConfiguration configuration)
ExtendedBuildResultsSummary	getLastSuccessfulBuildSummary(java.lang.String planKey)
java.util.List<ExtendedBuildResultsSummary>	getLatestbuildResultSummaries() 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
java.util.List<ExtendedBuildResultsSummary>	getLatestFailedBuildResultSummaries() 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
java.util.List<ExtendedBuildResultsSummary>	getLatestSummariesForAgent(java.lang.Long agentId)
java.util.List	getNeighbouringSummaries(Build build, int buildNumber) Returns all the BuildResultsSummary objects that matches the passed build numbers
long	getNumberOfResults(Build build)
void	removeArtifacts(Build build, int buildNumber) Removes the artifact for a given build
void	removeBuildResult(Build build, int buildNumber) Removes a build result for a particular build.
void	removeBuildResultsSummariesForBuild(Build build) Remove the BuildResultsSummary objects from the database.
void	saveBuildResultsSummary(BuildResultsSummary buildResultsSummary)

Method Detail

getAllBuildResultsSummaries

@NotNull
java.util.List<ExtendedBuildResultsSummary> getAllBuildResultsSummaries(@NotNull
                                                                                Build build)

Returns all ExtendedBuildResultsSummary for the passed Build. Sorted by oldest first.

Parameters:

build -

Returns:

getAllBuildResultsSummariesForAgent

@NotNull
java.util.List<ExtendedBuildResultsSummary> getAllBuildResultsSummariesForAgent(@NotNull
                                                                                        java.lang.Long agentId)

Returns all ExtendedBuildResultsSummary for the passed BuildAgent's id.

Parameters:

agentId -

Returns:

getAllFailedResultsSummaries

@NotNull
java.util.List<ExtendedBuildResultsSummary> getAllFailedResultsSummaries(@NotNull
                                                                                 Build build)

Returns all Failed ExtendedBuildResultsSummary for the passed Build. Sorted by oldest first.

Parameters:

build -

Returns:

getLastNFailedResultsSummaries

@NotNull
java.util.List<ExtendedBuildResultsSummary> getLastNFailedResultsSummaries(@NotNull
                                                                                   Build build,
                                                                                   int numberOfResults)

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

Parameters:

build -

numberOfResults - must be > 0

Returns:

getLastNBuildResultsSummaries

@NotNull
java.util.List<ExtendedBuildResultsSummary> getLastNBuildResultsSummaries(@NotNull
                                                                                  Build build,
                                                                                  int numberOfResults)

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

Parameters:

build -

numberOfResults - must be > 0

Returns:

getBuildResultsSummaryById

BuildResultsSummary getBuildResultsSummaryById(long id)

getBuildResultsSummary

ExtendedBuildResultsSummary getBuildResultsSummary(java.lang.String buildKey,
                                                   int buildNumber)

saveBuildResultsSummary

void saveBuildResultsSummary(BuildResultsSummary buildResultsSummary)

generateSummaryFromBuildResults

BuildResultsSummary generateSummaryFromBuildResults(BuildContext buildContext,
                                                    CurrentlyBuilding currentlyBuilding,
                                                    BuildResults buildResults)

generateSummaryFromBuildResults

BuildResultsSummary generateSummaryFromBuildResults(BuildContext buildContext,
                                                    CurrentlyBuilding currentlyBuilding,
                                                    BuildResults buildResults,
                                                    Build build)

getFirstBuildSummary

BuildResultsSummary getFirstBuildSummary(Build build)

getLastBuildSummary

ExtendedBuildResultsSummary getLastBuildSummary(Build build)

getNumberOfResults

long getNumberOfResults(Build build)

getBuildResultsSummary

ExtendedBuildResultsSummary getBuildResultsSummary(Build build,
                                                   int buildNumber)

getAverageBuildTime

long getAverageBuildTime(@NotNull
                         Build build,
                         int numberOfResults)

Returns average build duration for given number of builds

Parameters:

build - - must not be null

numberOfResults - - How many build results to use in the average. must be greater 0

Returns:

Average build time. 0 if no build found.

getNeighbouringSummaries

java.util.List getNeighbouringSummaries(Build build,
                                        int buildNumber)

Returns all the BuildResultsSummary objects that matches the passed build numbers

Parameters:

build -

buildNumber -

Returns:

List of BuildResultsSummary

removeBuildResultsSummariesForBuild

void removeBuildResultsSummariesForBuild(@NotNull
                                         Build build)

Remove the BuildResultsSummary objects from the database. No events are triggered

Parameters:

build - @NotNull

getBreakingBuild

BuildResultsSummary getBreakingBuild(BuildResultsSummary buildResultsSummary)

getLatestbuildResultSummaries

java.util.List<ExtendedBuildResultsSummary> getLatestbuildResultSummaries()

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

Returns:

List of BuildResultsSummary

getLatestFailedBuildResultSummaries

java.util.List<ExtendedBuildResultsSummary> getLatestFailedBuildResultSummaries()

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

Returns:

List of BuildResultsSummary

findBuildResultsSummaries

@NotNull
java.util.List<ExtendedBuildResultsSummary> findBuildResultsSummaries(@NotNull
                                                                              BuildResultsSummaryCriteria criteria)

Searches for BuildResultsSummary objects given a BuildResultsSummaryCriteria

Parameters:

criteria - @NotNull

Returns:

List of ExtendedBuildResultsSummary

countBuildResultsSummaries

int countBuildResultsSummaries()

countBuildResultsSummaries

int countBuildResultsSummaries(@Nullable
                               java.lang.String planKey)

removeBuildResult

void removeBuildResult(Build build,
                       int buildNumber)

Removes a build result for a particular build. This fully removes everything about this particular build result and triggers off all appropriate events.

Parameters:

build - @NotNull

buildNumber - The build numner.

removeArtifacts

void removeArtifacts(Build build,
                     int buildNumber)

Removes the artifact for a given build

Parameters:

build - @NotNull

buildNumber - The build numner.

getLastSuccessfulBuildSummary

@Nullable
ExtendedBuildResultsSummary getLastSuccessfulBuildSummary(@NotNull
                                                                   java.lang.String planKey)

getLatestSummariesForAgent

@NotNull
java.util.List<ExtendedBuildResultsSummary> getLatestSummariesForAgent(@NotNull
                                                                               java.lang.Long agentId)

getLastBuildSummary

ExtendedBuildResultsSummary getLastBuildSummary(java.lang.String planKey)

findBuildResultsSummariesByJiraIssues

@NotNull
java.util.List<ExtendedBuildResultsSummary> findBuildResultsSummariesByJiraIssues(@Nullable
                                                                                          java.util.List<java.lang.String> issueKeys)

findBuildResultsSummariesByProjectKey

@NotNull
java.util.List<ExtendedBuildResultsSummary> findBuildResultsSummariesByProjectKey(@Nullable
                                                                                          java.lang.String projectKey)

findJiraIssuesForBuildResults

@NotNull
java.util.List<LinkedJiraIssue> findJiraIssuesForBuildResults(@NotNull
                                                                      java.util.List<BuildResultsSummary> buildResults)

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

Parameters:

buildResults -

Returns:

findJiraIssuesForBuild

@NotNull
java.util.List<LinkedJiraIssue> findJiraIssuesForBuild(@NotNull
                                                               Build build)

Retrieves a list of LinkedJiraIssue linked to the given Build

Parameters:

build -

Returns:

getLastBuildForAgent

@Nullable
ExtendedBuildResultsSummary getLastBuildForAgent(@NotNull
                                                          java.lang.String planKey,
                                                          @NotNull
                                                          java.lang.Long agentId)

getLastSuccessfulBuildForAgent

@Nullable
ExtendedBuildResultsSummary getLastSuccessfulBuildForAgent(@NotNull
                                                                    java.lang.String planKey,
                                                                    @NotNull
                                                                    java.lang.Long agentId)

getLastBuildForImageConfiguration

@Nullable
ExtendedBuildResultsSummary getLastBuildForImageConfiguration(@NotNull
                                                                       java.lang.String planKey,
                                                                       @NotNull
                                                                       ElasticImageConfiguration configuration)

getLastSuccessfulBuildForImageConfiguration

@Nullable
ExtendedBuildResultsSummary getLastSuccessfulBuildForImageConfiguration(@NotNull
                                                                                 java.lang.String planKey,
                                                                                 @NotNull
                                                                                 ElasticImageConfiguration configuration)

countBuildResultsSummariesForAgent

int countBuildResultsSummariesForAgent(@NotNull
                                       BuildAgent buildAgent)

countFailedBuildResultsSummariesForAgent

int countFailedBuildResultsSummariesForAgent(@NotNull
                                             BuildAgent buildAgent)