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