Package 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	Description
@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.
@NotNull List<DeploymentVersionVcsChangeset>	getChangesetsForDeploymentVersion(@NotNull DeploymentVersion deploymentVersion)	Find all DeploymentVersionVcsChangeset associated with a DeploymentVersion
@NotNull DeploymentVersionCommitsComparisonResult	getChangesetsForNewDeploymentVersion(long deploymentProjectId, PlanResultKey planResultKey, int maxCommits)	Finds the changesets if a new version would be created from planResultKey.
@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.
int	getCommitCountForDeploymentVersion(@NotNull DeploymentVersion deploymentVersion)	count of all commits in all changesets associated with a DeploymentVersion
@NotNull DeploymentVersionCommitsComparisonResult	getLastNCommitsForVersion(long deploymentProjectId, DeploymentVersion deploymentVersion, int maxCommits)	Find changesets for the version and fetch n last commits.

Method Detail

getChangesetsForDeploymentVersion

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

Find all DeploymentVersionVcsChangeset associated with a DeploymentVersion

Parameters:

deploymentVersion - a version

getCommitCountForDeploymentVersion

int getCommitCountForDeploymentVersion(@NotNull
                                       @NotNull DeploymentVersion deploymentVersion)

count of all commits in all changesets associated with a DeploymentVersion

Parameters:

deploymentVersion - a version

compareVersionsByChangesets

@NotNull
@NotNull DeploymentVersionCommitsComparisonResult compareVersionsByChangesets(long deploymentProjectId,
                                                                              @NotNull
                                                                              @NotNull DeploymentVersion version1,
                                                                              @NotNull
                                                                              @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
@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
@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
@NotNull DeploymentVersionCommitsComparisonResult getChangesetsForNewDeploymentVersion(long deploymentProjectId,
                                                                                       PlanResultKey planResultKey,
                                                                                       int maxCommits,
                                                                                       @NotNull
                                                                                       @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: