org.modeshape.jcr.query

Class QueryBuilder.ConstraintBuilder

java.lang.Object

org.modeshape.jcr.query.QueryBuilder.ConstraintBuilder

All Implemented Interfaces:

QueryBuilder.DynamicOperandBuilder

Direct Known Subclasses:

QueryBuilder.LowerCaser, QueryBuilder.UpperCaser

Enclosing class:

QueryBuilder

public class QueryBuilder.ConstraintBuilder
extends Object
implements QueryBuilder.DynamicOperandBuilder

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConstraintBuilder(QueryBuilder.ConstraintBuilder parent)

Method Summary

Modifier and Type	Method and Description
QueryBuilder.ConstraintBuilder	and() Signal that the previous constraint clause be AND-ed together with another constraint clause that will be defined immediately after this method call.
protected QueryBuilder.ConstraintBuilder	buildLogicalConstraint()
QueryBuilder.ComparisonBuilder	childCount(String table) Constrains the nodes in the the supplied table based upon criteria on the node's number of children.
QueryBuilder.ConstraintBuilder	closeParen() Complete the specification of a constraint clause, and return the builder for the parent constraint clause.
protected QueryBuilder.ComparisonBuilder	comparisonBuilder(DynamicOperand operand)
QueryBuilder.ComparisonBuilder	depth(String table) Constrains the nodes in the the supplied table based upon criteria on the node's depth.
QueryBuilder	end() Complete this constraint specification.
QueryBuilder.ComparisonBuilder	fullTextSearchScore(String table) Constrains the nodes in the the supplied table such that they must satisfy the supplied full-text search on the nodes' property values.
QueryBuilder.ConstraintBuilder	hasProperty(String table, String propertyName) Define a constraint clause that the node within the named table has at least one value for the named property.
QueryBuilder.ConstraintBuilder	isBelowPath(String descendantTable, String ancestorPath) Define a constraint clause that the node within the named table is a descendant of the node at the supplied path.
QueryBuilder.ConstraintBuilder	isChild(String childTable, String parentPath) Define a constraint clause that the node within the named table is the child of the node at the supplied path.
QueryBuilder.ConstraintBuilder	isSameNode(String table, String asNodeAtPath) Define a constraint clause that the node within the named table is the same node as that appearing at the supplied path.
QueryBuilder.ComparisonBuilder	length(String table, String property) Constrains the nodes in the the supplied table such that they must have a property value whose length matches the criteria.
QueryBuilder.DynamicOperandBuilder	lowerCaseOf() Begin a constraint against the lowercase form of a dynamic operand.
QueryBuilder.ComparisonBuilder	nodeLocalName(String table) Constrains the nodes in the the supplied table based upon criteria on the node's local name.
QueryBuilder.ComparisonBuilder	nodeName(String table) Constrains the nodes in the the supplied table based upon criteria on the node's name.
QueryBuilder.ConstraintBuilder	not() Signal that the next constraint clause (defined immediately after this method) should be negated.
QueryBuilder.ConstraintBuilder	openParen() Simulate the use of an open parenthesis in the constraint.
QueryBuilder.ConstraintBuilder	or() Signal that the previous constraint clause be OR-ed together with another constraint clause that will be defined immediately after this method call.
QueryBuilder.ComparisonBuilder	path(String table) Constrains the nodes in the the supplied table based upon criteria on the node's path.
QueryBuilder.ComparisonBuilder	propertyValue(String table, String property) Constrains the nodes in the the supplied table such that they must have a matching value for the named property.
QueryBuilder.ComparisonBuilder	referenceValue(String table) Constrains the nodes in the the supplied table such that they must have a matching value for any of the node's reference properties.
QueryBuilder.ComparisonBuilder	referenceValue(String table, String property) Constrains the nodes in the the supplied table such that they must have a matching value for the named property.
QueryBuilder.ConstraintBuilder	search(String table, String searchExpression) Define a constraint clause that the node within the named table have at least one property that satisfies the full-text search expression.
QueryBuilder.ConstraintBuilder	search(String table, String propertyName, String searchExpression) Define a constraint clause that the node within the named table have a value for the named property that satisfies the full-text search expression.
protected QueryBuilder.ConstraintBuilder	setConstraint(Constraint constraint)
QueryBuilder.ComparisonBuilder	strongReferenceValue(String table) Constrains the nodes in the the supplied table such that they must have a matching value for any of the node's non-weak reference properties.
QueryBuilder.DynamicOperandBuilder	upperCaseOf() Begin a constraint against the uppercase form of a dynamic operand.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConstraintBuilder

protected ConstraintBuilder(QueryBuilder.ConstraintBuilder parent)

Method Detail

end

public QueryBuilder end()

Complete this constraint specification.

Returns:

the query builder, for method chaining purposes

openParen

public QueryBuilder.ConstraintBuilder openParen()

Simulate the use of an open parenthesis in the constraint. The resulting builder should be used to define the constraint within the parenthesis, and should always be terminated with a closeParen().

Returns:

the constraint builder that should be used to define the portion of the constraint within the parenthesis; never null

See Also:

closeParen()

closeParen

public QueryBuilder.ConstraintBuilder closeParen()

Complete the specification of a constraint clause, and return the builder for the parent constraint clause.

Returns:

the constraint builder that was used to create this parenthetical constraint clause builder; never null

Throws:

IllegalStateException - if there was not an open parenthesis to close

and

public QueryBuilder.ConstraintBuilder and()

Signal that the previous constraint clause be AND-ed together with another constraint clause that will be defined immediately after this method call.

Returns:

the constraint builder for the remaining constraint clause; never null

or

public QueryBuilder.ConstraintBuilder or()

Signal that the previous constraint clause be OR-ed together with another constraint clause that will be defined immediately after this method call.

Returns:

the constraint builder for the remaining constraint clause; never null

not

public QueryBuilder.ConstraintBuilder not()

Signal that the next constraint clause (defined immediately after this method) should be negated.

Returns:

the constraint builder for the constraint clause that is to be negated; never null

buildLogicalConstraint

protected QueryBuilder.ConstraintBuilder buildLogicalConstraint()

isSameNode

public QueryBuilder.ConstraintBuilder isSameNode(String table,
                                                 String asNodeAtPath)

Define a constraint clause that the node within the named table is the same node as that appearing at the supplied path.

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

asNodeAtPath - the path to the node

Returns:

the constraint builder that was used to create this clause; never null

isChild

public QueryBuilder.ConstraintBuilder isChild(String childTable,
                                              String parentPath)

Define a constraint clause that the node within the named table is the child of the node at the supplied path.

Parameters:

childTable - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

parentPath - the path to the parent node

Returns:

the constraint builder that was used to create this clause; never null

isBelowPath

public QueryBuilder.ConstraintBuilder isBelowPath(String descendantTable,
                                                  String ancestorPath)

Define a constraint clause that the node within the named table is a descendant of the node at the supplied path.

Parameters:

descendantTable - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

ancestorPath - the path to the ancestor node

Returns:

the constraint builder that was used to create this clause; never null

hasProperty

public QueryBuilder.ConstraintBuilder hasProperty(String table,
                                                  String propertyName)

Define a constraint clause that the node within the named table has at least one value for the named property.

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

propertyName - the name of the property

Returns:

the constraint builder that was used to create this clause; never null

search

public QueryBuilder.ConstraintBuilder search(String table,
                                             String searchExpression)

Define a constraint clause that the node within the named table have at least one property that satisfies the full-text search expression.

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

searchExpression - the full-text search expression

Returns:

the constraint builder that was used to create this clause; never null

search

public QueryBuilder.ConstraintBuilder search(String table,
                                             String propertyName,
                                             String searchExpression)

Define a constraint clause that the node within the named table have a value for the named property that satisfies the full-text search expression.

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

propertyName - the name of the property to be searched

searchExpression - the full-text search expression

Returns:

the constraint builder that was used to create this clause; never null

comparisonBuilder

protected QueryBuilder.ComparisonBuilder comparisonBuilder(DynamicOperand operand)

length

public QueryBuilder.ComparisonBuilder length(String table,
                                             String property)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table such that they must have a property value whose length matches the criteria.

Specified by:

length in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

property - the name of the property; may not be null and must refer to a valid property name

Returns:

the interface for completing the value portion of the criteria specification; never null

propertyValue

public QueryBuilder.ComparisonBuilder propertyValue(String table,
                                                    String property)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table such that they must have a matching value for the named property.

Specified by:

propertyValue in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

property - the name of the property; may not be null and must refer to a valid property name

Returns:

the interface for completing the value portion of the criteria specification; never null

strongReferenceValue

public QueryBuilder.ComparisonBuilder strongReferenceValue(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table such that they must have a matching value for any of the node's non-weak reference properties.

Specified by:

strongReferenceValue in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

referenceValue

public QueryBuilder.ComparisonBuilder referenceValue(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table such that they must have a matching value for any of the node's reference properties.

Specified by:

referenceValue in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

referenceValue

public QueryBuilder.ComparisonBuilder referenceValue(String table,
                                                     String property)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table such that they must have a matching value for the named property.

Specified by:

referenceValue in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

property - the name of the reference property; may be null if the constraint applies to all/any reference properties on the node

Returns:

the interface for completing the value portion of the criteria specification; never null

fullTextSearchScore

public QueryBuilder.ComparisonBuilder fullTextSearchScore(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table such that they must satisfy the supplied full-text search on the nodes' property values.

Specified by:

fullTextSearchScore in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

childCount

public QueryBuilder.ComparisonBuilder childCount(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table based upon criteria on the node's number of children.

Specified by:

childCount in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

depth

public QueryBuilder.ComparisonBuilder depth(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table based upon criteria on the node's depth.

Specified by:

depth in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

path

public QueryBuilder.ComparisonBuilder path(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table based upon criteria on the node's path.

Specified by:

path in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

nodeLocalName

public QueryBuilder.ComparisonBuilder nodeLocalName(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table based upon criteria on the node's local name.

Specified by:

nodeLocalName in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

nodeName

public QueryBuilder.ComparisonBuilder nodeName(String table)

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Constrains the nodes in the the supplied table based upon criteria on the node's name.

Specified by:

nodeName in interface QueryBuilder.DynamicOperandBuilder

Parameters:

table - the name of the table; may not be null and must refer to a valid name or alias of a table appearing in the FROM clause

Returns:

the interface for completing the value portion of the criteria specification; never null

upperCaseOf

public QueryBuilder.DynamicOperandBuilder upperCaseOf()

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Begin a constraint against the uppercase form of a dynamic operand.

Specified by:

upperCaseOf in interface QueryBuilder.DynamicOperandBuilder

Returns:

the interface for completing the criteria specification; never null

lowerCaseOf

public QueryBuilder.DynamicOperandBuilder lowerCaseOf()

Description copied from interface: QueryBuilder.DynamicOperandBuilder

Begin a constraint against the lowercase form of a dynamic operand.

Specified by:

lowerCaseOf in interface QueryBuilder.DynamicOperandBuilder

Returns:

the interface for completing the criteria specification; never null

setConstraint

protected QueryBuilder.ConstraintBuilder setConstraint(Constraint constraint)