com.atlassian.bamboo.deployments.results.persistence
Interface DeploymentResultDao

All Known Implementing Classes:

DeploymentResultDaoImpl

public interface DeploymentResultDao

Method Summary

int	delete(DeploymentResultDeletionAdapter deletionAdapter) Delete DeploymentResults records limited by DeletionSQLAdapter.getInClause().
int	delete(EnvironmentDeletionAdapter environmentDeletionAdapter) Delete DeploymentResults records limited by EnvironmentDeletionAdapter.
void	delete(MutableDeploymentResult deploymentResult) Delete Deployment Result.
java.util.Set<java.lang.Long>	findEnvironmentIdsVersionWasDeployedOn(long deploymentVersionId)
MutableDeploymentResult	getDeploymentResult(long deploymentResultId) Get DeploymentResult by id
java.util.List<MutableDeploymentResult>	getDeploymentResults(long environmentId, long deploymentVersionId) Retrieve all deployment results that exist for an environment and version.
java.util.List<MutableDeploymentResult>	getDeploymentResultsByLifeCycleState(java.util.Collection<LifeCycleState> lifeCycleStates)
java.util.List<MutableDeploymentResult>	getDeploymentResultsForDeploymentVersion(long deploymentVersionId) Get a list of DeploymentResults for a DeploymentVersion TODO: this method is a potential problem due to performance reasons
java.util.List<MutableDeploymentResult>	getDeploymentResultsForEnvironment(long environmentId) Get a list of DeploymentResults for a Environment TODO: this method is a potential problem due to performance reasons
MutableDeploymentResult	getLastResultBefore(DeploymentResult deploymentResult)
MutableDeploymentResult	getLatestDeploymentResult(long environmentId, long deploymentVersionId) Retrieve the latest deployment result that exists for a version on an environment.
MutableDeploymentResult	getLatestDeploymentResultForEnvironment(long environmentId) Get the latest result that ran against an environment
java.util.List<MutableDeploymentResult>	getLatestDeploymentResultsForEnvironment(long environmentId, int startIndex, int maxResults) Get the latest deployment results for an Environment, limited to requested amount starting from requested start index.
MutableDeploymentResult	getLatestKnownDeploymentResultForEnvironment(long environmentId) Get the latest result that *actually* ran against an environments.
MutableDeploymentResult	getRollbackDeploymentResultForEnvironment(long environmentId, long latestVersionId) Find the result that you are trying to replicate by doing a rollback.
long	iterateResultsForExport(com.google.common.base.Function<MutableDeploymentResult,java.lang.Void> function) Iterate through and execute function for each of MutableDeploymentResult
void	save(MutableDeploymentResult deploymentResult) Save DeploymentResult
int	unlinkFromVersion(DeploymentVersionDeletionAdapter deletionAdapter) Unlink DeploymentResults records limited by DeletionSQLAdapter.getInClause() from deployment version.
void	updateVersionName(long deploymentVersionId, java.lang.String newVersionName) Updates version name in all results related to a vesion

Method Detail

getDeploymentResult

@Nullable
MutableDeploymentResult getDeploymentResult(long deploymentResultId)

Get DeploymentResult by id

getDeploymentResultsByLifeCycleState

@NotNull
java.util.List<MutableDeploymentResult> getDeploymentResultsByLifeCycleState(java.util.Collection<LifeCycleState> lifeCycleStates)

save

void save(MutableDeploymentResult deploymentResult)

Save DeploymentResult

getDeploymentResultsForEnvironment

@NotNull
java.util.List<MutableDeploymentResult> getDeploymentResultsForEnvironment(long environmentId)

Get a list of DeploymentResults for a Environment TODO: this method is a potential problem due to performance reasons

Parameters:

environmentId - id of Environment

getLatestDeploymentResultsForEnvironment

@NotNull
java.util.List<MutableDeploymentResult> getLatestDeploymentResultsForEnvironment(long environmentId,
                                                                                         int startIndex,
                                                                                         int maxResults)

Get the latest deployment results for an Environment, limited to requested amount starting from requested start index.

Parameters:

environmentId - of the environment

startIndex - the index to which start. Latest deployment is at index 0; (ignored if below zero)

maxResults - how many results to retrieve, (ignored if equal to or below zero)

Returns:

subset of latest deployment results

getDeploymentResultsForDeploymentVersion

@NotNull
java.util.List<MutableDeploymentResult> getDeploymentResultsForDeploymentVersion(long deploymentVersionId)

Get a list of DeploymentResults for a DeploymentVersion TODO: this method is a potential problem due to performance reasons

Parameters:

deploymentVersionId - id of DeploymentVersion

getDeploymentResults

@NotNull
java.util.List<MutableDeploymentResult> getDeploymentResults(long environmentId,
                                                                     long deploymentVersionId)

Retrieve all deployment results that exist for an environment and version. There are no restrictions for how many times. Performance should not be a huge problem with this method as we do not expect too many results for one version going to an specific environment you can deploy a version to an environment.

Parameters:

environmentId - of the environment

deploymentVersionId - of the version

Returns:

deployment result for a version against an environment.

getLatestDeploymentResult

@Nullable
MutableDeploymentResult getLatestDeploymentResult(long environmentId,
                                                           long deploymentVersionId)

Retrieve the latest deployment result that exists for a version on an environment.

Parameters:

environmentId - of the environment

deploymentVersionId - of the version

Returns:

Latest deployment result if exists

getLatestDeploymentResultForEnvironment

@Nullable
MutableDeploymentResult getLatestDeploymentResultForEnvironment(long environmentId)

Get the latest result that ran against an environment

Parameters:

environmentId - id of the environment

Returns:

the latest result. Null if not run

getLatestKnownDeploymentResultForEnvironment

MutableDeploymentResult getLatestKnownDeploymentResultForEnvironment(long environmentId)

Get the latest result that *actually* ran against an environments. Any NOT_BUILT results are skipped, so you can see the latest known state of that particular environment.

Parameters:

environmentId - id of the environment

Returns:

the latest results.

delete

void delete(MutableDeploymentResult deploymentResult)

Delete Deployment Result.

Parameters:

deploymentResult - to be deleted

delete

int delete(@NotNull
           DeploymentResultDeletionAdapter deletionAdapter)

Delete DeploymentResults records limited by DeletionSQLAdapter.getInClause(). This will only attempt to remove DeploymentResults and data that is normally cascaded by Hibernate. For complete DeploymentResult deletion please see DeploymentResultDeletionService.delete(long). Deletion is performed using DELETE queries.

Parameters:

deletionAdapter - DeletionSQLAdapter.getInClause() should provide range of DeploymentResults

Returns:

number of deleted records

delete

int delete(@NotNull
           EnvironmentDeletionAdapter environmentDeletionAdapter)

Delete DeploymentResults records limited by EnvironmentDeletionAdapter. This will only attempt to remove DeploymentResults and data that is normally cascaded by Hibernate. For complete DeploymentResult deletion please see DeploymentResultDeletionService.delete(long). Deletion is performed using DELETE queries.

Parameters:

environmentDeletionAdapter - EnvironmentDeletionAdapter should provide range of DeploymentResults

Returns:

number of deleted records

unlinkFromVersion

int unlinkFromVersion(@NotNull
                      DeploymentVersionDeletionAdapter deletionAdapter)

Unlink DeploymentResults records limited by DeletionSQLAdapter.getInClause() from deployment version. Unlinking is performed using UPDATE queries

Parameters:

deletionAdapter - DeletionSQLAdapter.getInClause() should provide range of DeploymentVersions to unlink from

Returns:

number of unlinked records

iterateResultsForExport

long iterateResultsForExport(@NotNull
                             com.google.common.base.Function<MutableDeploymentResult,java.lang.Void> function)

Iterate through and execute function for each of MutableDeploymentResult

Parameters:

function - function to be executed on each of the MutableDeploymentResult

Returns:

number of traversed rows

getRollbackDeploymentResultForEnvironment

@Nullable
MutableDeploymentResult getRollbackDeploymentResultForEnvironment(long environmentId,
                                                                           long latestVersionId)

Find the result that you are trying to replicate by doing a rollback. Looks back until it finds a successful result that is not the same version as the one currently deployed

Parameters:

environmentId - if the environment to find rollback for

latestVersionId - id of the version currently on the environment

Returns:

result

findEnvironmentIdsVersionWasDeployedOn

@NotNull
java.util.Set<java.lang.Long> findEnvironmentIdsVersionWasDeployedOn(long deploymentVersionId)

Parameters:

deploymentVersionId -

Returns:

ids of all environments a version was ever deployed on

getLastResultBefore

@Nullable
MutableDeploymentResult getLastResultBefore(@NotNull
                                                     DeploymentResult deploymentResult)

Returns:

result of the last deployment performed on an environment before given result

updateVersionName

void updateVersionName(long deploymentVersionId,
                       @NotNull
                       java.lang.String newVersionName)

Updates version name in all results related to a vesion

Parameters:

deploymentVersionId -

newVersionName -