com.atlassian.bamboo.resultsummary
Class BuildResultsSummaryHibernateDao

java.lang.Object
  org.springframework.dao.support.DaoSupport
      org.springframework.orm.hibernate3.support.HibernateDaoSupport
          com.atlassian.bamboo.persistence3.StatelessSessionHibernateDaoSupport
              com.atlassian.bamboo.persistence3.BambooHibernateObjectDao<ResultsSummary>
                  com.atlassian.bamboo.resultsummary.BuildResultsSummaryHibernateDao

All Implemented Interfaces:

BambooObjectDao<ResultsSummary>, BuildResultsSummaryDao, org.springframework.beans.factory.InitializingBean

public class BuildResultsSummaryHibernateDao
extends BambooHibernateObjectDao<ResultsSummary>
implements BuildResultsSummaryDao

Field Summary

protected static String	BUILD_AGENT_ID
protected static String	BUILD_COMPLETED_DATE
protected static String	BUILD_NUMBER
protected static String	BUILD_STATE
protected static String	CREATION_DATE
protected static String	DELTA_STATE
protected static String	LIFE_CYCLE_STATE
static int	NEIGHBOURING_SUMMARIES_MAX_COUNT
protected static String	PLAN_KEY

Fields inherited from class org.springframework.dao.support.DaoSupport

logger

Fields inherited from interface com.atlassian.bamboo.resultsummary.BuildResultsSummaryDao

NUMBER_OF_DAYS_TO_FILTER

Constructor Summary

BuildResultsSummaryHibernateDao(BambooTransactionHibernateTemplate bambooTransactionHibernateTemplate)

Method Summary

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(long agentId, BuildState buildState) Count how many build results match the agent & optional build state.
int	countBuildResultsSummaries(String planKey)
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)
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 elasticImage, BuildState buildState, int maxResults) Searcher for builds of an image
<E extends ResultsSummary> E	findById(long id, Class<E> aClass) Find an entity by its id
List<ChainResultsSummary>	findChainResultsWithJobLabelled(ResultsSummaryCriteria queryCriteria, 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 expiryCriteria) Searches for ResultsSummary objects given a ExpiryCriteria.
<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 ResultsSummarys for the given Plan
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(Plan plan) Returns the first available BuildResultsSummary for the given Plan
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 currentBuildNumber, int neighbouringSummariesMaxCount) 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 ResultsSummarys or LifeCycleState.NOT_BUILT state for the given Plan
long	getNumberOfFinishedResults(Plan plan) 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 change set 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 change set 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 change set IDs.
<T extends ResultsSummary> List<T>	getResultSummariesForPlan(ImmutablePlan plan, int firstResult, int maxResults) Get the ResultsSummarys for the given Plan.
<T extends ResultsSummary> List<T>	getResultSummariesForPlanByLifeCycleState(Plan plan, 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).
ChainStageResult	getStageForResult(ResultsSummary summary) 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	removeResultsSummariesForPlan(PlanKey planKey) Remove all resultSummary objects for the given plan.
void	removeResultsSummary(ResultsSummary resultsSummary) Removes the passed result summary
long	scrollResultSummaries(String buildKey, ResultDataRead dataRead, 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.
long	scrollVariableSubstitutionForExport(com.google.common.base.Function<VariableSubstitution,Void> function) Scroll through and execute function for each of VariableSubstitution Objects passed to function are not fully initialized.
void	setPlanDiscriminatorRegistry(PlanDiscriminatorRegistry planDiscriminatorRegistry)
void	setResultsSummaryDiscriminatorRegistry(ResultsSummaryDiscriminatorRegistry resultsSummaryDiscriminatorRegistry)
void	setTestResultsHibernateDao(TestResultsHibernateDao testResultsHibernateDao)

Methods inherited from class com.atlassian.bamboo.persistence3.BambooHibernateObjectDao

countAll, countWithRestriction, delete, deleteAll, execute, executeCountQuery, executeReturnInt, executeReturnLong, findAll, save, saveAll

Methods inherited from class com.atlassian.bamboo.persistence3.StatelessSessionHibernateDaoSupport

getCacheAwareHibernateTemplate

Methods inherited from class org.springframework.orm.hibernate3.support.HibernateDaoSupport

checkDaoConfig, convertHibernateAccessException, createHibernateTemplate, getHibernateTemplate, getSession, getSession, getSessionFactory, releaseSession, setHibernateTemplate, setSessionFactory

Methods inherited from class org.springframework.dao.support.DaoSupport

afterPropertiesSet, initDao

Methods inherited from class java.lang.Object

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

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

countAll, countWithRestriction, delete, deleteAll, executeReturnInt, executeReturnLong, findAll, save, saveAll

Field Detail

CREATION_DATE

protected static final String CREATION_DATE

See Also:

Constant Field Values

BUILD_COMPLETED_DATE

protected static final String BUILD_COMPLETED_DATE

See Also:

Constant Field Values

BUILD_AGENT_ID

protected static final String BUILD_AGENT_ID

See Also:

Constant Field Values

BUILD_NUMBER

protected static final String BUILD_NUMBER

See Also:

Constant Field Values

PLAN_KEY

protected static final String PLAN_KEY

See Also:

Constant Field Values

BUILD_STATE

protected static final String BUILD_STATE

See Also:

Constant Field Values

LIFE_CYCLE_STATE

protected static final String LIFE_CYCLE_STATE

See Also:

Constant Field Values

DELTA_STATE

protected static final String DELTA_STATE

See Also:

Constant Field Values

NEIGHBOURING_SUMMARIES_MAX_COUNT

public static final int NEIGHBOURING_SUMMARIES_MAX_COUNT

See Also:

Constant Field Values

Constructor Detail

BuildResultsSummaryHibernateDao

public BuildResultsSummaryHibernateDao(BambooTransactionHibernateTemplate bambooTransactionHibernateTemplate)

Method Detail

getResultsSummaryId

public Long getResultsSummaryId(@NotNull
                                PlanResultKey planResultKey)

Description copied from interface: BuildResultsSummaryDao

Return ResultsSummary's database id. This method is intended for internal use (currently in importer)

Specified by:

getResultsSummaryId in interface BuildResultsSummaryDao

Parameters:

planResultKey - plan result key of ResultsSummary to be found

Returns:

id of ResultsSummary or null if not found

getResultsSummary

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

Description copied from interface: BuildResultsSummaryDao

Lookup ResultsSummary by PlanResultKey and expected type

Specified by:

getResultsSummary in interface BuildResultsSummaryDao

Returns:

resultSummary

getResultsSummary

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getResultsSummary in interface BuildResultsSummaryDao

Returns:

resultSummary

findById

public <E extends ResultsSummary> E findById(long id,
                                             @NotNull
                                             Class<E> aClass)

Description copied from interface: BambooObjectDao

Find an entity by its id

Specified by:

findById in interface BambooObjectDao<ResultsSummary>

Overrides:

findById in class BambooHibernateObjectDao<ResultsSummary>

Parameters:

id - id of entity

aClass - class of entity

Returns:

entity

getAllBuildResultSummariesInBuildState

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getAllBuildResultSummariesInBuildState in interface BuildResultsSummaryDao

Returns:

summaries

getAllBuildResultSummariesInLifeCycleState

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getAllBuildResultSummariesInLifeCycleState in interface BuildResultsSummaryDao

Returns:

summaries

getAllBuildResultSummariesInUnknownState

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

Description copied from interface: BuildResultsSummaryDao

Returns all the BuildResultsSummary in a BuildState.UNKNOWN state This will not return records marked for deletion.

Specified by:

getAllBuildResultSummariesInUnknownState in interface BuildResultsSummaryDao

Returns:

summaries

getAllPendingResultSummaries

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

Description copied from interface: BuildResultsSummaryDao

Returns all the ResultsSummary in a LifeCycleState.PENDING state with the given Class This will not return records marked for deletion.

Specified by:

getAllPendingResultSummaries in interface BuildResultsSummaryDao

Returns:

summaries

getAllQueuedResultSummaries

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

Description copied from interface: BuildResultsSummaryDao

Returns all the ResultsSummary in a LifeCycleState.QUEUED state with the given Class This will not return records marked for deletion.

Specified by:

getAllQueuedResultSummaries in interface BuildResultsSummaryDao

Returns:

summaries

getAllInProgressResultSummaries

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

Description copied from interface: BuildResultsSummaryDao

Returns all the ResultsSummary in a LifeCycleState.IN_PROGRESS state with the given Class This will not return records marked for deletion.

Specified by:

getAllInProgressResultSummaries in interface BuildResultsSummaryDao

Returns:

summaries

getAllActiveResultSummariesForPlan

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

Description copied from interface: BuildResultsSummaryDao

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()

Specified by:

getAllActiveResultSummariesForPlan in interface BuildResultsSummaryDao

Returns:

summaries

getFinalizedResultSummariesForPlan

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getFinalizedResultSummariesForPlan in interface BuildResultsSummaryDao

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: BuildResultsSummaryDao

Get the number of concurrently running builds for planKey

Specified by:

getNumberOfConcurrentlyRunningBuilds in interface BuildResultsSummaryDao

Returns:

getAllInProgressBuildResultSummaries

@NotNull
public Collection<BuildResultsSummary> getAllInProgressBuildResultSummaries()

Description copied from interface: BuildResultsSummaryDao

Returns all the BuildResultsSummary in a LifeCycleState.IN_PROGRESS state This will not return records marked for deletion.

Specified by:

getAllInProgressBuildResultSummaries in interface BuildResultsSummaryDao

Returns:

summaries

findResultsSummaries

@NotNull
public <T extends ResultsSummary> List<T> findResultsSummaries(@NotNull
                                                                       ResultsSummaryCriteria criteria)

Description copied from interface: BuildResultsSummaryDao

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.

Specified by:

findResultsSummaries in interface BuildResultsSummaryDao

Parameters:

criteria - @NotNull

Returns:

List of BuildResultsSummary

findResultSummariesForExpiry

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

Description copied from interface: BuildResultsSummaryDao

Searches for ResultsSummary objects given a ExpiryCriteria.

Specified by:

findResultSummariesForExpiry in interface BuildResultsSummaryDao

Type Parameters:

T - type of result objects (determined according to given criteria)

Parameters:

expiryCriteria - search constraints

Returns:

List of ResultsSummary

removeResultsSummariesForPlan

public int removeResultsSummariesForPlan(@NotNull
                                         PlanKey planKey)

Description copied from interface: BuildResultsSummaryDao

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(PlanKey) should be considered.

Specified by:

removeResultsSummariesForPlan in interface BuildResultsSummaryDao

Parameters:

planKey - identifier of plan to remove results for.

Returns:

number of deleted ResultsSummary objects

findPlanKeysFromAllOrphanedResultSummaries

public Iterable<PlanKey> findPlanKeysFromAllOrphanedResultSummaries()

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

findPlanKeysFromAllOrphanedResultSummaries in interface BuildResultsSummaryDao

Returns:

list of distinct PlanKeys they reference ordered by BRS, CRS

countBuildResultsSummaries

public int countBuildResultsSummaries(long agentId,
                                      @Nullable
                                      BuildState buildState)

Description copied from interface: BuildResultsSummaryDao

Count how many build results match the agent & optional build state. This will not count records marked for deletion.

Specified by:

countBuildResultsSummaries in interface BuildResultsSummaryDao

buildState - - can be null.

Returns:

count

countBuildResultsSummaries

public int countBuildResultsSummaries(@NotNull
                                      String planKey)

Specified by:

countBuildResultsSummaries in interface BuildResultsSummaryDao

countBuildResultsSummaries

public int countBuildResultsSummaries()

Description copied from interface: BuildResultsSummaryDao

Count all result summaries records. This will not count records marked for deletion.

Specified by:

countBuildResultsSummaries in interface BuildResultsSummaryDao

Returns:

findBuildsForImageConfiguration

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

Description copied from interface: BuildResultsSummaryDao

Searcher for builds of an image

Specified by:

findBuildsForImageConfiguration in interface BuildResultsSummaryDao

buildState - @Nullable

Returns:

findBuildResultsWithArtifacts

public List<Pair<ArtifactLink,BuildResultsSummary>> findBuildResultsWithArtifacts(String planKey)

Description copied from interface: BuildResultsSummaryDao

Find all build results which have matching artifacts. Sorted by buildNumber, ascending

Specified by:

findBuildResultsWithArtifacts in interface BuildResultsSummaryDao

Returns:

getResultSummariesByChangeSetId

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

Description copied from interface: BuildResultsSummaryDao

Get a list of all build results containing a commit with the given change set ID. This will not return records marked for deletion.

Specified by:

getResultSummariesByChangeSetId in interface BuildResultsSummaryDao

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

getResultSummariesByChangeSetIdAndRepository

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

Description copied from interface: BuildResultsSummaryDao

Get a list of all build results containing a commit with the given change set ID that are in the given repository. This will not return records marked for deletion.

Specified by:

getResultSummariesByChangeSetIdAndRepository in interface BuildResultsSummaryDao

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

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getResultSummariesByChangeSetIds in interface BuildResultsSummaryDao

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

findBuildResultsSummariesByJiraIssues

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

findBuildResultsSummariesByJiraIssues in interface BuildResultsSummaryDao

Returns:

list of result summaries

findBuildResultsSummariesByProjectKey

@NotNull
public List<ResultsSummary> findBuildResultsSummariesByProjectKey(@Nullable
                                                                          String jiraProjectKey)

Description copied from interface: BuildResultsSummaryDao

Retrieve a list of results summaries associated with given JIRA project key This will not return records marked for deletion.

Specified by:

findBuildResultsSummariesByProjectKey in interface BuildResultsSummaryDao

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

removeResultsSummary

public void removeResultsSummary(@NotNull
                                 ResultsSummary resultsSummary)

Description copied from interface: BuildResultsSummaryDao

Removes the passed result summary

Specified by:

removeResultsSummary in interface BuildResultsSummaryDao

Parameters:

resultsSummary - - @NotNull

getFirstBuildSummary

@Nullable
public BuildResultsSummary getFirstBuildSummary(@NotNull
                                                         Plan plan)

Description copied from interface: BuildResultsSummaryDao

Returns the first available BuildResultsSummary for the given Plan

Specified by:

getFirstBuildSummary in interface BuildResultsSummaryDao

Returns:

buildResult

getFirstBuildSummary

public BuildResultsSummary getFirstBuildSummary(@NotNull
                                                PlanKey planKey)

Description copied from interface: BuildResultsSummaryDao

Returns the first available BuildResultsSummary for the given PlanKey

Specified by:

getFirstBuildSummary in interface BuildResultsSummaryDao

Returns:

buildResult

getLastResultSummary

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

Description copied from interface: BuildResultsSummaryDao

Returns the latest completed ResultsSummary for the plan represented by planKey

Specified by:

getLastResultSummary in interface BuildResultsSummaryDao

Returns:

buildResult

findFirstBuildNumberAfter

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

Description copied from interface: BuildResultsSummaryDao

Returns the build number of next existing build results.

Specified by:

findFirstBuildNumberAfter in interface BuildResultsSummaryDao

Returns:

null if no build result summary with higher number exists

findLastBuildNumberBefore

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

Description copied from interface: BuildResultsSummaryDao

Returns the build number of previous existing build results.

Specified by:

findLastBuildNumberBefore in interface BuildResultsSummaryDao

Returns:

null if no build result summary with lower number exists

getNumberOfFinishedResults

public long getNumberOfFinishedResults(Plan plan)

Description copied from interface: BuildResultsSummaryDao

Returns the number of finished results available for the given Plan

Specified by:

getNumberOfFinishedResults in interface BuildResultsSummaryDao

Returns:

numberOfResults

getNumberOfFinalizedResults

public long getNumberOfFinalizedResults(@NotNull
                                        ImmutablePlan plan)

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

Specified by:

getNumberOfFinalizedResults in interface BuildResultsSummaryDao

Parameters:

plan -

Returns:

number of summaries

getNeighbouringSummaries

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

Description copied from interface: BuildResultsSummaryDao

Returns build results "around" given build number

Specified by:

getNeighbouringSummaries in interface BuildResultsSummaryDao

Returns:

getNeighbouringSummaries

@NotNull
public List<ResultsSummary> getNeighbouringSummaries(ImmutablePlan plan,
                                                             int currentBuildNumber,
                                                             int neighbouringSummariesMaxCount)

Description copied from interface: BuildResultsSummaryDao

Returns build results "around" given build number

Specified by:

getNeighbouringSummaries in interface BuildResultsSummaryDao

Returns:

getBreakingBuild

@Nullable
public ResultsSummary getBreakingBuild(ResultsSummary summary)

Specified by:

getBreakingBuild in interface BuildResultsSummaryDao

getFixingBuild

@Nullable
public ResultsSummary getFixingBuild(ResultsSummary summary)

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getFixingBuild in interface BuildResultsSummaryDao

Returns:

null if there is no fixing build.

getJiraIssuesForBuildResults

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getJiraIssuesForBuildResults in interface BuildResultsSummaryDao

Returns:

getJiraIssuesForPlanKey

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

getJiraIssuesForPlanKey in interface BuildResultsSummaryDao

Returns:

scrollVariableSubstitutionForExport

public long scrollVariableSubstitutionForExport(@NotNull
                                                com.google.common.base.Function<VariableSubstitution,Void> function)

Description copied from interface: BuildResultsSummaryDao

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.

Specified by:

scrollVariableSubstitutionForExport in interface BuildResultsSummaryDao

Parameters:

function - function to be executed on each of the VariableSubstitution

Returns:

number of traversed rows

findFirstResultAfter

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

Description copied from interface: BuildResultsSummaryDao

Finds the first successful or failed BuildResultsSummary after buildNumber

Specified by:

findFirstResultAfter in interface BuildResultsSummaryDao

Returns:

buildResult

findLastResultBefore

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

Description copied from interface: BuildResultsSummaryDao

Finds the last successful or failed ResultsSummary before buildNumber

Specified by:

findLastResultBefore in interface BuildResultsSummaryDao

includeOnceOffBuilds - tells whether we also consider 'once-off' builds (the ones with custom revision) or should we skip them in our calculations

Returns:

buildResult

findLastBuildResultBeforeWithTests

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

Specified by:

findLastBuildResultBeforeWithTests in interface BuildResultsSummaryDao

Type Parameters:

T - of result

Parameters:

planResultKey - of the result

aClass - of

includeOnceOffBuilds - tells whether we also consider 'once-off' builds (the ones with custom revision) or should we skip them in our calculations

Returns:

resultsSummary

findFirstBuildResultWithBuildStateAfter

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

Description copied from interface: BuildResultsSummaryDao

Finds the last successful BuildResultsSummary after buildNumber

Specified by:

findFirstBuildResultWithBuildStateAfter in interface BuildResultsSummaryDao

Returns:

buildResult

findLastBuildResultWithBuildStateBefore

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

Description copied from interface: BuildResultsSummaryDao

Finds the last BuildResultsSummary before buildNumber with BuildState

Specified by:

findLastBuildResultWithBuildStateBefore in interface BuildResultsSummaryDao

Returns:

buildResult

findFirstBuildResultWithBuildStateBetween

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

findFirstBuildResultWithBuildStateBetween in interface BuildResultsSummaryDao

Returns:

buildResult

scrollResultSummaries

public long scrollResultSummaries(@NotNull
                                  String buildKey,
                                  @NotNull
                                  ResultDataRead dataRead,
                                  @NotNull
                                  com.google.common.base.Function<ResultsSummary,Void> function)

Description copied from interface: BuildResultsSummaryDao

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 BuildResultsSummaryDao

Parameters:

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

dataRead - if the data should be loaded lazy or eagerly

function - function to be executed on each of the BuildResultSummary

Returns:

number of traversed rows

getChainStageResultById

public ChainStageResult getChainStageResultById(long id)

Description copied from interface: BuildResultsSummaryDao

Returns a ChainStageResult by its id

Specified by:

getChainStageResultById in interface BuildResultsSummaryDao

Returns:

chainStageResult

getAllResultSummariesForPlan

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

Description copied from interface: BuildResultsSummaryDao

Get all the ResultsSummarys for the given Plan

Specified by:

getAllResultSummariesForPlan in interface BuildResultsSummaryDao

Returns:

summaries

getResultSummariesForPlan

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

Description copied from interface: BuildResultsSummaryDao

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.

Specified by:

getResultSummariesForPlan in interface BuildResultsSummaryDao

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
public <T extends ResultsSummary> List<T> getResultSummariesForPlanByLifeCycleState(@NotNull
                                                                                            Plan plan,
                                                                                            @NotNull
                                                                                            LifeCycleState lifeCycleState,
                                                                                            int firstResult,
                                                                                            int maxResults)

Description copied from interface: BuildResultsSummaryDao

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 BuildResultsSummaryDao

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

getParentResultSummary

@Nullable
public ChainResultsSummary getParentResultSummary(ResultsSummary summary)

Description copied from interface: BuildResultsSummaryDao

Get (@link ChainResultsSummary} containing given ResultsSummary

Specified by:

getParentResultSummary in interface BuildResultsSummaryDao

Returns:

getStageForResult

@Nullable
public ChainStageResult getStageForResult(ResultsSummary summary)

Description copied from interface: BuildResultsSummaryDao

Get (@link ChainStageResult} containing given ResultsSummary

Specified by:

getStageForResult in interface BuildResultsSummaryDao

Returns:

findLatestResultsSummaries

public List<ResultsSummary> findLatestResultsSummaries()

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

findLatestResultsSummaries in interface BuildResultsSummaryDao

Returns:

list of latest results summaries

findLatestFailedResultSummaries

public List<ResultsSummary> findLatestFailedResultSummaries()

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

findLatestFailedResultSummaries in interface BuildResultsSummaryDao

Returns:

list of latest results summaries

findChainResultsWithJobLabelled

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

Description copied from interface: BuildResultsSummaryDao

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.

Specified by:

findChainResultsWithJobLabelled in interface BuildResultsSummaryDao

Parameters:

queryCriteria - 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

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

Specified by:

findLastResultSummaryWithState in interface BuildResultsSummaryDao

Returns:

the last ResultsSummary with the provided BuildState

countResultsWithState

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

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

countResultsWithState in interface BuildResultsSummaryDao

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

markResultSummariesForDeletion

public int markResultSummariesForDeletion(@NotNull
                                          PlanKey planKey)

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

markResultSummariesForDeletion in interface BuildResultsSummaryDao

Parameters:

planKey - key of a plan

Returns:

number of updated records

getPlanKeysSortedByNumberOfFinalizedResultSummaries

@NotNull
public List<PlanKey> getPlanKeysSortedByNumberOfFinalizedResultSummaries()

Specified by:

getPlanKeysSortedByNumberOfFinalizedResultSummaries in interface BuildResultsSummaryDao

calculateQueueDuration

@Nullable
public Long calculateQueueDuration(@NotNull
                                            ChainResultsSummary resultsSummary)

Description copied from interface: BuildResultsSummaryDao

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

Specified by:

calculateQueueDuration in interface BuildResultsSummaryDao

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: BuildResultsSummaryDao

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

Specified by:

calculateVcsUpdateDuration in interface BuildResultsSummaryDao

Parameters:

resultsSummary - ChainResultsSummary for which calculation has to be made

Returns:

vcsUpdateDuration value or null if there are no related BuildResultsSummary records

setResultsSummaryDiscriminatorRegistry

public void setResultsSummaryDiscriminatorRegistry(ResultsSummaryDiscriminatorRegistry resultsSummaryDiscriminatorRegistry)

setPlanDiscriminatorRegistry

public void setPlanDiscriminatorRegistry(PlanDiscriminatorRegistry planDiscriminatorRegistry)

setTestResultsHibernateDao

public void setTestResultsHibernateDao(TestResultsHibernateDao testResultsHibernateDao)

findAllBuildResultsNumbers

public List<Integer> findAllBuildResultsNumbers(PlanKey planKey)

Specified by:

findAllBuildResultsNumbers in interface BuildResultsSummaryDao