com.atlassian.jira.issue.managers

Class MockCustomFieldManager

java.lang.Object

com.atlassian.jira.issue.managers.MockCustomFieldManager

All Implemented Interfaces:

CustomFieldManager

public class MockCustomFieldManager
extends Object
implements CustomFieldManager

Constructor Summary

Constructors

Constructor and Description
MockCustomFieldManager()

Method Summary

Modifier and Type	Method and Description
void	addCustomField(CustomField customField)
void	addCustomFieldType(String key, CustomFieldType customFieldType)
void	clear() clear the cache
CustomField	createCustomField(String fieldName, String description, CustomFieldType fieldType, CustomFieldSearcher customFieldSearcher, List contexts, List issueTypes) Creates a custom field with the given name and description of the given CustomFieldType using the given CustomFieldSearcher that is displayed in the given list of contexts available to the given list of issueTypes.
boolean	exists(String id) Returns true if this customfield actually exists.
CustomField	getCustomFieldInstance(org.ofbiz.core.entity.GenericValue customFieldGv) Converts a customfield GenericValue to a CustomField instance.
CustomField	getCustomFieldObject(Long id) Get a CustomField by ID.
CustomField	getCustomFieldObject(String id) Get a CustomField by its text key (eg 'customfield_10000').
CustomField	getCustomFieldObjectByName(String customFieldName) Retrieve the first custom field object with the specified name.
List	getCustomFieldObjects() Returns all custom fields.
List	getCustomFieldObjects(org.ofbiz.core.entity.GenericValue issue) Returns a list of CustomFields that apply to a particular issue.
List	getCustomFieldObjects(Issue issue) Returns a list of CustomFields that apply to a particular issue.
List	getCustomFieldObjects(Long projectId, List issueTypes) Returns the same as CustomFieldManager.getCustomFieldObjects(Long, String) but allows to specify a list of issueTypes.
List	getCustomFieldObjects(Long projectId, String issueType) Gets a list of custom fields for a particular project and issue type.
List	getCustomFieldObjects(SearchContext searchContext) Returns all customfields in a particular SearchContext.
Collection	getCustomFieldObjectsByName(String customFieldName) Retrieve custom field(s) of a certain name.
Collection<CustomField>	getCustomFieldObjectsByNameIgnoreCase(String customFieldName) Retrieve custom field(s) of a certain name ignoring case.
CustomFieldSearcher	getCustomFieldSearcher(String key) Retrieve a custom field searcher by its type key.
Class	getCustomFieldSearcherClass(String key) Retrieve a custom field searcher by its type key.
List	getCustomFieldSearchers(CustomFieldType customFieldType) Retrieves all the searchers registered for a particular custom Field.
Set<CustomField>	getCustomFieldsWithValue(Issue issue) Returns a set of CustomFields that have value stored in database for particular issue.
CustomFieldType	getCustomFieldType(String key) Retrieve a custom field type by its type key.
List	getCustomFieldTypes() Retrieve all customfieldtypes registered in the system.
CustomFieldSearcher	getDefaultSearcher(CustomFieldType<?,?> type) Return the default CustomFieldSearcher for the passed CustomFieldType.
List	getGlobalCustomFieldObjects() Returns a list of custom fields where the CustomField.isGlobal() is true.
boolean	isCustomField(String id) Returns true if this ID is in the Custom Field format.
void	refresh() reloads all customfields into the cache from the DB, this is an expensive operation, so avoid it if you can.
void	refreshConfigurationSchemes(Long customFieldId) Causes a reload of the field configuration scheme for a specified custom field id Call when the configuration scheme changes
void	removeCustomField(CustomField customField) Removes the customfield supplied including all associations and values.
void	removeCustomFieldPossiblyLeavingOrphanedData(Long id) Removes the customfield supplied.
void	removeCustomFieldValues(org.ofbiz.core.entity.GenericValue genericValue) Removes the values stored by customfields for a particular Issue.
void	removeProjectAssociations(Project project) Used if a project is deleted to remove the project field associations.
void	updateCustomField(Long id, String name, String description, CustomFieldSearcher searcher) Updates the given custom field.

Methods inherited from class java.lang.Object

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

Constructor Detail

MockCustomFieldManager

public MockCustomFieldManager()

Method Detail

getCustomFieldObjects

public List getCustomFieldObjects(SearchContext searchContext)

Description copied from interface: CustomFieldManager

Returns all customfields in a particular SearchContext. Also see CustomField.isInScope(com.atlassian.jira.issue.search.SearchContext).

Specified by:

getCustomFieldObjects in interface CustomFieldManager

Parameters:

searchContext - the SearchContext

Returns:

A list of CustomFields

getCustomFieldSearcherClass

public Class getCustomFieldSearcherClass(String key)

Description copied from interface: CustomFieldManager

Retrieve a custom field searcher by its type key.

The key is the "full plugin module key". That is, the plugin key for the plugin it comes from, a colon separator, and then the module key. e.g. the system types are specified in system-customfieldtypes-plugin.xml:

 <atlassian-plugin key="com.atlassian.jira.plugin.system.customfieldtypes" name="Custom Field Types & Searchers">
     ...
     <customfield-type key="float" name="Number Field"
     ...
 

To access the 'Number Field' type, the key would then be 'com.atlassian.jira.plugin.system.customfieldtypes:float'.

Specified by:

getCustomFieldSearcherClass in interface CustomFieldManager

Parameters:

key - Type identifier constructed from plugin XML.

refreshConfigurationSchemes

public void refreshConfigurationSchemes(Long customFieldId)

Description copied from interface: CustomFieldManager

Causes a reload of the field configuration scheme for a specified custom field id Call when the configuration scheme changes

Specified by:

refreshConfigurationSchemes in interface CustomFieldManager

Parameters:

customFieldId - the custom field ID

removeProjectAssociations

public void removeProjectAssociations(Project project)

Description copied from interface: CustomFieldManager

Used if a project is deleted to remove the project field associations.

Specified by:

removeProjectAssociations in interface CustomFieldManager

Parameters:

project - The project being deleted.

removeCustomField

public void removeCustomField(CustomField customField)

Description copied from interface: CustomFieldManager

Removes the customfield supplied including all associations and values.

Specified by:

removeCustomField in interface CustomFieldManager

Parameters:

customField - The CustomField to be removed.

updateCustomField

public void updateCustomField(Long id,
                              String name,
                              String description,
                              CustomFieldSearcher searcher)

Description copied from interface: CustomFieldManager

Updates the given custom field.

Specified by:

updateCustomField in interface CustomFieldManager

Parameters:

id - the custom field ID

name - the new name

description - the new description

searcher - the new Searcher

removeCustomFieldValues

public void removeCustomFieldValues(org.ofbiz.core.entity.GenericValue genericValue)
                             throws org.ofbiz.core.entity.GenericEntityException

Description copied from interface: CustomFieldManager

Removes the values stored by customfields for a particular Issue.

Specified by:

removeCustomFieldValues in interface CustomFieldManager

Parameters:

genericValue - The issue GenericValue

Throws:

org.ofbiz.core.entity.GenericEntityException - DB error

getCustomFieldsWithValue

@Nonnull
public Set<CustomField> getCustomFieldsWithValue(@Nonnull
                                                          Issue issue)

Description copied from interface: CustomFieldManager

Returns a set of CustomFields that have value stored in database for particular issue.

Specified by:

getCustomFieldsWithValue in interface CustomFieldManager

Parameters:

issue - An Issue object

Returns:

A set of CustomFields

getCustomFieldObject

@Nullable
public CustomField getCustomFieldObject(Long id)

Description copied from interface: CustomFieldManager

Get a CustomField by ID.

Specified by:

getCustomFieldObject in interface CustomFieldManager

Parameters:

id - ID of field, eg. 10000

Returns:

The CustomField or null.

exists

public boolean exists(String id)

Description copied from interface: CustomFieldManager

Returns true if this customfield actually exists. This saves unnecessary copying of custom field objects when all we want to know is "does it exist"

Specified by:

exists in interface CustomFieldManager

Parameters:

id - Eg. 'customfield_10000'

Returns:

true if the custom field is returned

See Also:

CustomFieldManager.isCustomField(String)

getCustomFieldObject

@Nullable
public CustomField getCustomFieldObject(String id)

Description copied from interface: CustomFieldManager

Get a CustomField by its text key (eg 'customfield_10000').

Specified by:

getCustomFieldObject in interface CustomFieldManager

Parameters:

id - Eg. 'customfield_10000'

Returns:

The CustomField or null if not found.

isCustomField

public boolean isCustomField(String id)

Description copied from interface: CustomFieldManager

Returns true if this ID is in the Custom Field format.

Note that this does not check if the Custom Field actually exists. It just checks whether the given ID looks like Custom Field ID (eg starts with "customfield_").

Specified by:

isCustomField in interface CustomFieldManager

Parameters:

id - The Field ID

Returns:

true if this is an ID for a Custom Field.

See Also:

CustomFieldManager.exists(String)

getCustomFieldObjects

public List getCustomFieldObjects()

Description copied from interface: CustomFieldManager

Returns all custom fields.

Specified by:

getCustomFieldObjects in interface CustomFieldManager

Returns:

A list of all CustomFields.

getGlobalCustomFieldObjects

public List getGlobalCustomFieldObjects()

Description copied from interface: CustomFieldManager

Returns a list of custom fields where the CustomField.isGlobal() is true.

Specified by:

getGlobalCustomFieldObjects in interface CustomFieldManager

Returns:

A list of CustomFields

refresh

public void refresh()

Description copied from interface: CustomFieldManager

reloads all customfields into the cache from the DB, this is an expensive operation, so avoid it if you can.

Specified by:

refresh in interface CustomFieldManager

clear

public void clear()

Description copied from interface: CustomFieldManager

clear the cache

Specified by:

clear in interface CustomFieldManager

getCustomFieldObjects

public List getCustomFieldObjects(Long projectId,
                                  String issueType)

Description copied from interface: CustomFieldManager

Gets a list of custom fields for a particular project and issue type.

Specified by:

getCustomFieldObjects in interface CustomFieldManager

Parameters:

projectId - Id of the project

issueType - An issue type. See ConstantsManager.ALL_ISSUE_TYPES, ConstantsManager.ALL_STANDARD_ISSUE_TYPES and ConstantsManager.ALL_SUB_TASK_ISSUE_TYPES

Returns:

A list of CustomFields

getCustomFieldObjects

public List getCustomFieldObjects(Long projectId,
                                  List issueTypes)

Description copied from interface: CustomFieldManager

Returns the same as CustomFieldManager.getCustomFieldObjects(Long, String) but allows to specify a list of issueTypes.

Specified by:

getCustomFieldObjects in interface CustomFieldManager

Parameters:

projectId - Id of the project. It can be null, in which case means that we are looking for "any project" (acts like a wildcard).

issueTypes - A list of issue types. It can be null or empty, in which case means that we are looking for "any issue type" (acts like a wildcard). See ConstantsManager.ALL_ISSUE_TYPES, ConstantsManager.ALL_STANDARD_ISSUE_TYPES and ConstantsManager.ALL_SUB_TASK_ISSUE_TYPES

Returns:

A list of CustomFields

See Also:

CustomField#isInScopeForSearch(com.atlassian.jira.project.Project, java.util.List)} for a full description on how wildcards are treated.

getCustomFieldObjects

public List getCustomFieldObjects(org.ofbiz.core.entity.GenericValue issue)

Description copied from interface: CustomFieldManager

Returns a list of CustomFields that apply to a particular issue.

Specified by:

getCustomFieldObjects in interface CustomFieldManager

Parameters:

issue - A GenericValue of the issue

Returns:

A list of CustomFields

getCustomFieldObjects

public List getCustomFieldObjects(Issue issue)

Description copied from interface: CustomFieldManager

Returns a list of CustomFields that apply to a particular issue.

Specified by:

getCustomFieldObjects in interface CustomFieldManager

Parameters:

issue - A Issue object

Returns:

A list of CustomFields

getCustomFieldTypes

@Nonnull
public List getCustomFieldTypes()

Description copied from interface: CustomFieldManager

Retrieve all customfieldtypes registered in the system.

Specified by:

getCustomFieldTypes in interface CustomFieldManager

Returns:

a list of CustomFieldTypes

getCustomFieldType

public CustomFieldType getCustomFieldType(String key)

Description copied from interface: CustomFieldManager

Retrieve a custom field type by its type key.

The key is the "full plugin module key". That is, the plugin key for the plugin it comes from, a colon separator, and then the module key. e.g. the system types are specified in system-customfieldtypes-plugin.xml:

 <atlassian-plugin key="com.atlassian.jira.plugin.system.customfieldtypes" name="Custom Field Types & Searchers">
     ...
     <customfield-type key="float" name="Number Field"
     ...
 

To access the 'Number Field' type, the key would then be 'com.atlassian.jira.plugin.system.customfieldtypes:float'.

Specified by:

getCustomFieldType in interface CustomFieldManager

Parameters:

key - Type identifier constructed from plugin XML.

Returns:

the CustomFieldType for the given key

addCustomFieldType

public void addCustomFieldType(String key,
                               CustomFieldType customFieldType)

getCustomFieldSearchers

@Nonnull
public List getCustomFieldSearchers(CustomFieldType customFieldType)

Description copied from interface: CustomFieldManager

Retrieves all the searchers registered for a particular custom Field. Searchers may be registred via:

   <customfield-searcher key="daterange" name="Date Range picker"
                     i18n-name-key="admin.customfield.searcher.daterange.name"
                     class="com.atlassian.jira.issue.customfields.searchers.DateRangeSearcher">
 

Specified by:

getCustomFieldSearchers in interface CustomFieldManager

Parameters:

customFieldType - the CustomFieldType

Returns:

A list of CustomFieldSearchers

getCustomFieldSearcher

public CustomFieldSearcher getCustomFieldSearcher(String key)

Description copied from interface: CustomFieldManager

Retrieve a custom field searcher by its type key.

The key is the "full plugin module key". That is, the plugin key for the plugin it comes from, a colon separator, and then the module key. e.g. the system types are specified in system-customfieldtypes-plugin.xml:

 <atlassian-plugin key="com.atlassian.jira.plugin.system.customfieldtypes" name="Custom Field Types & Searchers">
     ...
     <customfield-type key="float" name="Number Field"
     ...
 

To access the 'Number Field' type, the key would then be 'com.atlassian.jira.plugin.system.customfieldtypes:float'.

Specified by:

getCustomFieldSearcher in interface CustomFieldManager

Parameters:

key - Type identifier constructed from plugin XML.

Returns:

the CustomFieldSearcher for the given key

getDefaultSearcher

@Nullable
public CustomFieldSearcher getDefaultSearcher(@Nonnull
                                                        CustomFieldType<?,?> type)

Description copied from interface: CustomFieldManager

Return the default CustomFieldSearcher for the passed CustomFieldType. The default searcher can be null if there is no searcher associated with the type.

Specified by:

getDefaultSearcher in interface CustomFieldManager

Parameters:

type - the CustomFieldType to query.

Returns:

the default searcher for the passed CustomFieldType. Can be null if the type has no associated searcher.

addCustomField

public void addCustomField(CustomField customField)

getCustomFieldObjectByName

public CustomField getCustomFieldObjectByName(String customFieldName)

Description copied from interface: CustomFieldManager

Retrieve the first custom field object with the specified name. WARNING: Custom Field names are no longer guaranteed to be unique. This method returns the first named custom field. Use CustomFieldManager.getCustomFieldObjectsByName(String) to retrieve all custom fields.

Specified by:

getCustomFieldObjectByName in interface CustomFieldManager

Parameters:

customFieldName - the Name

Returns:

The first named CustomField, or null if not found.

getCustomFieldObjectsByName

public Collection getCustomFieldObjectsByName(String customFieldName)

Description copied from interface: CustomFieldManager

Retrieve custom field(s) of a certain name.

Specified by:

getCustomFieldObjectsByName in interface CustomFieldManager

Parameters:

customFieldName - custom field name

Returns:

A collection of CustomFields.

getCustomFieldObjectsByNameIgnoreCase

public Collection<CustomField> getCustomFieldObjectsByNameIgnoreCase(String customFieldName)

Description copied from interface: CustomFieldManager

Retrieve custom field(s) of a certain name ignoring case.

Specified by:

getCustomFieldObjectsByNameIgnoreCase in interface CustomFieldManager

Parameters:

customFieldName - custom field name

Returns:

A collection of CustomFields.

createCustomField

public CustomField createCustomField(String fieldName,
                                     String description,
                                     CustomFieldType fieldType,
                                     CustomFieldSearcher customFieldSearcher,
                                     List contexts,
                                     List issueTypes)
                              throws org.ofbiz.core.entity.GenericEntityException

Description copied from interface: CustomFieldManager

Creates a custom field with the given name and description of the given CustomFieldType using the given CustomFieldSearcher that is displayed in the given list of contexts available to the given list of issueTypes.

Specified by:

createCustomField in interface CustomFieldManager

Returns:

the newly created CustomField.

Throws:

org.ofbiz.core.entity.GenericEntityException - if the CustomField could not be created.

removeCustomFieldPossiblyLeavingOrphanedData

public void removeCustomFieldPossiblyLeavingOrphanedData(Long id)
                                                  throws RemoveException

Description copied from interface: CustomFieldManager

Removes the customfield supplied. This method will try to lookup the customfield object via the manager first. If the customfield object can be retrieved this way, it simply delegates the removal to the CustomFieldManager.removeCustomField(com.atlassian.jira.issue.fields.CustomField) method, which will not leave any orphaned data behind.

NOTE: Generally you should use the CustomFieldManager.removeCustomField(com.atlassian.jira.issue.fields.CustomField) method to remove a custom field, as it is guaranteed to remove all data. This method should only be used if a customfield needs to be removed when the customfieldtype for that field is no longer available!

If however the customfield object cannot be retrieved via the manager, which may be the case if the custom field type is no longer available (a plugin may have been removed), then this method will try to lookup the custom field directly in the database. If it doesn't exist in the database, an IllegalArgumentException will be thrown. Otherwise, the customfield and all associated configurations will be removed. This method will also call to the CustomFieldValuePersister.removeAllValues(String) method to delete any values. Please note however, that if your custom field stores any other values (such as options for example), they will have to be removed by the caller of this method, as the custom field type is not accessible (which is usually responsible for removing such values).

Specified by:

removeCustomFieldPossiblyLeavingOrphanedData in interface CustomFieldManager

Parameters:

id - The id of the customField to be removed.

Throws:

RemoveException - On any error removing the custom field

getCustomFieldInstance

public CustomField getCustomFieldInstance(org.ofbiz.core.entity.GenericValue customFieldGv)

Description copied from interface: CustomFieldManager

Converts a customfield GenericValue to a CustomField instance.

Specified by:

getCustomFieldInstance in interface CustomFieldManager

Returns:

a CustomField instance