org.forgerock.opendj.ldap.spi

Interface IndexQueryFactory<T>

Type Parameters:

T - The type of query created by this factory.

public interface IndexQueryFactory<T>

A factory for creating arbitrarily complex index queries. This interface is implemented by the underlying backend implementation and passed to extensible matching rules so that they can construct arbitrarily complex index queries.

Method Summary

Modifier and Type	Method and Description
T	createExactMatchQuery(AttributeDescription attributeDescription, String indexID, ByteSequence key) Returns a query requesting an index record matching the provided key.
T	createIntersectionQuery(Collection<T> subqueries) Returns a query which returns the intersection of a collection of sub-queries.
T	createMatchAllQuery(AttributeDescription attributeDescription) Returns a query requesting all index records.
T	createRangeMatchQuery(AttributeDescription attributeDescription, String indexID, ByteSequence lower, ByteSequence upper, boolean lowerIncluded, boolean upperIncluded) Returns a query requesting all index records in the specified range.
T	createUnionQuery(Collection<T> subqueries) Returns a query which combines the results of a collection of sub-queries.
IndexingOptions	getIndexingOptionsOrNull(AttributeDescription attributeDescription) Returns the indexing options for the provided attribute, or null if the attribute is not indexed.

Method Detail

createExactMatchQuery

T createExactMatchQuery(AttributeDescription attributeDescription,
                        String indexID,
                        ByteSequence key)

Returns a query requesting an index record matching the provided key.

Parameters:

attributeDescription - The attribute description whose index should be queried.

indexID - An identifier of the index to be queried.

key - A byte sequence containing the key.

Returns:

A query requesting the index record matching the key.

createMatchAllQuery

T createMatchAllQuery(AttributeDescription attributeDescription)

Returns a query requesting all index records. A backend implementation may choose to return all or no records as part of the optimization.

Parameters:

attributeDescription - The attribute description whose index should be queried.

Returns:

A query requesting all index records.

createRangeMatchQuery

T createRangeMatchQuery(AttributeDescription attributeDescription,
                        String indexID,
                        ByteSequence lower,
                        ByteSequence upper,
                        boolean lowerIncluded,
                        boolean upperIncluded)

Returns a query requesting all index records in the specified range.

Parameters:

attributeDescription - The attribute description whose index should be queried.

indexID - An identifier of the index to be queried.

lower - The lower bound of the range. A 0 length byte array indicates no lower bound and the range will start from the smallest key.

upper - The upper bound of the range. A 0 length byte array indicates no upper bound and the range will end at the largest key.

lowerIncluded - true if a key exactly matching the lower bound is included in the range, false if only keys strictly greater than the lower bound are included. This value is ignored if the lower bound is not specified.

upperIncluded - true if a key exactly matching the upper bound is included in the range, false if only keys strictly less than the upper bound are included. This value is ignored if the upper bound is not specified.

Returns:

A query requesting all index records in the specified range.

createIntersectionQuery

T createIntersectionQuery(Collection<T> subqueries)

Returns a query which returns the intersection of a collection of sub-queries.

Parameters:

subqueries - A collection of sub-queries.

Returns:

A query which returns the intersection of a collection of sub-queries.

createUnionQuery

T createUnionQuery(Collection<T> subqueries)

Returns a query which combines the results of a collection of sub-queries.

Parameters:

subqueries - A collection of sub-queries.

Returns:

A query which combines the results of a collection of sub-queries.

getIndexingOptionsOrNull

IndexingOptions getIndexingOptionsOrNull(AttributeDescription attributeDescription)

Returns the indexing options for the provided attribute, or null if the attribute is not indexed.

Parameters:

attributeDescription - The attribute description whose index options should be queried.

Returns:

The indexing options for the provided attribute, or null if the attribute is not indexed.