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

java.util.List<ExtendedBuildResultsSummary>	findBuildResultsSummaries(BuildResultsSummaryCriteria criteria) Searches for BuildResultsSummary objects given a BuildResultsSummaryCriteria
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>	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	getLastBuildSummary(Build build)
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	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:

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

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)