com.atlassian.bamboo.deployments.versions.service

Interface DeploymentVersionLinkedJiraIssuesService

All Known Implementing Classes:

DeploymentVersionLinkedJiraIssuesServiceImpl

public interface DeploymentVersionLinkedJiraIssuesService

Service for managing JIRA issues linked to DeploymentVersion

Method Summary

Modifier and Type	Method and Description
List<DeploymentVersionLinkedJiraIssue>	compareVersionsByJiraIssues(long deploymentProjectId, @NotNull DeploymentVersion version1, @NotNull DeploymentVersion version2) Get JIRA issue links for comparing two versions, i.e.
Set<String>	getIssuesChangedForDeploymentResult(long deploymentResultId) Finds issue keys for given deployment result Returns empty list if status of result build is unknown or if this and previous status is failed.
int	getJiraIssueCountForDeploymentVersion(long deploymentVersionId) Get count of all JIRA issues associated with DeploymentVersion
Set<String>	getJiraIssueKeysForDeploymentVersion(long deploymentVersionId) Get keys of all JIRA issues associated with a DeploymentVersion
Set<String>	getJiraIssueKeysForProject(long deploymentProjectId) Get keys of all JIRA issues associated with a DeploymentProject
List<DeploymentVersionLinkedJiraIssue>	getJiraIssuesForDeploymentVersion(long deploymentVersionId) DeploymentVersionEventListener Get all JIRA issues associated with DeploymentVersion
SortedMap<String,DeploymentVersionLinkedJiraIssue>	getJiraIssuesForDeploymentVersionsMap(long deploymentVersionId) Get all JIRA issues associated with DeploymentVersion as mapping between issue key and DeploymentVersionLinkedJiraIssue
@NotNull List<InternalLinkedJiraIssue>	getJiraIssuesForNewDeploymentVersion(long deploymentProjectId, PlanResultKey planResultKey) Finds the relevant jira issues if a new version would be created from planResultKey.
@NotNull List<InternalLinkedJiraIssue>	getJiraIssuesForNewDeploymentVersion(long deploymentProjectId, PlanResultKey planResultKey, DeploymentVersion previousVersion) Same as above, but gets all issues between a specific version and the planResultKey.

Method Detail

getJiraIssueKeysForDeploymentVersion

Set<String> getJiraIssueKeysForDeploymentVersion(long deploymentVersionId)

Get keys of all JIRA issues associated with a DeploymentVersion

Parameters:

deploymentVersionId -

Returns:

getJiraIssueKeysForProject

Set<String> getJiraIssueKeysForProject(long deploymentProjectId)

Get keys of all JIRA issues associated with a DeploymentProject

Parameters:

deploymentProjectId -

Returns:

getJiraIssuesForDeploymentVersion

List<DeploymentVersionLinkedJiraIssue> getJiraIssuesForDeploymentVersion(long deploymentVersionId)

DeploymentVersionEventListener Get all JIRA issues associated with DeploymentVersion

Parameters:

deploymentVersionId -

Returns:

getJiraIssueCountForDeploymentVersion

int getJiraIssueCountForDeploymentVersion(long deploymentVersionId)

Get count of all JIRA issues associated with DeploymentVersion

Parameters:

deploymentVersionId - id of the version

Returns:

number of issues linked with DeploymentVersion

getJiraIssuesForDeploymentVersionsMap

SortedMap<String,DeploymentVersionLinkedJiraIssue> getJiraIssuesForDeploymentVersionsMap(long deploymentVersionId)

Get all JIRA issues associated with DeploymentVersion as mapping between issue key and DeploymentVersionLinkedJiraIssue

Parameters:

deploymentVersionId -

Returns:

compareVersionsByJiraIssues

List<DeploymentVersionLinkedJiraIssue> compareVersionsByJiraIssues(long deploymentProjectId,
                                                                   @NotNull
                                                                   @NotNull DeploymentVersion version1,
                                                                   @NotNull
                                                                   @NotNull DeploymentVersion version2)

Get JIRA issue links for comparing two versions, i.e. all JIRA issue linked to versions newer than older of the two versions up to (and including) then newer version.

Parameters:

deploymentProjectId -

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

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

Returns:

getJiraIssuesForNewDeploymentVersion

@NotNull
@NotNull List<InternalLinkedJiraIssue> getJiraIssuesForNewDeploymentVersion(long deploymentProjectId,
                                                                                     PlanResultKey planResultKey)

Finds the relevant jira issues 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

Returns:

getJiraIssuesForNewDeploymentVersion

@NotNull
@NotNull List<InternalLinkedJiraIssue> getJiraIssuesForNewDeploymentVersion(long deploymentProjectId,
                                                                                     PlanResultKey planResultKey,
                                                                                     DeploymentVersion previousVersion)

Same as above, but gets all issues between a specific version and the planResultKey.

Parameters:

deploymentProjectId - id of the deployment project

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

previousVersion - that we want to compare to

Returns:

getIssuesChangedForDeploymentResult

Set<String> getIssuesChangedForDeploymentResult(long deploymentResultId)

Finds issue keys for given deployment result Returns empty list if status of result build is unknown or if this and previous status is failed. Return all issues in deployment project if it's first result in known state or it's state is different than previous or it's in different branch then previous If none of the above is fulfilled it returns difference between previous successful deployed release but different then current one.

Parameters:

deploymentResultId -

Returns: