com.atlassian.bamboo.deployments.versions.persistence

Interface DeploymentVersionDao

All Known Implementing Classes:

DeploymentVersionDaoImpl

public interface DeploymentVersionDao

Method Summary

Modifier and Type	Method and Description
MutableDeploymentVersionStatus	createNewVersionStatus(long deploymentVersionId, DeploymentVersionState state, String userName) Creates a new vesion status for the given deployment version.
void	delete(MutableDeploymentVersion deploymentVersion) Delete MutableDeploymentVersion
int	deleteForDeploymentProject(long deploymentProjectId) Delete DeploymentVersion records related to given DeploymentProject.
int	deleteVersionItems(long deploymentVersionId) Delete DeploymentVersionItem records related to given DeploymentVersion.
int	deleteVersionStatus(long deploymentVersionId) Delete DeploymentVersionStatus records related to a given version
int	deleteVersionStatuses(DeploymentVersionDeletionAdapter deletionAdapter) Delete DeploymentVersionStatus records related to a given versions
List<MutableDeploymentVersion>	findLatestKnownVersionsForEnvironmentsOfDeploymentProject(long deploymentProjectId) Find all the versions that are currently deployed on environments of a deployment projects.
MutableDeploymentVersion	findLatestVersionForProject(long deploymentProjectId) Find the latest version for a deployment project.
MutableDeploymentVersion	findLatestVersionForProject(long deploymentProjectId, PlanKey branchKey) Find the latest version for a deployment project.
MutableDeploymentVersion	findNextVersionContainingResult(long deploymentProjectId, PlanResultKey planResultKey) Find the first version that is created from a result which is later than current result (not taking custom revision into account)
MutableDeploymentVersion	findPreviousVersion(long deploymentProjectId, MutableDeploymentVersion deploymentVersion) Find the last version created before this one.
List<MutableDeploymentVersion>	findVersions(DeploymentVersionSearchCriteria searchCriteria) Search for versions using search criteria
List<MutableDeploymentVersion>	findVersionsAssociatedWithJiraIssue(long deploymentProjectId, String issueKey) Find all the versions of a DeploymentProject that are associated with a JIRA issue
List<MutableDeploymentVersion>	findVersionsAssociatedWithJiraIssue(String issueKey) Find all the versions that are associated with a JIRA issue
Iterable<MutableDeploymentVersion>	findVersionsBetween(long deploymentVersionId, long version1Id, long version2Id) Find versions created between version1 and version2.
MutableDeploymentVersion	getDeploymentVersion(long deploymentVersionId) Get MutableDeploymentVersion by id
MutableDeploymentVersion	getDeploymentVersionByName(String existingVersionName, long deploymentProjectId) Retrieve a specific version by name for a project
List<MutableDeploymentVersion>	getDeploymentVersionsForDeploymentProject(long deploymentProjectId) Get MutableDeploymentVersion by DeploymentProject id
MutableDeploymentVersionStatus	getLatestVersionStatus(long deploymentVersionId)
Set<PlanResultKey>	getRelatedPlanResultKeys(long deploymentVersionId)
MutableDeploymentVersion	getRelatedVersion(long deploymentProjectId, PlanResultKey planResultKey) Find latest version of a deployment project that is related to specific plan result.
List<String>	getResultPlanKeysHavingDeploymentProjectVersions(long deploymentProjectId) Returns keys of result plans (branch) that have at least one deployment project version (release)
int	getVersionsCount() Count all versions
int	getVersionsCountForProject(long deploymentProjectId) Count versions related to deployment project
List<MutableDeploymentVersionStatus>	getVersionStatuses(long deploymentVersionId) Get MutableDeploymentVersionStatuses by DeploymentVersion id
boolean	hasVersions(DeploymentVersionSearchCriteria searchCriteria) Test if versions that match criteria do exist
boolean	isVersionNameConflicting(String name, long deploymentProjectId) Check whether the version name is already being used by another version within this project
void	save(MutableDeploymentVersion deploymentVersion) Save MutableDeploymentVersion
void	updatePlanKey(PlanKey originalPlanKey, PlanKey newPlanKey) Update planKey in DeploymentVersion's related entities when plan key has changed (ie after moving plan)

Method Detail

getDeploymentVersion

@Nullable
MutableDeploymentVersion getDeploymentVersion(long deploymentVersionId)

Get MutableDeploymentVersion by id

getResultPlanKeysHavingDeploymentProjectVersions

List<String> getResultPlanKeysHavingDeploymentProjectVersions(long deploymentProjectId)

Returns keys of result plans (branch) that have at least one deployment project version (release)

Parameters:

deploymentProjectId - id of the deployment project

Returns:

getDeploymentVersionsForDeploymentProject

@NotNull
List<MutableDeploymentVersion> getDeploymentVersionsForDeploymentProject(long deploymentProjectId)

Get MutableDeploymentVersion by DeploymentProject id

save

void save(@NotNull
          MutableDeploymentVersion deploymentVersion)

Save MutableDeploymentVersion

delete

void delete(MutableDeploymentVersion deploymentVersion)

Delete MutableDeploymentVersion

deleteForDeploymentProject

int deleteForDeploymentProject(long deploymentProjectId)

Delete DeploymentVersion records related to given DeploymentProject. This will only attempt to remove DeploymentVersion and data that is normally cascaded by Hibernate. For complete DeploymentVersion deletion please see DeploymentVersionDeletionService.

Parameters:

deploymentProjectId - id of DeploymentProject

Returns:

number of deleted DeploymentVersion records

deleteVersionItems

int deleteVersionItems(long deploymentVersionId)

Delete DeploymentVersionItem records related to given DeploymentVersion. This will only attempt to remove DeploymentVersion and data that is normally cascaded by Hibernate. For complete DeploymentVersion deletion please see DeploymentVersionDeletionService.

Parameters:

deploymentVersionId - id of DeploymentVersion

Returns:

number of deleted DeploymentVersionItem records

findVersions

@NotNull
List<MutableDeploymentVersion> findVersions(@NotNull
                                                     DeploymentVersionSearchCriteria searchCriteria)

Search for versions using search criteria

Parameters:

searchCriteria - search criteria

Returns:

list of versions that match the criteria

hasVersions

boolean hasVersions(@NotNull
                    DeploymentVersionSearchCriteria searchCriteria)

Test if versions that match criteria do exist

Parameters:

searchCriteria - search criteria

Returns:

true if there are versions that match criteria

isVersionNameConflicting

boolean isVersionNameConflicting(@NotNull
                                 String name,
                                 long deploymentProjectId)

Check whether the version name is already being used by another version within this project

Parameters:

name - to check

deploymentProjectId - project to filter by

Returns:

true if name is already being used.

getDeploymentVersionByName

@Nullable
MutableDeploymentVersion getDeploymentVersionByName(@NotNull
                                                              String existingVersionName,
                                                              long deploymentProjectId)

Retrieve a specific version by name for a project

Parameters:

existingVersionName - name of version to find

deploymentProjectId - of project to look in

Returns:

version with specified name in the given project. Null if could not be found.

findPreviousVersion

@Nullable
MutableDeploymentVersion findPreviousVersion(long deploymentProjectId,
                                                       @NotNull
                                                       MutableDeploymentVersion deploymentVersion)

Find the last version created before this one. If version is related to any DeploymentVersionPlanResultKey then previous version would also be related to the same plan key (so we can find previous version created off the same branch).

findLatestVersionForProject

@Nullable
MutableDeploymentVersion findLatestVersionForProject(long deploymentProjectId)

Find the latest version for a deployment project. Comparison based on creation date.

Parameters:

deploymentProjectId - id of the deployment project

Returns:

the latest version for a deployment project

findLatestVersionForProject

@Nullable
MutableDeploymentVersion findLatestVersionForProject(long deploymentProjectId,
                                                               @NotNull
                                                               PlanKey branchKey)

Find the latest version for a deployment project. Comparison based on creation date.

Parameters:

deploymentProjectId - id of the deployment project

branchKey - key of the PlanBranch

Returns:

the latest version created for a branch for a deployment project

getRelatedPlanResultKeys

@NotNull
Set<PlanResultKey> getRelatedPlanResultKeys(long deploymentVersionId)

Returns:

Retrieve the PlanResultKeys of ResultSummaries related to a particular DeploymentVersion

getLatestVersionStatus

MutableDeploymentVersionStatus getLatestVersionStatus(long deploymentVersionId)

createNewVersionStatus

@NotNull
MutableDeploymentVersionStatus createNewVersionStatus(long deploymentVersionId,
                                                               DeploymentVersionState state,
                                                               @NotNull
                                                               String userName)

Creates a new vesion status for the given deployment version.

getVersionStatuses

@NotNull
List<MutableDeploymentVersionStatus> getVersionStatuses(long deploymentVersionId)

Get MutableDeploymentVersionStatuses by DeploymentVersion id

findVersionsBetween

Iterable<MutableDeploymentVersion> findVersionsBetween(long deploymentVersionId,
                                                       long version1Id,
                                                       long version2Id)

Find versions created between version1 and version2. The order of the argument is irrelevant. Lower bound is not included in result but upper bound is. The result is sorted by creation date (newest first)

Parameters:

deploymentVersionId -

version1Id -

version2Id -

Returns:

Throws:

IllegalArgumentException - if any of the version doesn't exist

deleteVersionStatus

int deleteVersionStatus(long deploymentVersionId)

Delete DeploymentVersionStatus records related to a given version

Parameters:

deploymentVersionId - id of the DeploymentVersion

Returns:

number of deleted DeploymentVersionStatus records

deleteVersionStatuses

int deleteVersionStatuses(@NotNull
                          DeploymentVersionDeletionAdapter deletionAdapter)

Delete DeploymentVersionStatus records related to a given versions

Parameters:

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

Returns:

number of deleted DeploymentVersionStatus records

getVersionsCount

int getVersionsCount()

Count all versions

Returns:

number of versions created in all deployment projects

getVersionsCountForProject

int getVersionsCountForProject(long deploymentProjectId)

Count versions related to deployment project

Parameters:

deploymentProjectId - id of deployment project

Returns:

number of versions existing for a deployment project

getRelatedVersion

@Nullable
MutableDeploymentVersion getRelatedVersion(long deploymentProjectId,
                                                     @NotNull
                                                     PlanResultKey planResultKey)

Find latest version of a deployment project that is related to specific plan result.

Parameters:

deploymentProjectId -

planResultKey -

Returns:

findNextVersionContainingResult

@Nullable
MutableDeploymentVersion findNextVersionContainingResult(long deploymentProjectId,
                                                                   @NotNull
                                                                   PlanResultKey planResultKey)

Find the first version that is created from a result which is later than current result (not taking custom revision into account)

Parameters:

deploymentProjectId -

planResultKey -

Returns:

updatePlanKey

void updatePlanKey(@NotNull
                   PlanKey originalPlanKey,
                   @NotNull
                   PlanKey newPlanKey)

Update planKey in DeploymentVersion's related entities when plan key has changed (ie after moving plan)

Parameters:

originalPlanKey - original PlanKey

newPlanKey - new PlanKey

findVersionsAssociatedWithJiraIssue

@NotNull
List<MutableDeploymentVersion> findVersionsAssociatedWithJiraIssue(long deploymentProjectId,
                                                                            @NotNull
                                                                            String issueKey)

Find all the versions of a DeploymentProject that are associated with a JIRA issue

Parameters:

deploymentProjectId -

issueKey -

Since:

5.1

findVersionsAssociatedWithJiraIssue

@NotNull
List<MutableDeploymentVersion> findVersionsAssociatedWithJiraIssue(@NotNull
                                                                            String issueKey)

Find all the versions that are associated with a JIRA issue

Parameters:

issueKey -

Since:

5.1

findLatestKnownVersionsForEnvironmentsOfDeploymentProject

List<MutableDeploymentVersion> findLatestKnownVersionsForEnvironmentsOfDeploymentProject(long deploymentProjectId)

Find all the versions that are currently deployed on environments of a deployment projects. Return duplicates if deployed on more than one environments.

Parameters:

deploymentProjectId -

Returns: