com.atlassian.jira.issue.fields
Interface NavigableField

All Superinterfaces:

Comparable, Field

All Known Subinterfaces:

CustomField, ProjectField

public interface NavigableField
extends Field

Fields in JIRA which are able to be placed in the Issue Navigator implement this interface.

Field Summary

static String	ORDER_ASCENDING
static String	ORDER_DESCENDING
static String	TEMPLATE_DIRECTORY_PATH

Method Summary

String	getColumnCssClass()
String	getColumnHeadingKey()
String	getColumnViewHtml(FieldLayoutItem fieldLayoutItem, Map displayParams, Issue issue)
String	getDefaultSortOrder() The order in which to sort the field when it is sorted for the first time.
String	getHiddenFieldId() Returns the id of the field to check for visibility.
org.apache.lucene.search.SortComparatorSource	getSortComparatorSource() A sortComparatorSource object to be used for sorting columns in a table.
LuceneFieldSorter	getSorter() A sorter to be used when sorting columns in a table.
String	prettyPrintChangeHistory(String changeHistory)
String	prettyPrintChangeHistory(String changeHistory, I18nHelper i18nHelper) Used for email notification templates - allows changelog to be displayed in language of the recipient.

Methods inherited from interface com.atlassian.jira.issue.fields.Field

getId, getName, getNameKey

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

TEMPLATE_DIRECTORY_PATH

static final String TEMPLATE_DIRECTORY_PATH

See Also:

Constant Field Values

ORDER_ASCENDING

static final String ORDER_ASCENDING

See Also:

Constant Field Values

ORDER_DESCENDING

static final String ORDER_DESCENDING

See Also:

Constant Field Values

Method Detail

getColumnHeadingKey

String getColumnHeadingKey()

getColumnCssClass

String getColumnCssClass()

getDefaultSortOrder

String getDefaultSortOrder()

The order in which to sort the field when it is sorted for the first time.

Returns:

Either ORDER_ASCENDING or ORDER_DESCENDING

getSortComparatorSource

org.apache.lucene.search.SortComparatorSource getSortComparatorSource()

A sortComparatorSource object to be used for sorting columns in a table. In most cases this will use a MappedSortComparator using the getSorter() method. However, fields can provide any sorting mechanism that they wish.

Returns:

A SortComparatorSource that can be used to sort, or null if this field does not support sorting

getSorter

LuceneFieldSorter getSorter()

A sorter to be used when sorting columns in a table. This sort uses the Lucene Document Collection and is therefore a lot faster than sorting the issues in memory.

Returns:

A sorter that can be used to sort this field, or null depending on the value of getSortComparatorSource()

See Also:

DocumentIssueImpl, MappedSortComparator

getColumnViewHtml

String getColumnViewHtml(FieldLayoutItem fieldLayoutItem,
                         Map displayParams,
                         Issue issue)

getHiddenFieldId

String getHiddenFieldId()

Returns the id of the field to check for visibility. For example, with original estimate field need to ensure that the timetracking field is not hidden. With most fields, this is the same as their id.

prettyPrintChangeHistory

String prettyPrintChangeHistory(String changeHistory)

prettyPrintChangeHistory

String prettyPrintChangeHistory(String changeHistory,
                                I18nHelper i18nHelper)

Used for email notification templates - allows changelog to be displayed in language of the recipient.

Parameters:

changeHistory -

Returns:

String change history formatted according to locale in i18nHelper