com.atlassian.bamboo.deployments.versions.service

Interface DeploymentVersionVcsChangesetService

All Known Implementing Classes:

DeploymentVersionVcsChangesetServiceImpl

public interface DeploymentVersionVcsChangesetService

Service that provides commit data for DeploymentVersion

Method Summary

Modifier and Type	Method and Description
DeploymentVersionCommitsComparisonResult	compareVersionsByChangesets(long deploymentProjectId, DeploymentVersion version1, DeploymentVersion version2, int maxCommits) Find all DeploymentVersionVcsChangeset that happened after creation of older version until (and including) the creation of newer version.
List<DeploymentVersionVcsChangeset>	getChangesetsForDeploymentVersion(DeploymentVersion deploymentVersion) Find all DeploymentVersionVcsChangeset associated with a DeploymentVersion
DeploymentVersionCommitsComparisonResult	getChangesetsForNewDeploymentVersion(long deploymentProjectId, PlanResultKey planResultKey, int maxCommits) Finds the changesets if a new version would be created from planResultKey.
DeploymentVersionCommitsComparisonResult	getChangesetsForNewDeploymentVersion(long deploymentProjectId, PlanResultKey planResultKey, int maxCommits, DeploymentVersion version) Same as above, but finds changesets between a certain version and the new version to be created from the planResultKey.
int	getCommitCountForDeploymentVersion(DeploymentVersion deploymentVersion) count of all commits in all changesets associated with a DeploymentVersion
DeploymentVersionCommitsComparisonResult	getLastNCommitsForVersion(long deploymentProjectId, DeploymentVersion deploymentVersion, int maxCommits) Find changesets for the version and fetch n last commits.

Method Detail

getChangesetsForDeploymentVersion

@NotNull
List<DeploymentVersionVcsChangeset> getChangesetsForDeploymentVersion(@NotNull
                                                                               DeploymentVersion deploymentVersion)

Find all DeploymentVersionVcsChangeset associated with a DeploymentVersion

Parameters:

deploymentVersion - a version

getCommitCountForDeploymentVersion

int getCommitCountForDeploymentVersion(@NotNull
                                       DeploymentVersion deploymentVersion)

count of all commits in all changesets associated with a DeploymentVersion

Parameters:

deploymentVersion - a version

compareVersionsByChangesets

@NotNull
DeploymentVersionCommitsComparisonResult compareVersionsByChangesets(long deploymentProjectId,
                                                                              @NotNull
                                                                              DeploymentVersion version1,
                                                                              @NotNull
                                                                              DeploymentVersion version2,
                                                                              int maxCommits)

Find all DeploymentVersionVcsChangeset that happened after creation of older version until (and including) the creation of newer version.

Parameters:

deploymentProjectId -

version1 - 1st version to compare (can be either older or newer than version2)

version2 - 2nd version to compare (can be either older or newer than version1)

maxCommits - maximum number of commits fetched with full information

Returns:

Throws:

IllegalStateException - if versions are not comparable (e.g. come from different branch)

getLastNCommitsForVersion

@NotNull
DeploymentVersionCommitsComparisonResult getLastNCommitsForVersion(long deploymentProjectId,
                                                                            DeploymentVersion deploymentVersion,
                                                                            int maxCommits)

Find changesets for the version and fetch n last commits.

Parameters:

deploymentProjectId -

deploymentVersion -

maxCommits -

Returns:

getChangesetsForNewDeploymentVersion

@NotNull
DeploymentVersionCommitsComparisonResult getChangesetsForNewDeploymentVersion(long deploymentProjectId,
                                                                                       PlanResultKey planResultKey,
                                                                                       int maxCommits)

Finds the changesets if a new version would be created from planResultKey. Doesn't save anything to db,

Parameters:

deploymentProjectId - id of the deployment project

planResultKey - of the build result we want to create version from

maxCommits -

Returns:

getChangesetsForNewDeploymentVersion

@NotNull
DeploymentVersionCommitsComparisonResult getChangesetsForNewDeploymentVersion(long deploymentProjectId,
                                                                                       PlanResultKey planResultKey,
                                                                                       int maxCommits,
                                                                                       @NotNull
                                                                                       DeploymentVersion version)

Same as above, but finds changesets between a certain version and the new version to be created from the planResultKey.

Parameters:

deploymentProjectId - id of the deployment project

planResultKey - of the build result we want to create version from

maxCommits - max number of commits to fetch

version - DeploymentVersion that we want to compare the planResultKey to in order to get the changesets

Returns: