com.atlassian.jira.project.version

Class DefaultVersionManager

java.lang.Object

com.atlassian.jira.project.version.DefaultVersionManager

All Implemented Interfaces:

VersionManager

public class DefaultVersionManager
extends Object
implements VersionManager

Field Summary

Fields inherited from interface com.atlassian.jira.project.version.VersionManager

ALL_RELEASED_VERSIONS, ALL_UNRELEASED_VERSIONS, NO_VERSIONS

Constructor Summary

Constructors

Constructor and Description
DefaultVersionManager(IssueManager issueManager, NodeAssociationStore nodeAssociationStore, IssueIndexingService issueIndexService, VersionStore versionStore, com.atlassian.event.api.EventPublisher eventPublisher, DbConnectionManager dbConnectionManager, VersionCustomFieldStore versionCustomFieldStore)

Method Summary

Modifier and Type	Method and Description
Version	archiveVersion(Version version, boolean archive) Archive/Un-archive a single version depending on the archive flag.
void	archiveVersions(String[] idsToArchive, String[] idsToUnarchive) Method used to archive and un-archive a number of versions.
Version	createVersion(String name, Date startDate, Date releaseDate, String description, Long projectId, Long scheduleAfterVersion) Creates a new Version object.
Version	createVersion(String name, Date startDate, Date releaseDate, String description, Long projectId, Long scheduleAfterVersion, boolean released) Creates a new Version.
Version	createVersion(String name, Date releaseDate, String description, org.ofbiz.core.entity.GenericValue project, Long scheduleAfterVersion) Deprecated. since version 6.0
Version	createVersion(String name, Date releaseDate, String description, Long projectId, Long scheduleAfterVersion) Creates a new Version object.
Version	decreaseVersionSequence(Version version) Move a version to have a higher sequence number - ie make it later
void	deleteAllVersions(Long projectId) Deletes all versions in given project.
void	deleteAndRemoveFromIssues(ApplicationUser user, Version versionToRemove) This method deletes a version and additionally (unlinke VersionManager.deleteVersion(com.atlassian.jira.project.version.Version)) removes it from all issues that reference it.
void	deleteVersion(ApplicationUser applicationUser, Version versionToDelete, com.atlassian.fugue.Option<Version> affectsSwapVersion, com.atlassian.fugue.Option<Version> fixSwapVersion) Removes a specific version from the system.
void	deleteVersion(Version version) Removes a specific version from the system.
void	deleteVersionAndSwap(ApplicationUser applicationUser, DeleteVersionWithCustomFieldParameters parameters) Testing notes - side effects (reindexing, events) are tested in unitTest, actual version removal is tested in com.atlassian.jira.webtests.ztests.bundledplugins2.rest.TestVersionResource.
Version	editVersionDetails(Version version, String name, String description) Updates details of an existing version.
Version	editVersionReleaseDate(Version version, Date duedate) Update the release date of a version.
Version	editVersionStartDate(Version version, Date startDate) Updates the start date of a version
Version	editVersionStartReleaseDate(Version version, Date startDate, Date releaseDate) Updates the start and release date of a version
Collection<Version>	getAffectedVersionsFor(Issue issue) Get all affected versions of the specified issue.
Collection<Version>	getAllVersions()
Collection<Version>	getAllVersionsForProjects(Collection<Project> projects, boolean includeArchived) Returns all versions that belong to the passed projects.
Collection<Version>	getAllVersionsReleased(boolean includeArchived)
Collection<Version>	getAllVersionsUnreleased(boolean includeArchived)
long	getCustomFieldIssuesCount(Version version) This method gives total number of issues where this version is used in custom fields.
Collection<CustomFieldWithVersionUsage>	getCustomFieldsUsing(Version version) This method gives information about usage of given version in custom fields.
Collection<Version>	getFixVersionsFor(Issue issue) Get all fix for versions of the specified issue.
protected IssueFactory	getIssueFactory() NB: This is done because we can't inject a IssueFactory, this would cause circular dependency.
Collection<Long>	getIssueIdsWithAffectsVersion(Version version) Return all the issues in which the affects version matches the specified version.
Collection<Long>	getIssueIdsWithFixVersion(Version version) Return all the issues in which the fix version matches the specified version.
Collection<Issue>	getIssuesWithAffectsVersion(Version version) Return all the issues in which the affected version matches the specified version.
Collection<Issue>	getIssuesWithFixVersion(Version version) Return all the issues in which the fix for version matches the specified version.
Collection<Version>	getOtherUnarchivedVersions(Version version) Return all unarchived versions except this one
Collection<Version>	getOtherVersions(Version version) Return all other versions in the project except this one
int	getTotalVersionCount()
Version	getVersion(Long id) Returns a single version.
Version	getVersion(Long projectId, String versionName) Retrieve a specific Version in a project given the project id, or null if no such version exists in that project.
Collection<Version>	getVersions(List<Long> ids) Return a collection of Versions matching the ids passed in.
List<Version>	getVersions(Long projectId) Return a list of Versions for the given project.
List<Version>	getVersions(Long projectId, boolean includeArchived) Return a list of Versions for the given project.
List<Version>	getVersions(Project project) Return a list of Versions for the given project.
Collection<Version>	getVersionsArchived(Project project) Return all archived versions for a particular project.
protected Collection<Version>	getVersionsByIssue(org.ofbiz.core.entity.GenericValue issue, String relationName)
Collection<Version>	getVersionsByName(String versionName) Return a collection of Versions that have the specified name.
Collection<Version>	getVersionsReleased(Long projectId, boolean includeArchived) Gets a list of released versions for a project.
Collection<Version>	getVersionsReleasedDesc(Long projectId, boolean includeArchived) Gets a list of released versions for a project in reverse order.
Collection<Version>	getVersionsUnarchived(Long projectId) Return all un-archived versions for a particular project
Collection<Version>	getVersionsUnreleased(Long projectId, boolean includeArchived) Gets a list of un-released versions for a particular project.
Version	increaseVersionSequence(Version version) Move a version to have a lower sequence number - ie make it earlier
boolean	isDuplicateName(Version currentVersion, String name) Check that the version name we are changing to is not a duplicate.
boolean	isVersionOverDue(Version version) Checks to see if a version is overdue.
void	merge(ApplicationUser user, Version versionToDelete, Version versionToMergeTo) This method will perform a version merge.
void	moveIssuesToNewVersion(List<Issue> issues, Version currentVersion, Version swapToVersion) Swaps the list of issues supplied from one Fix version to another.
Version	moveToEndVersionSequence(Version version) Move a version to the end of the version sequence
Version	moveToStartVersionSequence(Version version) Move a version to the start of the version list
Version	moveVersionAfter(Version version, Long scheduleAfterVersionId) Move a version after another version
Version	releaseVersion(Version version, boolean release) Used to release or unrelease a version, depending on the release flag.
Collection<Version>	releaseVersions(Collection<Version> versions, boolean release) Used to release versions depending on the release flag.
void	storeReorderedVersionList(List<Version> versions) Given a re-ordered list of versions, commit the changes to the backend datastore.
void	swapVersionForRelatedIssues(ApplicationUser user, Version version, com.atlassian.fugue.Option<Version> affectsSwapVersion, com.atlassian.fugue.Option<Version> fixSwapVersion) This method will update all issues that currently have version set as either affects or fix version to the new affectsSwapVersion or fixSwapVersion
Version	update(Version version) Persists updates to the specified version object.
List<ChangeItemBean>	updateIssueAffectsVersions(Issue issue, Collection<Version> newVersions)
List<ChangeItemBean>	updateIssueFixVersions(Issue issue, Collection<Version> newValue)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultVersionManager

public DefaultVersionManager(IssueManager issueManager,
                             NodeAssociationStore nodeAssociationStore,
                             IssueIndexingService issueIndexService,
                             VersionStore versionStore,
                             com.atlassian.event.api.EventPublisher eventPublisher,
                             DbConnectionManager dbConnectionManager,
                             VersionCustomFieldStore versionCustomFieldStore)

Method Detail

createVersion

@Deprecated
public Version createVersion(String name,
                                         Date releaseDate,
                                         String description,
                                         org.ofbiz.core.entity.GenericValue project,
                                         Long scheduleAfterVersion)
                                  throws CreateException

Deprecated. since version 6.0

Throws:

CreateException

createVersion

public Version createVersion(String name,
                             Date releaseDate,
                             String description,
                             Long projectId,
                             Long scheduleAfterVersion)
                      throws CreateException

Description copied from interface: VersionManager

Creates a new Version object.

Specified by:

createVersion in interface VersionManager

Parameters:

name - the Name

releaseDate - date of release or null if not released.

description - the Description

projectId - the id of the Project of the version.

scheduleAfterVersion - id of the version after which this should be sequenced or null.

Returns:

the new Version.

Throws:

CreateException - If there was a problem creating the version.

createVersion

public Version createVersion(String name,
                             Date startDate,
                             Date releaseDate,
                             String description,
                             Long projectId,
                             Long scheduleAfterVersion)
                      throws CreateException

Description copied from interface: VersionManager

Creates a new Version object.

Specified by:

createVersion in interface VersionManager

Parameters:

name - the Name

startDate - start date of the version or null

releaseDate - date of release or null if not released.

description - the Description

projectId - the id of the Project of the version.

scheduleAfterVersion - id of the version after which this should be sequenced or null.

Returns:

the new Version.

Throws:

CreateException - If there was a problem creating the version.

createVersion

public Version createVersion(String name,
                             Date startDate,
                             Date releaseDate,
                             String description,
                             Long projectId,
                             Long scheduleAfterVersion,
                             boolean released)
                      throws CreateException

Description copied from interface: VersionManager

Creates a new Version. This method differs from VersionManager.createVersion(String, java.util.Date, java.util.Date, String, Long, Long) in that it lets you specify the value for the attribute release.

Specified by:

createVersion in interface VersionManager

Parameters:

name - Name of the version

startDate - Start date of the version

releaseDate - Release date for the version

description - Version description

projectId - The numeric id of the project this version belongs

scheduleAfterVersion - Numeric id of the version to schedule after the given version object

released - Sets the release attribute value for the version object to create

Returns:

The created version object

Throws:

CreateException

moveToStartVersionSequence

public Version moveToStartVersionSequence(Version version)

Description copied from interface: VersionManager

Move a version to the start of the version list

Specified by:

moveToStartVersionSequence in interface VersionManager

Parameters:

version - the Version to move

increaseVersionSequence

public Version increaseVersionSequence(Version version)

Description copied from interface: VersionManager

Move a version to have a lower sequence number - ie make it earlier

Specified by:

increaseVersionSequence in interface VersionManager

Parameters:

version - the Version

decreaseVersionSequence

public Version decreaseVersionSequence(Version version)

Description copied from interface: VersionManager

Move a version to have a higher sequence number - ie make it later

Specified by:

decreaseVersionSequence in interface VersionManager

Parameters:

version - the Version

moveToEndVersionSequence

public Version moveToEndVersionSequence(Version version)

Description copied from interface: VersionManager

Move a version to the end of the version sequence

Specified by:

moveToEndVersionSequence in interface VersionManager

Parameters:

version - the Version

moveVersionAfter

public Version moveVersionAfter(Version version,
                                Long scheduleAfterVersionId)

Description copied from interface: VersionManager

Move a version after another version

Specified by:

moveVersionAfter in interface VersionManager

Parameters:

version - version to reschedule

scheduleAfterVersionId - id of the version to schedule after the given version object

deleteVersion

public void deleteVersion(Version version)

Description copied from interface: VersionManager

Removes a specific version from the system.

Specified by:

deleteVersion in interface VersionManager

Parameters:

version - The version to be removed.

See Also:

VersionManager.deleteAndRemoveFromIssues(com.atlassian.jira.user.ApplicationUser, Version)

deleteVersion

public void deleteVersion(ApplicationUser applicationUser,
                          Version versionToDelete,
                          com.atlassian.fugue.Option<Version> affectsSwapVersion,
                          com.atlassian.fugue.Option<Version> fixSwapVersion)

Description copied from interface: VersionManager

Removes a specific version from the system. versionToDelete is the version which is going to be removed. If affectsSwapVersion is defined, then issues with versionToDelete as a value of Affects Version/s system field will use affectsSwapVersion instead. Similarly, fixSwapVersion will replace versionToDelete as a value in Fix Version/s system field.

Specified by:

deleteVersion in interface VersionManager

Parameters:

applicationUser - the user that will be used to update related issues

versionToDelete - the version to be deleted

affectsSwapVersion - the version which replaces the version to be deleted as Affected Version/s.

fixSwapVersion - the version which replaces the version to be deleted as Fix Version/s.

deleteAllVersions

public void deleteAllVersions(@Nonnull
                              Long projectId)

Description copied from interface: VersionManager

Deletes all versions in given project. Note that this method will not fire a VersionDeleteEvent upon deletion of a version.

Specified by:

deleteAllVersions in interface VersionManager

Parameters:

projectId - the id of project in which versions will be deleted.

update

public Version update(Version version)

Description copied from interface: VersionManager

Persists updates to the specified version object.

Specified by:

update in interface VersionManager

Parameters:

version - the version

Returns:

the updated version

editVersionDetails

public Version editVersionDetails(Version version,
                                  String name,
                                  String description)

Description copied from interface: VersionManager

Updates details of an existing version.

Specified by:

editVersionDetails in interface VersionManager

Parameters:

version - The version to update

name - The new version name, cannot be empty.

description - The description of this version.

releaseVersion

public Version releaseVersion(Version version,
                              boolean release)

Description copied from interface: VersionManager

Used to release or unrelease a version, depending on the release flag.

Specified by:

releaseVersion in interface VersionManager

Parameters:

version - Version to be released (or unreleased)

release - True to release a version. False to 'unrelease' a version

releaseVersions

public Collection<Version> releaseVersions(Collection<Version> versions,
                                           boolean release)

Description copied from interface: VersionManager

Used to release versions depending on the release flag.

Specified by:

releaseVersions in interface VersionManager

Parameters:

versions - Collection of Versions

release - True to release a version. False to 'unrelease' a version

moveIssuesToNewVersion

public void moveIssuesToNewVersion(List<Issue> issues,
                                   Version currentVersion,
                                   Version swapToVersion)
                            throws IndexException

Description copied from interface: VersionManager

Swaps the list of issues supplied from one Fix version to another.

Specified by:

moveIssuesToNewVersion in interface VersionManager

Parameters:

issues - the Issues

currentVersion - Current fix version they will be swapped from

swapToVersion - New fix version they will be swapped to.

Throws:

IndexException - if an error occurs will indexing these new issue values.

archiveVersions

public void archiveVersions(String[] idsToArchive,
                            String[] idsToUnarchive)

Description copied from interface: VersionManager

Method used to archive and un-archive a number of versions.

Specified by:

archiveVersions in interface VersionManager

Parameters:

idsToArchive - Archive all these Versions

idsToUnarchive - Unarchive these Versions

archiveVersion

public Version archiveVersion(Version version,
                              boolean archive)

Description copied from interface: VersionManager

Archive/Un-archive a single version depending on the archive flag.

Specified by:

archiveVersion in interface VersionManager

Parameters:

version - the Version to archive or unarchive

archive - new archive value

editVersionReleaseDate

public Version editVersionReleaseDate(Version version,
                                      Date duedate)

Description copied from interface: VersionManager

Update the release date of a version.

Specified by:

editVersionReleaseDate in interface VersionManager

Parameters:

version - the Version to edit

duedate - new release date

editVersionStartDate

public Version editVersionStartDate(Version version,
                                    Date startDate)

Description copied from interface: VersionManager

Updates the start date of a version

Specified by:

editVersionStartDate in interface VersionManager

Parameters:

version - the version to edit

startDate - new start date

editVersionStartReleaseDate

public Version editVersionStartReleaseDate(Version version,
                                           Date startDate,
                                           Date releaseDate)

Description copied from interface: VersionManager

Updates the start and release date of a version

Specified by:

editVersionStartReleaseDate in interface VersionManager

Parameters:

version - the version to edit

startDate - new start date

releaseDate - new release date

isVersionOverDue

public boolean isVersionOverDue(Version version)

Description copied from interface: VersionManager

Checks to see if a version is overdue. Note: This method checks if the due date set for a version is previous to last midnight. (not now()).

Specified by:

isVersionOverDue in interface VersionManager

Parameters:

version - the Version

Returns:

True if the version is overdue. (i.e. releaseDate is before last midnight)

getVersionsUnarchived

public Collection<Version> getVersionsUnarchived(Long projectId)

Description copied from interface: VersionManager

Return all un-archived versions for a particular project

Specified by:

getVersionsUnarchived in interface VersionManager

Parameters:

projectId - id of the project.

Returns:

A collection of Versions

getVersionsArchived

public Collection<Version> getVersionsArchived(Project project)

Description copied from interface: VersionManager

Return all archived versions for a particular project.

Specified by:

getVersionsArchived in interface VersionManager

Parameters:

project - the Project

Returns:

Archived versions for this project.

getVersions

public List<Version> getVersions(Long projectId)

Description copied from interface: VersionManager

Return a list of Versions for the given project.

Specified by:

getVersions in interface VersionManager

Parameters:

projectId - the Project

Returns:

a list of Versions for the given project.

See Also:

VersionManager.getVersions(Project)

getVersions

public List<Version> getVersions(Long projectId,
                                 boolean includeArchived)

Description copied from interface: VersionManager

Return a list of Versions for the given project.

Specified by:

getVersions in interface VersionManager

Parameters:

projectId - the Project

includeArchived - whether or not to include archived versions

Returns:

a list of Versions for the given project.

See Also:

VersionManager.getVersions(Project)

getVersions

public List<Version> getVersions(Project project)

Description copied from interface: VersionManager

Return a list of Versions for the given project.

Specified by:

getVersions in interface VersionManager

Parameters:

project - the Project

Returns:

a list of Versions for the given project.

See Also:

VersionManager.getVersions(Long)

getVersionsByName

public Collection<Version> getVersionsByName(String versionName)

Description copied from interface: VersionManager

Return a collection of Versions that have the specified name.

Specified by:

getVersionsByName in interface VersionManager

Parameters:

versionName - the name of the version (case-insensitive)

Returns:

a Collection of Version objects. Never null.

getAffectedVersionsFor

public Collection<Version> getAffectedVersionsFor(Issue issue)

Description copied from interface: VersionManager

Get all affected versions of the specified issue.

Specified by:

getAffectedVersionsFor in interface VersionManager

Parameters:

issue - the issue

Returns:

all affected versions of the specified issue.

updateIssueAffectsVersions

public List<ChangeItemBean> updateIssueAffectsVersions(Issue issue,
                                                       Collection<Version> newVersions)

Specified by:

updateIssueAffectsVersions in interface VersionManager

updateIssueFixVersions

public List<ChangeItemBean> updateIssueFixVersions(Issue issue,
                                                   Collection<Version> newValue)

Specified by:

updateIssueFixVersions in interface VersionManager

getFixVersionsFor

public Collection<Version> getFixVersionsFor(Issue issue)

Description copied from interface: VersionManager

Get all fix for versions of the specified issue.

Specified by:

getFixVersionsFor in interface VersionManager

Parameters:

issue - the Issue

Returns:

all fix for versions of the specified issue.

getAllVersions

public Collection<Version> getAllVersions()

Specified by:

getAllVersions in interface VersionManager

Returns:

all versions in JIRA. Never null.

getTotalVersionCount

public int getTotalVersionCount()

Specified by:

getTotalVersionCount in interface VersionManager

Returns:

count of all versions.

getAllVersionsForProjects

public Collection<Version> getAllVersionsForProjects(Collection<Project> projects,
                                                     boolean includeArchived)

Description copied from interface: VersionManager

Returns all versions that belong to the passed projects.

Specified by:

getAllVersionsForProjects in interface VersionManager

Parameters:

projects - projects to search in

includeArchived - whether or not to include archived versions

Returns:

all versions that belong to passed projects. Never null.

getAllVersionsReleased

public Collection<Version> getAllVersionsReleased(boolean includeArchived)

Specified by:

getAllVersionsReleased in interface VersionManager

Parameters:

includeArchived - whether or not to include archived versions

Returns:

all released versions in JIRA. Never null.

getAllVersionsUnreleased

public Collection<Version> getAllVersionsUnreleased(boolean includeArchived)

Specified by:

getAllVersionsUnreleased in interface VersionManager

Parameters:

includeArchived - whether or not to include archived versions

Returns:

all released versions in JIRA. Never null.

merge

public void merge(ApplicationUser user,
                  @Nonnull
                  Version versionToDelete,
                  @Nonnull
                  Version versionToMergeTo)

Description copied from interface: VersionManager

This method will perform a version merge. versionToDelete is a version that will be deleted completely. All issues will have this version replaced with versionToMergeTo.

Specified by:

merge in interface VersionManager

Parameters:

user - The user that will be used to update related issues

versionToDelete - Version that will be deleted

versionToMergeTo - All issues will have deleted version replaced with this one

deleteAndRemoveFromIssues

public void deleteAndRemoveFromIssues(ApplicationUser user,
                                      @Nonnull
                                      Version versionToRemove)

Description copied from interface: VersionManager

This method deletes a version and additionally (unlinke VersionManager.deleteVersion(com.atlassian.jira.project.version.Version)) removes it from all issues that reference it.

Specified by:

deleteAndRemoveFromIssues in interface VersionManager

Parameters:

user - User that will perform the update of issues.

versionToRemove - Version to be deleted.

swapVersionForRelatedIssues

public void swapVersionForRelatedIssues(ApplicationUser user,
                                        Version version,
                                        com.atlassian.fugue.Option<Version> affectsSwapVersion,
                                        com.atlassian.fugue.Option<Version> fixSwapVersion)

Description copied from interface: VersionManager

This method will update all issues that currently have version set as either affects or fix version to the new affectsSwapVersion or fixSwapVersion

Both affectsSwapVersion or fixSwapVersion may be undefined in which case the version will simply be removed from the issue.

Specified by:

swapVersionForRelatedIssues in interface VersionManager

Parameters:

user - The user that will be used to update related issues

version - The version to remove from issues

affectsSwapVersion - Affects version to replace version with. May be undefined to simply remove the version.

fixSwapVersion - Fix version to replace version with. May be undefined to simply remove the version.

See Also:

VersionManager.merge(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.project.version.Version, com.atlassian.jira.project.version.Version), VersionManager.deleteAndRemoveFromIssues(com.atlassian.jira.user.ApplicationUser, com.atlassian.jira.project.version.Version)

getVersionsByIssue

protected Collection<Version> getVersionsByIssue(org.ofbiz.core.entity.GenericValue issue,
                                                 String relationName)

Parameters:

issue - the issue

relationName - IssueRelationConstants.VERSION or IssueRelationConstants.FIX_VERSION.

Returns:

A collection of Versions for this issue.

getVersions

public Collection<Version> getVersions(List<Long> ids)

Description copied from interface: VersionManager

Return a collection of Versions matching the ids passed in.

Specified by:

getVersions in interface VersionManager

Parameters:

ids - Version IDs

Returns:

a collection of Versions matching the ids passed in.

getVersionsUnreleased

public Collection<Version> getVersionsUnreleased(Long projectId,
                                                 boolean includeArchived)

Description copied from interface: VersionManager

Gets a list of un-released versions for a particular project.

Specified by:

getVersionsUnreleased in interface VersionManager

Parameters:

projectId - The id of the project for which to return versions

includeArchived - True if archived versions should be included

Returns:

A Collection of Versions, never null

getVersionsReleased

public Collection<Version> getVersionsReleased(Long projectId,
                                               boolean includeArchived)

Description copied from interface: VersionManager

Gets a list of released versions for a project. This list will include archived versions if the 'includeArchived' flag is set to true.

Specified by:

getVersionsReleased in interface VersionManager

Parameters:

projectId - project id

includeArchived - flag to indicate whether to include archived versions in the result.

Returns:

A collection of Version objects

getVersionsReleasedDesc

public Collection<Version> getVersionsReleasedDesc(Long projectId,
                                                   boolean includeArchived)

Description copied from interface: VersionManager

Gets a list of released versions for a project in reverse order. This list will include archived versions if the 'includeArchived' flag is set to true.

Specified by:

getVersionsReleasedDesc in interface VersionManager

Parameters:

projectId - project id

includeArchived - flag to indicate whether to include archived versions in the result.

Returns:

A collection of Version objects

getVersion

public Version getVersion(Long id)

Description copied from interface: VersionManager

Returns a single version.

Specified by:

getVersion in interface VersionManager

Parameters:

id - the Version ID

Returns:

A Version object.

getVersion

public Version getVersion(Long projectId,
                          String versionName)

Retrieve a specific Version in a project given the project id, or null if no such version exists in that project.

Specified by:

getVersion in interface VersionManager

Parameters:

projectId - the Project

versionName - the Version name

Returns:

A Version object.

getIssueFactory

protected IssueFactory getIssueFactory()

NB: This is done because we can't inject a IssueFactory, this would cause circular dependency.

getOtherVersions

public Collection<Version> getOtherVersions(Version version)

Return all other versions in the project except this one

Specified by:

getOtherVersions in interface VersionManager

Parameters:

version - the Version

Returns:

all other versions in the project except this one

getOtherUnarchivedVersions

public Collection<Version> getOtherUnarchivedVersions(Version version)

Return all unarchived versions except this one

Specified by:

getOtherUnarchivedVersions in interface VersionManager

Parameters:

version - the Version

Returns:

all unarchived versions except this one

getIssuesWithFixVersion

public Collection<Issue> getIssuesWithFixVersion(Version version)

Description copied from interface: VersionManager

Return all the issues in which the fix for version matches the specified version.

Specified by:

getIssuesWithFixVersion in interface VersionManager

Parameters:

version - the fixed for version.

Returns:

all the issues in which the fix for version matches the specified version.

getIssuesWithAffectsVersion

public Collection<Issue> getIssuesWithAffectsVersion(Version version)

Description copied from interface: VersionManager

Return all the issues in which the affected version matches the specified version.

Specified by:

getIssuesWithAffectsVersion in interface VersionManager

Parameters:

version - the affected version.

Returns:

all the issues in which the affected version matches the specified version.

getIssueIdsWithAffectsVersion

public Collection<Long> getIssueIdsWithAffectsVersion(@Nonnull
                                                      Version version)

Description copied from interface: VersionManager

Return all the issues in which the affects version matches the specified version.

Specified by:

getIssueIdsWithAffectsVersion in interface VersionManager

Parameters:

version - the affects version.

Returns:

all the issues in which the affects version matches the specified version.

getIssueIdsWithFixVersion

public Collection<Long> getIssueIdsWithFixVersion(@Nonnull
                                                  Version version)

Description copied from interface: VersionManager

Return all the issues in which the fix version matches the specified version.

Specified by:

getIssueIdsWithFixVersion in interface VersionManager

Parameters:

version - the fix version.

Returns:

all the issues in which the fix version matches the specified version.

getCustomFieldsUsing

@Nonnull
public Collection<CustomFieldWithVersionUsage> getCustomFieldsUsing(@Nonnull
                                                                             Version version)

Description copied from interface: VersionManager

This method gives information about usage of given version in custom fields.

Specified by:

getCustomFieldsUsing in interface VersionManager

Parameters:

version - The version that we want to get information about.

Returns:

collection of version usage for each custom fields.

getCustomFieldIssuesCount

public long getCustomFieldIssuesCount(@Nonnull
                                      Version version)

Description copied from interface: VersionManager

This method gives total number of issues where this version is used in custom fields.

Specified by:

getCustomFieldIssuesCount in interface VersionManager

Parameters:

version - The version that we want to get information about.

Returns:

collection of version usage for each custom fields.

deleteVersionAndSwap

public void deleteVersionAndSwap(ApplicationUser applicationUser,
                                 DeleteVersionWithCustomFieldParameters parameters)

Testing notes - side effects (reindexing, events) are tested in unitTest, actual version removal is tested in com.atlassian.jira.webtests.ztests.bundledplugins2.rest.TestVersionResource.

Specified by:

deleteVersionAndSwap in interface VersionManager

Parameters:

applicationUser - The user for this call

parameters - parameters build with builder obtained by VersionService.createVersionDeletaAndReplaceParameters(Version)

See Also:

merge - if you want to replace all version references to given version.

isDuplicateName

public boolean isDuplicateName(Version currentVersion,
                               String name)

Description copied from interface: VersionManager

Check that the version name we are changing to is not a duplicate.

Specified by:

isDuplicateName in interface VersionManager

Parameters:

currentVersion - The version to update

name - The new name for the version

Returns:

true if there is already a version with that name for the project

storeReorderedVersionList

public void storeReorderedVersionList(List<Version> versions)

Given a re-ordered list of versions, commit the changes to the backend datastore.