com.atlassian.jira.jql.values

Class AbstractIssueConstantValuesGenerator

java.lang.Object

com.atlassian.jira.jql.values.AbstractIssueConstantValuesGenerator

All Implemented Interfaces:

ClauseValuesGenerator

Direct Known Subclasses:

IssueTypeClauseValuesGenerator, PriorityClauseValuesGenerator, ResolutionClauseValuesGenerator, StatusClauseValuesGenerator

public abstract class AbstractIssueConstantValuesGenerator
extends Object
implements ClauseValuesGenerator

Generates autocomplete values for IssueConstants.

Since:

v4.0

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.jira.jql.values.ClauseValuesGenerator

ClauseValuesGenerator.Result, ClauseValuesGenerator.Results

Constructor Summary

Constructors

Constructor and Description
AbstractIssueConstantValuesGenerator()

Method Summary

Modifier and Type	Method and Description
protected List<String>	getAllConstantNames()
protected abstract List<IssueConstant>	getAllConstants()
ClauseValuesGenerator.Results	getPossibleValues(ApplicationUser searcher, String jqlClauseName, String valuePrefix, int maxNumResults) Will return a string representation of only the possible values that match the value prefix for this clause.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractIssueConstantValuesGenerator

public AbstractIssueConstantValuesGenerator()

Method Detail

getPossibleValues

public ClauseValuesGenerator.Results getPossibleValues(ApplicationUser searcher,
                                                       String jqlClauseName,
                                                       String valuePrefix,
                                                       int maxNumResults)

Description copied from interface: ClauseValuesGenerator

Will return a string representation of only the possible values that match the value prefix for this clause. This should not return more results than specified in maxNumResults. If it is possible this should use the maxNumResults to efficiently generate the results.

The contract of this method is that if the valuePrefix exactly (minus case) matches the suggestion then we suggest it. This will allow users to verify in their own minds that even though they have typed the full value, it is still valid.

Specified by:

getPossibleValues in interface ClauseValuesGenerator

Parameters:

searcher - the user preforming the search.

jqlClauseName - the jql clause name that was entered by the user, represents the identifier that was used to find this values generator. Note: for custom fields this can be used to identify the custom field we are dealing with.

valuePrefix - the portion of the value that has already been provided by the user.

maxNumResults - the maximun number of results to return.

Returns:

a string value of the clause values that match the provided value prefix, empty list if none match.

getAllConstants

protected abstract List<IssueConstant> getAllConstants()

Returns:

a modifiable list of all the constants

getAllConstantNames

protected List<String> getAllConstantNames()

Returns:

a modifiable list of all the constant names