com.atlassian.jira.config
Interface ConstantsManager

All Known Implementing Classes:
DefaultConstantsManager

public interface ConstantsManager

Manager for issue types, statuses, priorities and resolutions. This manager is responsible for caching these constants as well as all the usual update, delete, add operations in the database.


Field Summary
static String ALL_ISSUE_TYPES
          Used to retrieve all IssueTypes.
static String ALL_STANDARD_ISSUE_TYPES
          Used to retrieve a standard IssueTypes.
static String ALL_SUB_TASK_ISSUE_TYPES
          Used to retrieve a subtask IssueTypes.
static String ISSUE_TYPE_CONSTANT_TYPE
          Used in the generic getConstant(String, String) method
static String PRIORITY_CONSTANT_TYPE
          Used in the generic getConstant(String, String) method
static String RESOLUTION_CONSTANT_TYPE
          Used in the generic getConstant(String, String) method
static String STATUS_CONSTANT_TYPE
          Used in the generic getConstant(String, String) method
 
Method Summary
 boolean constantExists(String constantType, String name)
          Checks if a constant exists.
 List convertToConstantObjects(String constantType, Collection ids)
          Converts the list of ids to the objects of appropriate types
 org.ofbiz.core.entity.GenericValue createIssueType(String name, Long sequence, String style, String description, String iconurl)
          Note this metod does not validate the input - i.e.
 List expandIssueTypeIds(Collection issueTypeIds)
          Converts the 'special' ids of issue types to a list of issue type ids For example, converts a special id to a list of all sub-task issue types Also see ALL_STANDARD_ISSUE_TYPES, ALL_SUB_TASK_ISSUE_TYPES and ALL_ISSUE_TYPES.
 List getAllIssueTypeIds()
          Returns all issueType Ids.
 Collection getAllIssueTypeObjects()
          Returns a list of IssueTypes.
 List getAllIssueTypes()
          Returns a list of IssueTypes.
 org.ofbiz.core.entity.GenericValue getConstant(String constantType, String id)
          Generic method to retrieve a particular constant type.
 org.ofbiz.core.entity.GenericValue getConstantByName(String constantType, String name)
          Returns a constant by name.
 IssueConstant getConstantObject(String constantType, String id)
          Returns an IssueConstant object for the given type & id.
 Collection getConstantObjects(String constantType)
          Returns all IssueConstant objects for the given type.
 org.ofbiz.core.entity.GenericValue getDefaultPriority()
          Returns the default priority configured in JIRA.
 List getEditableSubTaskIssueTypes()
          Retrieves an editable list of sub-task issues.
 IssueConstant getIssueConstant(org.ofbiz.core.entity.GenericValue issueConstantGV)
          Converts a constant GenericValue to an IssueConstant object.
 org.ofbiz.core.entity.GenericValue getIssueType(String id)
          Deprecated. Use getIssueTypeObject(String) instead
 IssueType getIssueTypeObject(String id)
          Given an issueType ID this method retrieves that issueType.
 Collection getIssueTypes()
          Deprecated. Use getRegularIssueTypeObjects() instead.
 Collection getPriorities()
          Deprecated. Use getPriorityObjects() instead
 org.ofbiz.core.entity.GenericValue getPriority(String id)
          Deprecated. Use getPriorityObject(String) instead.
 String getPriorityName(String id)
          Returns the priority Name for a given priority ID.
 Priority getPriorityObject(String id)
          Given a priority ID, this method retrieves that priority.
 Collection getPriorityObjects()
          Retrieve all Priorities in JIRA.
 Collection getRegularIssueTypeObjects()
          Retrieve regular (non-subtask) issue types.
 org.ofbiz.core.entity.GenericValue getResolution(String id)
          Deprecated. Use getResolutionObject(String) instead.
 Resolution getResolutionObject(String id)
          Given a resolution ID, this method retrieves that resolution.
 Collection getResolutionObjects()
          Retrieve all Resolutions in JIRA.
 Collection getResolutions()
          Deprecated. Use getResolutionObjects() instead.
 org.ofbiz.core.entity.GenericValue getStatus(String id)
          Returns a Status given an id.
 Status getStatusByName(String name)
          Searches for a given status by name.
 Collection getStatuses()
          Returns all statuses
 Status getStatusObject(String id)
          Returns a Status given an id.
 Collection getStatusObjects()
          Returns all statuses
 Collection getSubTaskIssueTypeObjects()
          Retrieves all the sub-task issue types
 Collection getSubTaskIssueTypes()
          Retrieves all the sub-task issue types.
 void refresh()
          Sets all cached copies of constant to null.
 void refreshIssueTypes()
          Reloads all IssueTypes from the DB.
 void refreshPriorities()
          Reloads all priorities from the DB.
 void refreshResolutions()
          Reloads all resolutions from the DB.
 void refreshStatuses()
          Reloads all statuses from DB.
 void removeIssueType(String id)
          Removes an existing issueType.
 void storeIssueTypes(List issueTypes)
          Bulk operation to store a list of issueTypes.
 void updateIssueType(String id, String name, Long sequence, String style, String description, String iconurl)
          Updates an existing issueType.
 void validateCreateIssueType(String name, String style, String description, String iconurl, ErrorCollection errors, String nameFieldName)
          Validates creation of a new issuetype.
 

Field Detail

ALL_STANDARD_ISSUE_TYPES

static final String ALL_STANDARD_ISSUE_TYPES
Used to retrieve a standard IssueTypes.

See Also:
Constant Field Values

ALL_SUB_TASK_ISSUE_TYPES

static final String ALL_SUB_TASK_ISSUE_TYPES
Used to retrieve a subtask IssueTypes.

See Also:
Constant Field Values

ALL_ISSUE_TYPES

static final String ALL_ISSUE_TYPES
Used to retrieve all IssueTypes.

See Also:
Constant Field Values

PRIORITY_CONSTANT_TYPE

static final String PRIORITY_CONSTANT_TYPE
Used in the generic getConstant(String, String) method

See Also:
Constant Field Values

STATUS_CONSTANT_TYPE

static final String STATUS_CONSTANT_TYPE
Used in the generic getConstant(String, String) method

See Also:
Constant Field Values

RESOLUTION_CONSTANT_TYPE

static final String RESOLUTION_CONSTANT_TYPE
Used in the generic getConstant(String, String) method

See Also:
Constant Field Values

ISSUE_TYPE_CONSTANT_TYPE

static final String ISSUE_TYPE_CONSTANT_TYPE
Used in the generic getConstant(String, String) method

See Also:
Constant Field Values
Method Detail

getPriorities

Collection getPriorities()
Deprecated. Use getPriorityObjects() instead

Retrieve all Priorities in JIRA.

Returns:
A list of Priority GenericValues.

getPriorityObjects

Collection getPriorityObjects()
Retrieve all Priorities in JIRA.

Returns:
A list of Prioritys.

getPriority

org.ofbiz.core.entity.GenericValue getPriority(String id)
Deprecated. Use getPriorityObject(String) instead.

Given a priority ID, this method retrieves that priority.

Parameters:
id - The id of the priority
Returns:
A Priority GenericValue

getPriorityObject

Priority getPriorityObject(String id)
Given a priority ID, this method retrieves that priority.

Parameters:
id - The id of the priority
Returns:
A Priority object.

getPriorityName

String getPriorityName(String id)
Returns the priority Name for a given priority ID.

Parameters:
id - The id of a priority
Returns:
The name of the priority with the given ID, or an i18n'd String indicating that no priority is set (e.g. "None") if the ID is null.

getDefaultPriority

org.ofbiz.core.entity.GenericValue getDefaultPriority()
Returns the default priority configured in JIRA.

Returns:
The default priority GenericValue.

refreshPriorities

void refreshPriorities()
Reloads all priorities from the DB.


getResolutions

Collection getResolutions()
Deprecated. Use getResolutionObjects() instead.

Retrieve all Resolutions in JIRA.

Returns:
A List of Resolution GenericValues.

getResolutionObjects

Collection getResolutionObjects()
Retrieve all Resolutions in JIRA.

Returns:
A List of Resolution objects.

getResolution

org.ofbiz.core.entity.GenericValue getResolution(String id)
Deprecated. Use getResolutionObject(String) instead.

Given a resolution ID, this method retrieves that resolution.

Parameters:
id - The id of the resolution
Returns:
A resolution GenericValue

getResolutionObject

Resolution getResolutionObject(String id)
Given a resolution ID, this method retrieves that resolution.

Parameters:
id - The id of the resolution
Returns:
A Resolution object.

refreshResolutions

void refreshResolutions()
Reloads all resolutions from the DB.


getIssueTypes

Collection getIssueTypes()
Deprecated. Use getRegularIssueTypeObjects() instead.

Retrieve regular (non-subtask) issue types.

Returns:
A collection of IssueType GenericValues

getRegularIssueTypeObjects

Collection getRegularIssueTypeObjects()
Retrieve regular (non-subtask) issue types.

Returns:
A collection of IssueTypes

getIssueType

org.ofbiz.core.entity.GenericValue getIssueType(String id)
Deprecated. Use getIssueTypeObject(String) instead

Given an issueType ID this method retrieves that issueType.

Parameters:
id - The ID of the IssueType.
Returns:
An issueType GenericValue

getIssueTypeObject

IssueType getIssueTypeObject(String id)
Given an issueType ID this method retrieves that issueType.

Parameters:
id - The ID of the IssueType.
Returns:
An IssueType object

refreshIssueTypes

void refreshIssueTypes()
Reloads all IssueTypes from the DB.


createIssueType

org.ofbiz.core.entity.GenericValue createIssueType(String name,
                                                   Long sequence,
                                                   String style,
                                                   String description,
                                                   String iconurl)
                                                   throws CreateException
Note this metod does not validate the input - i.e. It does not check for duplicate names etc. Use this method in conjunction with validateCreateIssueType(String, String, String, String, com.atlassian.jira.util.ErrorCollection, String)

Parameters:
name - Name of the new IssueType
sequence - Sequence number used for ordering the issuetypes in the UI.
style - Used to record the type of issue, such as SUBTASK. Null for regular issues.
description - A short description of the new issue type.
iconurl - A URL to an icon to be used for the new issueType.
Throws:
CreateException

validateCreateIssueType

void validateCreateIssueType(String name,
                             String style,
                             String description,
                             String iconurl,
                             ErrorCollection errors,
                             String nameFieldName)
Validates creation of a new issuetype. In particular, this function checks that a name has been submitted, no other issueTypes with the same name exist, and that the icon URL exists.

Parameters:
name - Name of the new IssueType
style - Used to record the type of issue, such as SUBTASK. Null for regular issues.
description - A short description of the new issue type.
iconurl - A URL to an icon to be used for the new issueType.
errors - A collection of errors used to pass back any problems.
nameFieldName - The field to which the errors should be added.

updateIssueType

void updateIssueType(String id,
                     String name,
                     Long sequence,
                     String style,
                     String description,
                     String iconurl)
                     throws StoreException
Updates an existing issueType. This will cause a refresh of all issue types (i.e. reload from the DB).

Parameters:
id - ID of the existing issuetype.
name - Name of the new IssueType
sequence - Sequence number used for ordering the issuetypes in the UI.
style - Used to record the type of issue, such as SUBTASK. Null for regular issues.
description - A short description of the new issue type.
iconurl - A URL to an icon to be used for the new issueType.
Throws:
StoreException

removeIssueType

void removeIssueType(String id)
                     throws RemoveException
Removes an existing issueType. This will cause a refresh of all issue types (i.e. reload from the DB).

Parameters:
id - ID of an existing issueType
Throws:
RemoveException - if the issueType with id doesn't exist, or an error occured removing the issue.

storeIssueTypes

void storeIssueTypes(List issueTypes)
                     throws StoreException
Bulk operation to store a list of issueTypes.

Parameters:
issueTypes - A list of IssueType GenericValues
Throws:
StoreException

getAllIssueTypes

List getAllIssueTypes()
Returns a list of IssueTypes.

Returns:
A list of GenericValue issueTypes.

getAllIssueTypeObjects

Collection getAllIssueTypeObjects()
Returns a list of IssueTypes.

Returns:
A Collection of IssueType objects.

expandIssueTypeIds

List expandIssueTypeIds(Collection issueTypeIds)
Converts the 'special' ids of issue types to a list of issue type ids For example, converts a special id to a list of all sub-task issue types Also see ALL_STANDARD_ISSUE_TYPES, ALL_SUB_TASK_ISSUE_TYPES and ALL_ISSUE_TYPES.

Parameters:
issueTypeIds - A collection of the issuetype Ids to retrieve.

getAllIssueTypeIds

List getAllIssueTypeIds()
Returns all issueType Ids.

Returns:
A list of all the IssueType Ids.

getStatus

org.ofbiz.core.entity.GenericValue getStatus(String id)
Returns a Status given an id.

Parameters:
id - The id of a status
Returns:
Returns a status GenericValue

getStatusObject

Status getStatusObject(String id)
Returns a Status given an id.

Parameters:
id - The id of a status
Returns:
Returns a Status object.

getStatuses

Collection getStatuses()
Returns all statuses

Returns:
Returns a Collection of status GenericValues.

getStatusObjects

Collection getStatusObjects()
Returns all statuses

Returns:
Returns a Collection of Status objects

refreshStatuses

void refreshStatuses()
Reloads all statuses from DB.


getStatusByName

Status getStatusByName(String name)
Searches for a given status by name. This is not the most efficient implementation. If the name is not found, or the given name is null, then it returns null.

Parameters:
name - The name of the status.
Returns:
A Status object with the given name, or null if none found.

getSubTaskIssueTypes

Collection getSubTaskIssueTypes()
Retrieves all the sub-task issue types. These will be non-modifiable. Use getEditableSubTaskIssueTypes() instead if you require an editable list.

Returns:
A Collection of sub-task GenericValues.

getSubTaskIssueTypeObjects

Collection getSubTaskIssueTypeObjects()
Retrieves all the sub-task issue types

Returns:
A Collection of all sub-task IssueTypes.

getEditableSubTaskIssueTypes

List getEditableSubTaskIssueTypes()
Retrieves an editable list of sub-task issues.

Returns:
A List of editable sub-task GenericValues

getConstant

org.ofbiz.core.entity.GenericValue getConstant(String constantType,
                                               String id)
Generic method to retrieve a particular constant type.

Parameters:
constantType - See PRIORITY_CONSTANT_TYPE, STATUS_CONSTANT_TYPE, RESOLUTION_CONSTANT_TYPE, ISSUE_TYPE_CONSTANT_TYPE
id - The id of the constant.
Returns:
A GenericValue containing the constant. Null if it doesn't exist.

getConstantObject

IssueConstant getConstantObject(String constantType,
                                String id)
Returns an IssueConstant object for the given type & id.

Parameters:
constantType - See PRIORITY_CONSTANT_TYPE, STATUS_CONSTANT_TYPE, RESOLUTION_CONSTANT_TYPE, ISSUE_TYPE_CONSTANT_TYPE
id - The id of the constant.
Returns:
A IssueConstant object. Null if it doesn't exist.

getConstantObjects

Collection getConstantObjects(String constantType)
Returns all IssueConstant objects for the given type.

Parameters:
constantType - See PRIORITY_CONSTANT_TYPE, STATUS_CONSTANT_TYPE, RESOLUTION_CONSTANT_TYPE, ISSUE_TYPE_CONSTANT_TYPE
Returns:
A collection of IssueConstant object.

convertToConstantObjects

List convertToConstantObjects(String constantType,
                              Collection ids)
Converts the list of ids to the objects of appropriate types

Parameters:
constantType - the constant type. Case insenstive
ids - list of constant ids or GenericValues
Returns:
List of IssueConstant subclasses. Null if constantType is null or the ids are empty

constantExists

boolean constantExists(String constantType,
                       String name)
Checks if a constant exists.

Parameters:
constantType - See PRIORITY_CONSTANT_TYPE, STATUS_CONSTANT_TYPE, RESOLUTION_CONSTANT_TYPE, ISSUE_TYPE_CONSTANT_TYPE
name - The name of the constant.
Returns:
True if the constant exists. False otherwise

getConstantByName

org.ofbiz.core.entity.GenericValue getConstantByName(String constantType,
                                                     String name)
Returns a constant by name.

Parameters:
constantType - See PRIORITY_CONSTANT_TYPE, STATUS_CONSTANT_TYPE, RESOLUTION_CONSTANT_TYPE, ISSUE_TYPE_CONSTANT_TYPE
name - The Name of the constant.
Returns:
A constant GenericValue

getIssueConstant

IssueConstant getIssueConstant(org.ofbiz.core.entity.GenericValue issueConstantGV)
Converts a constant GenericValue to an IssueConstant object.

Parameters:
issueConstantGV - the constant GenericValue.
Returns:
An IssueConstant object.

refresh

void refresh()
Sets all cached copies of constant to null. This will cause them to be re-loaded from the DB the next time they are accessed.



Copyright © 2002-2009 Atlassian. All Rights Reserved.