com.atlassian.greenhopper.customfield
Interface CustomFieldService

All Known Implementing Classes:

CustomFieldServiceImpl

public interface CustomFieldService

Service for encapsulating custom field logic, especially the rather complex JIRA logic behind creating and working with these things.

Author:

ahennecke

Field Summary

static java.lang.String

SERVICE

Method Summary

void	associateWithDefaultScreen(com.atlassian.jira.issue.fields.CustomField customField) Associate the custom field with the "Default Screen".
com.atlassian.jira.issue.fields.CustomField	createCustomField(CustomFieldMetadata fieldMetadata) Create a new custom field in JIRA with the given configuration
com.atlassian.jira.issue.fields.CustomField	getCustomField(java.lang.Long id)
com.atlassian.jira.issue.fields.CustomField	getCustomField(java.lang.String id)
<T extends com.atlassian.jira.issue.customfields.CustomFieldType> java.util.List<com.atlassian.jira.issue.fields.CustomField>	getCustomFields(java.lang.Class<T> type) Return all custom field instances which are of type T (but not sub-classes).
<T extends com.atlassian.jira.issue.customfields.CustomFieldType> java.util.List<com.atlassian.jira.issue.fields.CustomField>	getCustomFields(java.lang.Class<T> type, boolean strict) Return all custom field instances which are of type T, or a subclass of T.
boolean	isFieldApplicable(com.atlassian.jira.issue.fields.CustomField customField, com.atlassian.jira.issue.Issue issue) Determine whether the given custom field is applicable for (i.e.
boolean	isFieldApplicable(com.atlassian.jira.issue.fields.CustomField customField, java.lang.Long projectId, java.lang.String issueTypeId) Determine whether the given custom field is applicable for (i.e.
boolean	isSystemFieldName(java.lang.String fieldName) Check whether the passed field name matches a system field name (as used by JQL)
boolean	isUniqueFieldName(com.atlassian.jira.issue.fields.CustomField customField) Has the custom field a unique name? Used whenever creating JQL to decide whether to use the name or the id of the field
void	removeCustomField(com.atlassian.jira.issue.fields.CustomField customField) Removes the custom field and all associated data.

Field Detail

SERVICE

static final java.lang.String SERVICE

See Also:

Constant Field Values

Method Detail

createCustomField

com.atlassian.jira.issue.fields.CustomField createCustomField(CustomFieldMetadata fieldMetadata)

Create a new custom field in JIRA with the given configuration

getCustomField

com.atlassian.jira.issue.fields.CustomField getCustomField(java.lang.Long id)

Returns:

the CustomField instance for the given ID, or null if it doesn't exist

getCustomField

com.atlassian.jira.issue.fields.CustomField getCustomField(java.lang.String id)

Returns:

the CustomField instance for the given String ID, or null if it doesn't exist

getCustomFields

<T extends com.atlassian.jira.issue.customfields.CustomFieldType> java.util.List<com.atlassian.jira.issue.fields.CustomField> getCustomFields(java.lang.Class<T> type)

Return all custom field instances which are of type T (but not sub-classes).

Type Parameters:

T - the CustomFieldType to check for. Equality checking is done on the custom field's type.

Parameters:

type - the type to retrieve

Returns:

the list of custom fields; never null

getCustomFields

<T extends com.atlassian.jira.issue.customfields.CustomFieldType> java.util.List<com.atlassian.jira.issue.fields.CustomField> getCustomFields(java.lang.Class<T> type,
                                                                                                                                              boolean strict)

Return all custom field instances which are of type T, or a subclass of T.

Type Parameters:

T - the CustomFieldType to check for. Equality checking is done on the custom field's type.

Parameters:

type - the type to retrieve

strict - set to true to do a strict equality check on the specified type.

Returns:

the list of custom fields; never null

associateWithDefaultScreen

void associateWithDefaultScreen(com.atlassian.jira.issue.fields.CustomField customField)

Associate the custom field with the "Default Screen". Note that the first screen tab found will be used.

removeCustomField

void removeCustomField(com.atlassian.jira.issue.fields.CustomField customField)

Removes the custom field and all associated data. Note that this requires the custom field to be fully recognisable in JIRA's current state (i.e. the CustomFieldType for this object must still be available).

Parameters:

customField - the custom field object

See Also:

CustomFieldManager.removeCustomField(com.atlassian.jira.issue.fields.CustomField)

isUniqueFieldName

boolean isUniqueFieldName(com.atlassian.jira.issue.fields.CustomField customField)

Has the custom field a unique name? Used whenever creating JQL to decide whether to use the name or the id of the field

isSystemFieldName

boolean isSystemFieldName(java.lang.String fieldName)

Check whether the passed field name matches a system field name (as used by JQL)

isFieldApplicable

boolean isFieldApplicable(com.atlassian.jira.issue.fields.CustomField customField,
                          com.atlassian.jira.issue.Issue issue)

Determine whether the given custom field is applicable for (i.e. configured for the context of) the specified issue.

Parameters:

customField - the field

issue - the issue

Returns:

whether or not the field is applicable

isFieldApplicable

boolean isFieldApplicable(com.atlassian.jira.issue.fields.CustomField customField,
                          java.lang.Long projectId,
                          java.lang.String issueTypeId)

Determine whether the given custom field is applicable for (i.e. configured for the context of) the specified project and issue type.

Parameters:

customField - the field

projectId - the project the issue is in

issueTypeId - the issue type of the issue

Returns:

whether or not the field is applicable