com.atlassian.jira.issue.search.searchers.renderer

Class AbstractProjectConstantsRenderer<I extends SearchInput,O extends com.atlassian.jira.issue.search.searchers.renderer.Options>

java.lang.Object

com.atlassian.jira.issue.search.searchers.renderer.AbstractSearchRenderer

com.atlassian.jira.issue.search.searchers.renderer.AbstractProjectConstantsRenderer<I,O>

All Implemented Interfaces:

SearchRenderer

Direct Known Subclasses:

AbstractVersionRenderer, ComponentSearchRenderer

public abstract class AbstractProjectConstantsRenderer<I extends SearchInput,O extends com.atlassian.jira.issue.search.searchers.renderer.Options>
extends AbstractSearchRenderer
implements SearchRenderer

An abstract renderer for the project constants (versions and components).

Since:

v4.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractProjectConstantsRenderer.GenericProjectConstantsLabel A label with an optional url to the browse page

Field Summary

Fields

Modifier and Type	Field and Description
protected ProjectManager	projectManager
protected SimpleFieldSearchConstantsWithEmpty	searchConstants

Fields inherited from class com.atlassian.jira.issue.search.searchers.renderer.AbstractSearchRenderer

EDIT_TEMPLATE_SUFFIX, VIEW_TEMPLATE_SUFFIX

Method Summary

Modifier and Type	Method and Description
protected void	enableRestApiMode(Map<String,Object> velocityParameters, Map<?,?> displayParameters)
String	getEditHtml(ApplicationUser user, SearchContext searchContext, FieldValuesHolder fieldValuesHolder, Map<?,?> displayParameters, webwork.action.Action action) Used to produce an HTML input that is rendered on the JIRA issue navigator.
protected Map<String,Object>	getVelocityParams(ApplicationUser user, SearchContext searchContext, FieldLayoutItem fieldLayoutItem, FieldValuesHolder fieldValuesHolder, Map<?,?> displayParameters, webwork.action.Action action)
String	getViewHtml(ApplicationUser user, SearchContext searchContext, FieldValuesHolder fieldValuesHolder, Map<?,?> displayParameters, webwork.action.Action action) Used to produce the HTML that displays a searchers summary information (e.g.
boolean	isRelevantForQuery(ApplicationUser user, Query query) Checks if the searchRequest object has a search representation that was created by the searcher and is used to determine if the #getViewHtml(User, com.atlassian.jira.issue.search.SearchContext, com.atlassian.jira.issue.transport.FieldValuesHolder, java.util.Map, webwork.action.Action) method should be called when rendering the search summary.
boolean	isShown(ApplicationUser user, SearchContext searchContext) Checks if the searcher should be shown in this context on the Issue Navigator.
protected List<GroupTextOption>	limitGroupChildOptions(Collection<GroupTextOption> groups, int limit) Return a list constructed by taking groups until their total child options count hits the limit.

Methods inherited from class com.atlassian.jira.issue.search.searchers.renderer.AbstractSearchRenderer

getI18n, isRelevantForQuery, renderEditTemplate, renderViewTemplate

Methods inherited from class java.lang.Object

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

Field Detail

projectManager

protected final ProjectManager projectManager

searchConstants

protected final SimpleFieldSearchConstantsWithEmpty searchConstants

Method Detail

isRelevantForQuery

public boolean isRelevantForQuery(ApplicationUser user,
                                  Query query)

Description copied from interface: SearchRenderer

Checks if the searchRequest object has a search representation that was created by the searcher and is used to determine if the #getViewHtml(User, com.atlassian.jira.issue.search.SearchContext, com.atlassian.jira.issue.transport.FieldValuesHolder, java.util.Map, webwork.action.Action) method should be called when rendering the search summary.

Specified by:

isRelevantForQuery in interface SearchRenderer

Parameters:

user - performing this action.

query - contains the search criteria used to determine if this query is relevevant to the searcher.

Returns:

true if the query has relevant clauses to the searchers, false otherwise.

isShown

public boolean isShown(ApplicationUser user,
                       SearchContext searchContext)

Description copied from interface: SearchRenderer

Checks if the searcher should be shown in this context on the Issue Navigator.

Specified by:

isShown in interface SearchRenderer

Parameters:

user - performing this action.

searchContext - the context of the search (i.e. projects and issue types selected).

Returns:

true if the searcher will appear in the issue navigator, false otherwise.

getEditHtml

public String getEditHtml(ApplicationUser user,
                          SearchContext searchContext,
                          FieldValuesHolder fieldValuesHolder,
                          Map<?,?> displayParameters,
                          webwork.action.Action action)

Description copied from interface: SearchRenderer

Used to produce an HTML input that is rendered on the JIRA issue navigator. This HTML provides the UI for searching a fields content. There will be a corresponding SearchInputTransformer that will know how to transform these input parameters into JIRA search objects.

Specified by:

getEditHtml in interface SearchRenderer

Parameters:

user - performing this action.

searchContext - the search context of the current search request that may be participating in rendering the issue navigator.

fieldValuesHolder - contains any request parameters that the HTML input may need to use to pre-populate the input (e.g. if this is the priority renderer and the search request being rendered has two priorities already selected these params will contain these request parameters). These parameters will have been populated via a call to com.atlassian.jira.issue.search.searchers.transformer.SearchInputTransformer#populateFromQuery(User, com.atlassian.jira.issue.transport.FieldValuesHolder, com.atlassian.query.Query, com.atlassian.jira.issue.search.SearchContext) if there is a SearchRequest involved in the rendering this IssueNavigator call.

displayParameters - are a map of "hints" that can be passed from the caller to this code which can use these hints to alter the way it renders the HTML.

action - is the WebWork 1 action object that is rendering the Issue Navigator view. This can be used to invoke methods on the view.

Returns:

a String that contains HTML that can be rendered on the left-hand side of the JIRA issue navigator.

enableRestApiMode

protected void enableRestApiMode(@Nonnull
                                 Map<String,Object> velocityParameters,
                                 @Nonnull
                                 Map<?,?> displayParameters)

getViewHtml

public String getViewHtml(ApplicationUser user,
                          SearchContext searchContext,
                          FieldValuesHolder fieldValuesHolder,
                          Map<?,?> displayParameters,
                          webwork.action.Action action)

Description copied from interface: SearchRenderer

Used to produce the HTML that displays a searchers summary information (e.g. if this is the priority searcher and a user has selected two priorities then this method will render HTML that shows something like 'priority: Major, Minor').

Specified by:

getViewHtml in interface SearchRenderer

Parameters:

user - performing this action.

searchContext - the search context of the current search request that may be participating in rendering the issue navigator.

fieldValuesHolder - contains any request parameters that the HTML input may need to use to pre-populate the input (e.g. if this is the priority renderer and the search request being rendered has two priorities already selected these params will contain these request parameters). These parameters will have been populated via a call to com.atlassian.jira.issue.search.searchers.transformer.SearchInputTransformer#populateFromQuery(User, com.atlassian.jira.issue.transport.FieldValuesHolder, com.atlassian.query.Query, com.atlassian.jira.issue.search.SearchContext) if there is a SearchRequest involved in the rendering this IssueNavigator call.

displayParameters - are a map of "hints" that can be passed from the caller to this code which can use these hints to alter the way it renders the HTML.

action - is the WebWork 1 action object that is rendering the Issue Navigator view. This can be used to invoke methods on the view.

Returns:

a String that contains HTML that can be rendered on the left-hand side of the issue navigator to show a SearchRequest summary.

getVelocityParams

protected Map<String,Object> getVelocityParams(ApplicationUser user,
                                               SearchContext searchContext,
                                               FieldLayoutItem fieldLayoutItem,
                                               FieldValuesHolder fieldValuesHolder,
                                               Map<?,?> displayParameters,
                                               webwork.action.Action action)

Overrides:

getVelocityParams in class AbstractSearchRenderer

limitGroupChildOptions

protected List<GroupTextOption> limitGroupChildOptions(@Nonnull
                                                       Collection<GroupTextOption> groups,
                                                       int limit)

Return a list constructed by taking groups until their total child options count hits the limit. The last group could have its number of the child options reduced to fit in the given limit.

The method does not modify given collection.