com.atlassian.jira.issue.fields.config.manager

Class PrioritySchemeManagerImpl

java.lang.Object

com.atlassian.jira.issue.fields.config.manager.PrioritySchemeManagerImpl

All Implemented Interfaces:

PrioritySchemeManager

public class PrioritySchemeManagerImpl
extends Object
implements PrioritySchemeManager

Constructor Summary

Constructors

Constructor and Description
PrioritySchemeManagerImpl(FieldConfigSchemeManager fieldConfigSchemeManager, OptionSetManager optionSetManager, GenericConfigManager genericConfigManager, ConstantsManager constantsManager, com.atlassian.event.api.EventPublisher eventPublisher, FeatureManager featureManager, ProjectManager projectManager, PrioritySchemeAuditHandler prioritySchemeHandler)

Method Summary

Modifier and Type	Method and Description
void	addOptionToDefault(String optionId) Adds the optionId to the default priority scheme.
void	assignProject(FieldConfigScheme priorityFieldConfig, Project project) Associates a project with a priority scheme.
void	assignProjects(FieldConfigScheme priorityFieldConfig, Set<Project> projects) Associates multiple projects with a priority scheme.
FieldConfigScheme	createWithDefaultMapping(String name, String description, List<String> optionIds) Creates a new FieldConfigScheme with a default mapping to FieldConfig.
void	delete(FieldConfigScheme fieldConfigScheme) Removes FieldConfigScheme.
Collection<FieldConfigScheme>	getAllRelatedSchemes(String optionId) Retrieves all schemes that have optionId as part of its options.
List<FieldConfigScheme>	getAllSchemes() Retrieves all priority schemes and sorts them.
String	getDefaultOption(FieldConfig fieldConfig) Returns the ID of the default Priority for a given fieldConfig.
String	getDefaultOption(IssueContext issueContext) Retrieves the ID of the default Priority for FieldConfig relevant to a passed issueContext for a priority system field.
FieldConfigScheme	getDefaultScheme() Retrieves the default global priority scheme which contains all priorities.
FieldConfig	getFieldConfigForDefaultMapping(FieldConfigScheme fieldConfigScheme) Retrieves FieldConfig that is used for a default mapping for a passed fieldConfigScheme.
List<String>	getOptions(FieldConfig fieldConfig) Retrieves a list of priority IDs configured for a passed fieldConfig.
List<String>	getOptions(IssueContext issueContext) Retrieves a list of priority IDs configured for a passed issueContext.
Collection<Priority>	getPrioritiesFromIds(Collection<String> priorityIds) Converts a collection of priority IDs to a collection of Priority.
Priority	getPriority(String priorityId) Converts priorityId to Priority value.
Set<Project>	getProjectsWithScheme(FieldConfigScheme fieldConfigScheme) Retrieves all projects associated with a scheme.
FieldConfigScheme	getScheme(Long id) Gets FieldConfigScheme by id.
FieldConfigScheme	getScheme(Project project) Gets FieldConfigScheme for given project.
boolean	isDefaultScheme(FieldConfigScheme fieldConfigScheme) Checks if a passed fieldConfigScheme is the default priority scheme.
void	removeOptionFromAllSchemes(String optionId) Removes a priority ID from all priority schemes that have the passed optionId as part of its options.
void	setDefaultOption(FieldConfig fieldConfig, String optionId) Sets default priority ID for given FieldConfigScheme.
void	setOptions(FieldConfig fieldConfig, List<String> optionIds) Sets priority IDs for fieldConfig.
void	unassignProject(FieldConfigScheme scheme, Project project) Removes a project from a priority scheme.
void	unassignProjects(FieldConfigScheme scheme, Set<Project> projects) Removes multiple projects from a priority scheme.
FieldConfigScheme	updateWithDefaultMapping(FieldConfigScheme fieldConfigScheme, List<String> optionIds) Updates FieldConfigScheme with provided data and options (priority IDs).

Methods inherited from class java.lang.Object

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

Constructor Detail

PrioritySchemeManagerImpl

public PrioritySchemeManagerImpl(FieldConfigSchemeManager fieldConfigSchemeManager,
                                 OptionSetManager optionSetManager,
                                 GenericConfigManager genericConfigManager,
                                 ConstantsManager constantsManager,
                                 com.atlassian.event.api.EventPublisher eventPublisher,
                                 FeatureManager featureManager,
                                 ProjectManager projectManager,
                                 PrioritySchemeAuditHandler prioritySchemeHandler)

Method Detail

getScheme

public FieldConfigScheme getScheme(Project project)

Description copied from interface: PrioritySchemeManager

Gets FieldConfigScheme for given project.

Specified by:

getScheme in interface PrioritySchemeManager

Parameters:

project - Project

Returns:

FieldConfigScheme associated with given project

getScheme

public FieldConfigScheme getScheme(Long id)

Description copied from interface: PrioritySchemeManager

Gets FieldConfigScheme by id.

Specified by:

getScheme in interface PrioritySchemeManager

Parameters:

id - scheme id

Returns:

FieldConfigScheme

getDefaultScheme

public FieldConfigScheme getDefaultScheme()

Description copied from interface: PrioritySchemeManager

Retrieves the default global priority scheme which contains all priorities.

Specified by:

getDefaultScheme in interface PrioritySchemeManager

Returns:

default FieldConfigScheme

getAllSchemes

public List<FieldConfigScheme> getAllSchemes()

Description copied from interface: PrioritySchemeManager

Retrieves all priority schemes and sorts them. Schemes with the default scheme ID are first. Schemes with null names are second, the rest are sorted on name.

Specified by:

getAllSchemes in interface PrioritySchemeManager

Returns:

all schemes sorted on name with default first

isDefaultScheme

public boolean isDefaultScheme(FieldConfigScheme fieldConfigScheme)

Description copied from interface: PrioritySchemeManager

Checks if a passed fieldConfigScheme is the default priority scheme.

Specified by:

isDefaultScheme in interface PrioritySchemeManager

Parameters:

fieldConfigScheme - Field config scheme in question

Returns:

true if fieldConfigScheme is default one, false otherwise.

getDefaultOption

public String getDefaultOption(IssueContext issueContext)

Description copied from interface: PrioritySchemeManager

Retrieves the ID of the default Priority for FieldConfig relevant to a passed issueContext for a priority system field. If no default priority is defined for FieldConfig then middle priority of all priorities assigned to that FieldConfig is returned.

Specified by:

getDefaultOption in interface PrioritySchemeManager

Parameters:

issueContext - IssueContext to obtain default value for

Returns:

Id of default Priority for issueContext

getDefaultOption

public String getDefaultOption(FieldConfig fieldConfig)

Description copied from interface: PrioritySchemeManager

Returns the ID of the default Priority for a given fieldConfig.

Specified by:

getDefaultOption in interface PrioritySchemeManager

Parameters:

fieldConfig - the field configuration scheme of interest

Returns:

Id of default Priority for this fieldConfig

setDefaultOption

public void setDefaultOption(FieldConfig fieldConfig,
                             String optionId)

Description copied from interface: PrioritySchemeManager

Sets default priority ID for given FieldConfigScheme.

Specified by:

setDefaultOption in interface PrioritySchemeManager

Parameters:

fieldConfig - FieldConfig for which set the default option

optionId - Priority id. Pass null to remove default priority from fieldConfig.

getOptions

public List<String> getOptions(IssueContext issueContext)

Description copied from interface: PrioritySchemeManager

Retrieves a list of priority IDs configured for a passed issueContext. If null is passed for issueContext then priority ids for default scheme are returned.

Specified by:

getOptions in interface PrioritySchemeManager

Parameters:

issueContext - Issue context eg. ProjectContext

Returns:

list of priorities configured for passed issueContext.

getOptions

public List<String> getOptions(FieldConfig fieldConfig)

Description copied from interface: PrioritySchemeManager

Retrieves a list of priority IDs configured for a passed fieldConfig. If null is passed as fieldConfig then empty list is returned.

Specified by:

getOptions in interface PrioritySchemeManager

Parameters:

fieldConfig - FieldConfig to obtain list of priority id from.

Returns:

List of priority ids for fieldConfig

setOptions

public void setOptions(FieldConfig fieldConfig,
                       List<String> optionIds)

Description copied from interface: PrioritySchemeManager

Sets priority IDs for fieldConfig.

Specified by:

setOptions in interface PrioritySchemeManager

Parameters:

fieldConfig - FieldConfig to set list of priority id for.

optionIds - List of priority ids.

createWithDefaultMapping

public FieldConfigScheme createWithDefaultMapping(@Nonnull
                                                  String name,
                                                  String description,
                                                  List<String> optionIds)

Description copied from interface: PrioritySchemeManager

Creates a new FieldConfigScheme with a default mapping to FieldConfig. Also creates options in OPTION_CONFIGURATION table. Triggers PrioritySchemeCreatedEvent.

Specified by:

createWithDefaultMapping in interface PrioritySchemeManager

Parameters:

name - Scheme name

description - Scheme description

optionIds - Collection of priority ids

Returns:

created FieldConfigScheme

updateWithDefaultMapping

public FieldConfigScheme updateWithDefaultMapping(FieldConfigScheme fieldConfigScheme,
                                                  List<String> optionIds)

Description copied from interface: PrioritySchemeManager

Updates FieldConfigScheme with provided data and options (priority IDs). Default FieldConfig for FieldConfigScheme is used. Triggers PrioritySchemeUpdatedEvent.

Specified by:

updateWithDefaultMapping in interface PrioritySchemeManager

Parameters:

fieldConfigScheme - Field config scheme to update

optionIds - Collection of priority ids

Returns:

updated FieldConfigScheme

getFieldConfigForDefaultMapping

public FieldConfig getFieldConfigForDefaultMapping(FieldConfigScheme fieldConfigScheme)

Description copied from interface: PrioritySchemeManager

Retrieves FieldConfig that is used for a default mapping for a passed fieldConfigScheme.

Specified by:

getFieldConfigForDefaultMapping in interface PrioritySchemeManager

Returns:

FieldConfig for default mapping for fieldConfigScheme

delete

public void delete(FieldConfigScheme fieldConfigScheme)

Description copied from interface: PrioritySchemeManager

Removes FieldConfigScheme. Triggers PrioritySchemeDeletedEvent.

Specified by:

delete in interface PrioritySchemeManager

Parameters:

fieldConfigScheme - FieldConfigScheme to delete

addOptionToDefault

public void addOptionToDefault(String optionId)

Description copied from interface: PrioritySchemeManager

Adds the optionId to the default priority scheme.

Specified by:

addOptionToDefault in interface PrioritySchemeManager

Parameters:

optionId - priority id

removeOptionFromAllSchemes

public void removeOptionFromAllSchemes(String optionId)

Description copied from interface: PrioritySchemeManager

Removes a priority ID from all priority schemes that have the passed optionId as part of its options.

Specified by:

removeOptionFromAllSchemes in interface PrioritySchemeManager

Parameters:

optionId - Priority id to remove from all priority schemes.

getAllRelatedSchemes

public Collection<FieldConfigScheme> getAllRelatedSchemes(String optionId)

Description copied from interface: PrioritySchemeManager

Retrieves all schemes that have optionId as part of its options.

Specified by:

getAllRelatedSchemes in interface PrioritySchemeManager

Parameters:

optionId - Priority id being queried

Returns:

Collection of FieldConfigScheme objects

getPriority

public Priority getPriority(String priorityId)

Description copied from interface: PrioritySchemeManager

Converts priorityId to Priority value.

Specified by:

getPriority in interface PrioritySchemeManager

Parameters:

priorityId - Id of Priority

Returns:

Priority object

getPrioritiesFromIds

public Collection<Priority> getPrioritiesFromIds(Collection<String> priorityIds)

Description copied from interface: PrioritySchemeManager

Converts a collection of priority IDs to a collection of Priority. Priorities not found by id are skipped.

Specified by:

getPrioritiesFromIds in interface PrioritySchemeManager

Parameters:

priorityIds - Collection of ids for Priority

Returns:

Collection of Priority objects

assignProject

public void assignProject(@Nonnull
                          FieldConfigScheme priorityFieldConfig,
                          @Nonnull
                          Project project)

Description copied from interface: PrioritySchemeManager

Associates a project with a priority scheme. To assign project to "default priority scheme" please unassign project from currently used priority scheme PrioritySchemeManager.unassignProject(FieldConfigScheme, Project). If this method is used on "default priority scheme" it will remove DB association that marks scheme as default thus it will break "default priority scheme". When assigning multiple projects please use PrioritySchemeManager.assignProjects(FieldConfigScheme, Set) instead of calling this method in a loop to achieve better performance.

Specified by:

assignProject in interface PrioritySchemeManager

Parameters:

priorityFieldConfig - the scheme

project - the project

assignProjects

public void assignProjects(@Nonnull
                           FieldConfigScheme priorityFieldConfig,
                           @Nonnull
                           Set<Project> projects)

Description copied from interface: PrioritySchemeManager

Associates multiple projects with a priority scheme. To assign project to "default priority scheme" please unassign project from currently used priority scheme PrioritySchemeManager.unassignProject(FieldConfigScheme, Project). If this method is used on "default priority scheme" it will remove DB association that marks scheme as default thus it will break "default priority scheme".

Specified by:

assignProjects in interface PrioritySchemeManager

Parameters:

priorityFieldConfig - the scheme

projects - the projects

getProjectsWithScheme

@Nonnull
public Set<Project> getProjectsWithScheme(@Nonnull
                                                   FieldConfigScheme fieldConfigScheme)

Description copied from interface: PrioritySchemeManager

Retrieves all projects associated with a scheme.

Specified by:

getProjectsWithScheme in interface PrioritySchemeManager

Parameters:

fieldConfigScheme - the scheme

Returns:

List of Project with the given scheme (possibly empty)

unassignProject

public void unassignProject(@Nonnull
                            FieldConfigScheme scheme,
                            @Nonnull
                            Project project)

Description copied from interface: PrioritySchemeManager

Removes a project from a priority scheme. It can also be used to assign project with "default priority scheme" - simply unassign project from currently used scheme and the project will start using default priority scheme. When unassigning multiple projects please use PrioritySchemeManager.unassignProjects(FieldConfigScheme, Set) instead of calling this method in a loop to achieve better performance.

Specified by:

unassignProject in interface PrioritySchemeManager

Parameters:

scheme - the scheme

project - the project

unassignProjects

public void unassignProjects(@Nonnull
                             FieldConfigScheme scheme,
                             @Nonnull
                             Set<Project> projects)

Description copied from interface: PrioritySchemeManager

Removes multiple projects from a priority scheme. It can also be used to assign projects with "default priority scheme" - simply unassign projects from currently used scheme and the projects will start using default priority scheme.

Specified by:

unassignProjects in interface PrioritySchemeManager

Parameters:

scheme - the scheme

projects - the projects