com.atlassian.jira.issue.fields
Interface NavigableField

All Superinterfaces:

Comparable, Field

All Known Subinterfaces:

CustomField

All Known Implementing Classes:

AbstractOrderableNavigableFieldImpl, CustomFieldImpl, IssueLinksSystemField, NavigableFieldImpl, SummarySystemField

public interface NavigableField

extends Field

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

public static final String TEMPLATE_DIRECTORY_PATH

See Also:

Constant Field Values

ORDER_ASCENDING

public static final String ORDER_ASCENDING

See Also:

Constant Field Values

ORDER_DESCENDING

public static final String ORDER_DESCENDING

See Also:

Constant Field Values

Method Detail

getColumnHeadingKey

public String getColumnHeadingKey()

getColumnCssClass

public String getColumnCssClass()

getDefaultSortOrder

public 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

public 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

public 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

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

getHiddenFieldId

public 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

public String prettyPrintChangeHistory(String changeHistory)

prettyPrintChangeHistory

public 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