javax.jcr.query.qom
Interface FullTextSearch

All Superinterfaces:
Constraint

public interface FullTextSearch
extends Constraint

Performs a full-text search.

The full-text search expression is evaluated against the set of full-text indexed properties within the full-text search scope. If property is specified, the full-text search scope is the property of that name on the selector node in the node-tuple; otherwise the full-text search scope is all properties of the selector node (or, in some implementations, all properties in the node subgraph).

Which properties (if any) in a repository are full-text indexed is implementation determined.

It is also implementation determined whether fullTextSearchExpression is independently evaluated against each full-text indexed property in the full-text search scope, or collectively evaluated against the set of such properties using some implementation-determined mechanism.

Similarly, for multi-valued properties, it is implementation determined whether fullTextSearchExpression is independently evaluated against each element in the array of values, or collectively evaluated against the array of values using some implementation-determined mechanism.

At minimum, an implementation must support the following fullTextSearchExpression grammar:

  fullTextSearchExpression ::= [-]term {whitespace [OR] whitespace
 [-]term}
 

term ::= word | '"' word {whitespace word} '"'

word ::= (A string containing no whitespace)

whitespace ::= (A string of only whitespace)

A query satisfies a FullTextSearch constraint if the value (or values) of the full-text indexed properties within the full-text search scope satisfy the specified fullTextSearchExpression, evaluated as follows:

Since:
JCR 2.0

Method Summary
 StaticOperand getFullTextSearchExpression()
          Gets the full-text search expression.
 java.lang.String getPropertyName()
          Gets the name of the property.
 java.lang.String getSelectorName()
          Gets the name of the selector against which to apply this constraint.
 

Method Detail

getSelectorName

java.lang.String getSelectorName()
Gets the name of the selector against which to apply this constraint.

Returns:
the selector name; non-null

getPropertyName

java.lang.String getPropertyName()
Gets the name of the property.

Returns:
the property name if the full-text search scope is a property, otherwise null if the full-text search scope is the node (or node subgraph, in some implementations).

getFullTextSearchExpression

StaticOperand getFullTextSearchExpression()
Gets the full-text search expression.

Returns:
the full-text search expression; non-null