Package com.atlassian.jira.jql.query

Class VersionSpecificRelationalOperatorQueryFactory

java.lang.Object

com.atlassian.jira.jql.query.AbstractOperatorQueryFactory<Version>

com.atlassian.jira.jql.query.VersionSpecificRelationalOperatorQueryFactory

All Implemented Interfaces:

OperatorSpecificQueryFactory

@Deprecated(since="10.4",
            forRemoval=true)
public class VersionSpecificRelationalOperatorQueryFactory
extends AbstractOperatorQueryFactory<Version>
implements OperatorSpecificQueryFactory

Deprecated, for removal: This API element is subject to removal in a future version.

This class is deprecated and will be removed in Jira 11.0. Use VersionSpecificRelationalOperatorQueryFactory instead.

Creates queries for relational version operators Operator.GREATER_THAN, Operator.LESS_THAN, Operator.GREATER_THAN_EQUALS, Operator.LESS_THAN_EQUALS.

Version comparison depends on the project and version's sequence. Versions from different projects are not comparable.

To create a query that matches the version with the given operator, this factory searches for versions within the same project as the version operand that satisfy the relational predicate.

For example, if the operator is '>' (Operator.GREATER_THAN), we look for versions that are greater than the given version in the same project and create a query that matches any of these versions. If the version's name matches more than one version across different projects, we combine the results from all matching projects.

Constructor Summary

Constructors

Constructor	Description
VersionSpecificRelationalOperatorQueryFactory(VersionResolver versionResolver, Comparator<? super Version> comparator, IndexInfoResolver<Version> versionIndexInfoResolver)	Deprecated, for removal: This API element is subject to removal in a future version.
VersionSpecificRelationalOperatorQueryFactory(Comparator<? super Version> comparator, NameResolver<Version> versionNameResolver, IndexInfoResolver<Version> versionIndexInfoResolver)	Deprecated, for removal: This API element is subject to removal in a future version. This constructor is deprecated and will be removed in Jira 11.0.

Method Summary

Modifier and Type	Method	Description
QueryFactoryResult	createQueryForEmptyOperand(String fieldName, Operator operator)	Deprecated, for removal: This API element is subject to removal in a future version. Generates the query for an operand that has an OperandHandler that returns true for the isEmpty method.
QueryFactoryResult	createQueryForMultipleValues(String fieldName, Operator operator, List<QueryLiteral> rawValues)	Deprecated, for removal: This API element is subject to removal in a future version. Generates the Query for a list of operand ids.
QueryFactoryResult	createQueryForSingleValue(String fieldName, Operator operator, List<QueryLiteral> rawValues)	Deprecated, for removal: This API element is subject to removal in a future version. Generates the Query for a single operand id.
boolean	handlesOperator(Operator operator)	Deprecated, for removal: This API element is subject to removal in a future version.

Methods inherited from class com.atlassian.jira.jql.query.AbstractOperatorQueryFactory

checkQueryForEmpty, getTermQuery

Methods inherited from class java.lang.Object

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

Constructor Details

VersionSpecificRelationalOperatorQueryFactory

@Deprecated(since="10.2",
            forRemoval=true)
public VersionSpecificRelationalOperatorQueryFactory(Comparator<? super Version> comparator,
 NameResolver<Version> versionNameResolver,
 IndexInfoResolver<Version> versionIndexInfoResolver)

Deprecated, for removal: This API element is subject to removal in a future version.

This constructor is deprecated and will be removed in Jira 11.0. Use VersionSpecificRelationalOperatorQueryFactory(VersionResolver, Comparator, IndexInfoResolver) instead.

VersionSpecificRelationalOperatorQueryFactory

public VersionSpecificRelationalOperatorQueryFactory(VersionResolver versionResolver,
 Comparator<? super Version> comparator,
 IndexInfoResolver<Version> versionIndexInfoResolver)

Deprecated, for removal: This API element is subject to removal in a future version.

Method Details

createQueryForSingleValue

public QueryFactoryResult createQueryForSingleValue(String fieldName,
 Operator operator,
 List<QueryLiteral> rawValues)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from interface: OperatorSpecificQueryFactory

Generates the Query for a single operand id.

Specified by:

createQueryForSingleValue in interface OperatorSpecificQueryFactory

Parameters:

fieldName - the index field name the query should be generated for.

operator - operator which is handled by this implementation.

rawValues - the raw values provided to the operand that need to be converted to index values.

Returns:

the queryFactoryResult that contains the query and the metadata.

createQueryForMultipleValues

public QueryFactoryResult createQueryForMultipleValues(String fieldName,
 Operator operator,
 List<QueryLiteral> rawValues)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from interface: OperatorSpecificQueryFactory

Generates the Query for a list of operand ids.

Specified by:

createQueryForMultipleValues in interface OperatorSpecificQueryFactory

Parameters:

fieldName - the index field name the query should be generated for.

operator - operator which is handled by this implementation.

rawValues - the raw values provided to the operand that need to be converted to index values.

Returns:

the queryFactoryResult that contains the query and the metadata.

createQueryForEmptyOperand

public QueryFactoryResult createQueryForEmptyOperand(String fieldName,
 Operator operator)

Deprecated, for removal: This API element is subject to removal in a future version.

Description copied from interface: OperatorSpecificQueryFactory

Generates the query for an operand that has an OperandHandler that returns true for the isEmpty method. This should generate a Lucene query that will perform the correct search for issues where the field value is not set.

Specified by:

createQueryForEmptyOperand in interface OperatorSpecificQueryFactory

Parameters:

fieldName - the index field name the query should be generated for.

operator - operator which is handled by this implementation.

Returns:

the queryFactoryResult that contains the query and the metadata.

handlesOperator

public boolean handlesOperator(Operator operator)

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

handlesOperator in interface OperatorSpecificQueryFactory

Parameters:

operator - the operator in question.

Returns:

true if this implementation can handle the operator, false otherwise.