com.atlassian.jira.issue.fields
Class DefaultFieldManager

java.lang.Object
  com.atlassian.jira.issue.fields.DefaultFieldManager

All Implemented Interfaces:

Startable, FieldManager

public class DefaultFieldManager
extends java.lang.Object
implements FieldManager, Startable

Field Summary

Fields inherited from interface com.atlassian.jira.issue.fields.FieldManager

CUSTOM_FIELD_PREFIX

Constructor Summary

DefaultFieldManager(com.atlassian.event.api.EventPublisher eventPublisher)

Method Summary

java.util.Set<NavigableField>	getAllAvailableNavigableFields() Returns a set of Fields that are NOT hidden in AT LEAST ONE project in the system.
java.util.Set<SearchableField>	getAllSearchableFields() Return all the searchable fields in the system.
java.util.Set<CustomField>	getAvailableCustomFields(com.opensymphony.user.User remoteUser, org.ofbiz.core.entity.GenericValue issue) Retrieves custom fields in scope for the given issue
java.util.Set<CustomField>	getAvailableCustomFields(com.opensymphony.user.User remoteUser, Issue issue) Retrieves custom fields in scope for the given issue
java.util.Set<NavigableField>	getAvailableNavigableFields(com.opensymphony.user.User remoteUser) Returns a set of Fields that are NOT hidden in AT LEAST ONE project that the remote user can see (has Permissions.BROWSE permission for).
java.util.Set<NavigableField>	getAvailableNavigableFieldsWithScope(com.opensymphony.user.User user) Gets all the available fields that the user can see, this is providing no context scope.
java.util.Set<NavigableField>	getAvailableNavigableFieldsWithScope(com.opensymphony.user.User remoteUser, QueryContext queryContext) Gets all the available fields within the defined scope of the QueryContext.
ColumnLayoutManager	getColumnLayoutManager() Deprecated. Declare your dependency and let PicoContainer resolve it instead
ConfigurableField	getConfigurableField(java.lang.String id)
CustomField	getCustomField(java.lang.String key) Get a CustomField by its text key (eg 'customfield_10000').
CustomFieldManager	getCustomFieldManager()
Field	getField(java.lang.String id) Get a field by its id.
FieldLayoutManager	getFieldLayoutManager() Deprecated. Declare your dependency and let PicoContainer resolve it instead
HideableField	getHideableField(java.lang.String id)
IssueTypeSystemField	getIssueTypeSystemField()
NavigableField	getNavigableField(java.lang.String id)
OrderableField	getOrderableField(java.lang.String id)
java.util.Set<OrderableField>	getOrderableFields()
ProjectSystemField	getProjectSystemField()
RequirableField	getRequiredField(java.lang.String id)
java.util.Set<SearchableField>	getSystemSearchableFields() Return all the searchable systems fields.
java.util.Set<Field>	getUnavailableFields()
boolean	isCustomField(Field field)
boolean	isCustomField(java.lang.String key)
boolean	isFieldHidden(com.opensymphony.user.User remoteUser, Field field) Determines whether the field is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).
boolean	isFieldHidden(com.opensymphony.user.User remoteUser, java.lang.String fieldId) Determines whether the field with id of fieldId is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).
boolean	isHideableField(Field field)
boolean	isHideableField(java.lang.String id)
boolean	isMandatoryField(Field field)
boolean	isMandatoryField(java.lang.String id)
boolean	isNavigableField(Field field)
boolean	isNavigableField(java.lang.String id)
boolean	isOrderableField(Field field)
boolean	isOrderableField(java.lang.String id)
boolean	isRenderableField(Field field)
boolean	isRenderableField(java.lang.String id)
boolean	isRequirableField(Field field)
boolean	isRequirableField(java.lang.String id)
protected boolean	isSubTasksOn()
boolean	isTimeTrackingOn()
boolean	isUnscreenableField(Field field)
boolean	isUnscreenableField(java.lang.String id)
protected boolean	isVotingOn()
void	onClearCache(ClearCacheEvent event)
void	refresh()
void	start() This method wil be called after the plugin system is fully initialised and all components added to the dependency injection framework.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultFieldManager

public DefaultFieldManager(com.atlassian.event.api.EventPublisher eventPublisher)

Method Detail

start

public void start()
           throws java.lang.Exception

Description copied from interface: Startable

This method wil be called after the plugin system is fully initialised and all components added to the dependency injection framework.

Specified by:

start in interface Startable

Throws:

java.lang.Exception - Allows implementations to throw an Exception.

onClearCache

@EventListener
public void onClearCache(ClearCacheEvent event)

getField

public Field getField(java.lang.String id)

Description copied from interface: FieldManager

Get a field by its id.

Specified by:

getField in interface FieldManager

Parameters:

id - An IssueFieldConstants constant, or custom field key (eg. "customfield_10010")

Returns:

the Field

getAllAvailableNavigableFields

public java.util.Set<NavigableField> getAllAvailableNavigableFields()
                                                             throws FieldException

Returns a set of Fields that are NOT hidden in AT LEAST ONE project in the system.

NOTE: This method is used in the Admin interface, as admins should be able to configure the default ColumnLayouts irrespective of their permissions. They should be able to see all fields that are not hidden in at least one FieldLayout in the system

Specified by:

getAllAvailableNavigableFields in interface FieldManager

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

getAvailableNavigableFields

public java.util.Set<NavigableField> getAvailableNavigableFields(com.opensymphony.user.User remoteUser)
                                                          throws FieldException

Returns a set of Fields that are NOT hidden in AT LEAST ONE project that the remote user can see (has Permissions.BROWSE permission for).

The returned set of fields contains all custom fields that are not hidden in AT LEAST one FieldLayout that the user can see.

NOTE: This method is primarily used for configuring user's ColumnLayout, as the user should be able to add any field (including custom field) to it that they can see in the system. THe scope of custom fields is ignored here as the user configures the ColumnLayout outside of scope.

Specified by:

getAvailableNavigableFields in interface FieldManager

Parameters:

remoteUser - the remote user

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

getAllSearchableFields

public java.util.Set<SearchableField> getAllSearchableFields()

Description copied from interface: FieldManager

Return all the searchable fields in the system. This set will included all defined custom fields.

Specified by:

getAllSearchableFields in interface FieldManager

Returns:

the set of all searchable fields in the system.

getSystemSearchableFields

public java.util.Set<SearchableField> getSystemSearchableFields()

Description copied from interface: FieldManager

Return all the searchable systems fields. This set will *NOT* include defined custom fields.

Specified by:

getSystemSearchableFields in interface FieldManager

Returns:

the set of all searchable systems fields defined.

getIssueTypeSystemField

public IssueTypeSystemField getIssueTypeSystemField()

Specified by:

getIssueTypeSystemField in interface FieldManager

getProjectSystemField

public ProjectSystemField getProjectSystemField()

Specified by:

getProjectSystemField in interface FieldManager

getAvailableNavigableFieldsWithScope

public java.util.Set<NavigableField> getAvailableNavigableFieldsWithScope(com.opensymphony.user.User user)
                                                                   throws FieldException

Description copied from interface: FieldManager

Gets all the available fields that the user can see, this is providing no context scope.

Specified by:

getAvailableNavigableFieldsWithScope in interface FieldManager

Parameters:

user - the remote user.

Returns:

a set of NavigableFields that can be show because their visibility/configuration fall within what the user can see.

Throws:

FieldException - thrown if there is a problem looking up the fields

getAvailableNavigableFieldsWithScope

public java.util.Set<NavigableField> getAvailableNavigableFieldsWithScope(com.opensymphony.user.User remoteUser,
                                                                          QueryContext queryContext)
                                                                   throws FieldException

Description copied from interface: FieldManager

Gets all the available fields within the defined scope of the QueryContext.

Specified by:

getAvailableNavigableFieldsWithScope in interface FieldManager

Parameters:

remoteUser - the user making the request

queryContext - the context of the search request.

Returns:

a set of NavigableFields that can be show because their visibility/configuration fall within the specified context

Throws:

FieldException - thrown if there is a problem looking up the fields

getAvailableCustomFields

public java.util.Set<CustomField> getAvailableCustomFields(com.opensymphony.user.User remoteUser,
                                                           org.ofbiz.core.entity.GenericValue issue)
                                                    throws FieldException

Description copied from interface: FieldManager

Retrieves custom fields in scope for the given issue

Specified by:

getAvailableCustomFields in interface FieldManager

Parameters:

remoteUser - Remote User

issue - Issue

Returns:

custom fields in scope for the given issue

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

getAvailableCustomFields

public java.util.Set<CustomField> getAvailableCustomFields(com.opensymphony.user.User remoteUser,
                                                           Issue issue)
                                                    throws FieldException

Description copied from interface: FieldManager

Retrieves custom fields in scope for the given issue

Specified by:

getAvailableCustomFields in interface FieldManager

Parameters:

remoteUser - Remote User

issue - Issue

Returns:

custom fields in scope for the given issue

Throws:

FieldException - if cannot retrieve the projects the user can see, or if cannot retrieve the field layouts for the viewable projects

isFieldHidden

public boolean isFieldHidden(com.opensymphony.user.User remoteUser,
                             java.lang.String fieldId)
                      throws FieldLayoutStorageException

Description copied from interface: FieldManager

Determines whether the field with id of fieldId is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).

Specified by:

isFieldHidden in interface FieldManager

Parameters:

remoteUser - the remote user.

fieldId - The Field ID

Throws:

FieldLayoutStorageException

isFieldHidden

public boolean isFieldHidden(com.opensymphony.user.User remoteUser,
                             Field field)
                      throws FieldLayoutStorageException

Determines whether the field is NOT hidden in AT LEAST one FieldLayout that the user can see (assigned to projects for which the user has the Permissions.BROWSE permission).

Specified by:

isFieldHidden in interface FieldManager

Parameters:

remoteUser - the remote user.

field -

Throws:

FieldLayoutStorageException

isCustomField

public boolean isCustomField(java.lang.String key)

Specified by:

isCustomField in interface FieldManager

isCustomField

public boolean isCustomField(Field field)

Specified by:

isCustomField in interface FieldManager

getCustomField

public CustomField getCustomField(java.lang.String key)

Description copied from interface: FieldManager

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

Specified by:

getCustomField in interface FieldManager

Parameters:

key - Eg. 'customfield_10000'

Returns:

The CustomField or null if not found.

isHideableField

public boolean isHideableField(java.lang.String id)

Specified by:

isHideableField in interface FieldManager

isHideableField

public boolean isHideableField(Field field)

Specified by:

isHideableField in interface FieldManager

getHideableField

public HideableField getHideableField(java.lang.String id)

Specified by:

getHideableField in interface FieldManager

isOrderableField

public boolean isOrderableField(java.lang.String id)

Specified by:

isOrderableField in interface FieldManager

isOrderableField

public boolean isOrderableField(Field field)

Specified by:

isOrderableField in interface FieldManager

getOrderableField

public OrderableField getOrderableField(java.lang.String id)

Specified by:

getOrderableField in interface FieldManager

getConfigurableField

public ConfigurableField getConfigurableField(java.lang.String id)

Specified by:

getConfigurableField in interface FieldManager

getOrderableFields

public java.util.Set<OrderableField> getOrderableFields()

Specified by:

getOrderableFields in interface FieldManager

isNavigableField

public boolean isNavigableField(java.lang.String id)

Specified by:

isNavigableField in interface FieldManager

isNavigableField

public boolean isNavigableField(Field field)

Specified by:

isNavigableField in interface FieldManager

getNavigableField

public NavigableField getNavigableField(java.lang.String id)

Specified by:

getNavigableField in interface FieldManager

isRequirableField

public boolean isRequirableField(java.lang.String id)

Specified by:

isRequirableField in interface FieldManager

isRequirableField

public boolean isRequirableField(Field field)

Specified by:

isRequirableField in interface FieldManager

isMandatoryField

public boolean isMandatoryField(java.lang.String id)

Specified by:

isMandatoryField in interface FieldManager

isMandatoryField

public boolean isMandatoryField(Field field)

Specified by:

isMandatoryField in interface FieldManager

isRenderableField

public boolean isRenderableField(java.lang.String id)

Specified by:

isRenderableField in interface FieldManager

isRenderableField

public boolean isRenderableField(Field field)

Specified by:

isRenderableField in interface FieldManager

isUnscreenableField

public boolean isUnscreenableField(java.lang.String id)

Specified by:

isUnscreenableField in interface FieldManager

isUnscreenableField

public boolean isUnscreenableField(Field field)

Specified by:

isUnscreenableField in interface FieldManager

getRequiredField

public RequirableField getRequiredField(java.lang.String id)

Specified by:

getRequiredField in interface FieldManager

getCustomFieldManager

public CustomFieldManager getCustomFieldManager()

Specified by:

getCustomFieldManager in interface FieldManager

Returns:

CustomFieldManager

getFieldLayoutManager

@Deprecated
public FieldLayoutManager getFieldLayoutManager()

Deprecated. Declare your dependency and let PicoContainer resolve it instead

Specified by:

getFieldLayoutManager in interface FieldManager

Returns:

FieldLayoutManager

getColumnLayoutManager

@Deprecated
public ColumnLayoutManager getColumnLayoutManager()

Deprecated. Declare your dependency and let PicoContainer resolve it instead

Specified by:

getColumnLayoutManager in interface FieldManager

Returns:

ColumnLayoutManager

refresh

public void refresh()

Specified by:

refresh in interface FieldManager

isTimeTrackingOn

public boolean isTimeTrackingOn()

Specified by:

isTimeTrackingOn in interface FieldManager

isVotingOn

protected boolean isVotingOn()

isSubTasksOn

protected boolean isSubTasksOn()

getUnavailableFields

public java.util.Set<Field> getUnavailableFields()

Specified by:

getUnavailableFields in interface FieldManager