com.day.cq.search

Class PredicateGroup

java.lang.Object

com.day.cq.search.Predicate

com.day.cq.search.PredicateGroup

All Implemented Interfaces:

Cloneable, Iterable<Predicate>, Collection<Predicate>, List<Predicate>

public class PredicateGroup
extends Predicate
implements List<Predicate>

A PredicateGroup is a Predicate that represents a list of Predicates (following the composite pattern). This allows to build predicate trees for reflecting complex queries that include sub-terms.

The predicates in a group are by default all required to match, ie. they will be combined with "AND" in a lower-level query language, which is indicated by allRequired() returning true. If setAllRequired(boolean) is called with false, or if the parameter or is set to true, the child predicates will be combined with "OR", ie. only one must match for the whole group to match.

If the parameter not is set to true, the result of this group will be negated. See also isNegated() and setNegated(boolean).

This class extends both the Predicate class and implements the List interface, backed by a standard ArrayList internally.

The standard type name for predicate groups is given by TYPE ( ), which is also used when using the default constructor.

Since:

5.2

Field Summary

Fields

Modifier and Type	Field and Description
static String	TYPE

Fields inherited from class com.day.cq.search.Predicate

ORDER_BY, PARAM_EXCERPT, PARAM_GUESS_TOTAL, PARAM_LIMIT, PARAM_OFFSET, PARAM_SORT, SORT_ASCENDING, SORT_DESCENDING

Constructor Summary

Constructors

Constructor and Description
PredicateGroup() Creates this predicate group with the group type "group", and a predicate name of null.
PredicateGroup(String name) Creates this predicate group with the given name and the group type "group", using the Predicate.Predicate(String, String) constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(int index, Predicate element)
boolean	add(Predicate o)
boolean	addAll(Collection<? extends Predicate> c)
boolean	addAll(int index, Collection<? extends Predicate> c)
boolean	allRequired() Returns whether all predicates are combined with "AND", ie.
void	clear()
PredicateGroup	clone() Clones this predicate group so that the returned clone can be used completely independently from this original.
PredicateGroup	clone(boolean resetName) Clones this predicate group so that the returned clone can be used completely independently from this original.
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
static PredicateGroup	create(Map predicateParameterMap) Converts a map with predicates and their parameters into a predicate tree.
boolean	equals(Object obj)
Predicate	get(int index)
Predicate	getByName(String name) Returns a certain predicate by its name.
Predicate	getByPath(String path) Returns a certain predicate by its path, relative to this predicate.
int	hashCode()
int	indexOf(Object o)
boolean	isEmpty()
boolean	isNegated() Returns whether the result of this predicate group should be negated.
Iterator<Predicate>	iterator()
int	lastIndexOf(Object o)
ListIterator<Predicate>	listIterator()
ListIterator<Predicate>	listIterator(int index)
Predicate	remove(int index)
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
Predicate	set(int index, Predicate element)
void	setAllRequired(boolean all) Sets whether all predicates are combined with "AND", ie.
void	setNegated(boolean not) Sets whether the result of this group should be negated.
int	size()
List<Predicate>	subList(int fromIndex, int toIndex)
Object[]	toArray()
<T> T[]	toArray(T[] a)
String	toString() Overwrites the standard Object.toString() implementation and returns a debug-friendly string including all sub predicates (via their toString() method).
String	toURL() Returns an URL query part containing the given group.

Methods inherited from class com.day.cq.search.Predicate

get, get, getBool, getName, getParameters, getPath, getType, hasNonEmptyValue, ignored, set, setIgnored

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

TYPE

public static final String TYPE

See Also:

Constant Field Values

Constructor Detail

PredicateGroup

public PredicateGroup()

Creates this predicate group with the group type "group", and a predicate name of null. Use this constructor when the name should be deducted automatically (see Predicate.getName()) or for the root group of a predicate tree, because the name must be null for that case.

PredicateGroup

public PredicateGroup(String name)

Creates this predicate group with the given name and the group type "group", using the Predicate.Predicate(String, String) constructor. If you create a root group of a predicate tree, the name must be null (you can use the default constructor PredicateGroup() for that).

Method Detail

create

public static PredicateGroup create(Map predicateParameterMap)

Converts a map with predicates and their parameters into a predicate tree. Accepts a map with strings as keys and either simple strings as values or string arrays as values. In the array case, the first value will be chosen.

Same as PredicateConverter.createPredicates(Map).

toURL

public String toURL()

Returns an URL query part containing the given group. This is the same mapping as used in #createMap(PredicateGroup) and #createPredicates(Map). For example, the returned value could be: type=cq:Page&path=/content. Note that this won't be a complete URL, just a list of parameters for an URL query part. The keys and values will be properly escaped for use in an URL.

Same as PredicateConverter.toURL(PredicateGroup).

allRequired

public boolean allRequired()

Returns whether all predicates are combined with "AND", ie. only nodes are found that match all predicates in this group. The default value is true (AND):

Returns:

true for "AND" (default), false for "OR"

setAllRequired

public void setAllRequired(boolean all)

Sets whether all predicates are combined with "AND", ie. only nodes are found that match all predicates in this group, or if they are combined with "OR".

Parameters:

all - true for "AND", false for "OR"

isNegated

public boolean isNegated()

Returns whether the result of this predicate group should be negated. Ie. only nodes that do not match this group should be included in the results. The default value is false.

Returns:

true for exclusive, false for inclusive (default)

Since:

5.5

setNegated

public void setNegated(boolean not)

Sets whether the result of this group should be negated.

Parameters:

not - true if the group should be negated, false if not (default)

Since:

5.5

getByName

public Predicate getByName(String name)

Returns a certain predicate by its name.

getByPath

public Predicate getByPath(String path)

Returns a certain predicate by its path, relative to this predicate.

clone

public PredicateGroup clone()

Clones this predicate group so that the returned clone can be used completely independently from this original. All child predicates will hence also be cloned.

Overrides:

clone in class Predicate

clone

public PredicateGroup clone(boolean resetName)

Clones this predicate group so that the returned clone can be used completely independently from this original. All child predicates will hence also be cloned. A new name for the clone can be passed.

Overrides:

clone in class Predicate

Parameters:

resetName - whether to reset the name and child predicate names to null so that they will be automatically deducted (see Predicate.getName())

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<Predicate>

Specified by:

equals in interface List<Predicate>

Overrides:

equals in class Predicate

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<Predicate>

Specified by:

hashCode in interface List<Predicate>

Overrides:

hashCode in class Predicate

toString

public String toString()

Overwrites the standard Object.toString() implementation and returns a debug-friendly string including all sub predicates (via their toString() method). The final string is multi-lined and indented for easy readability of the inherent tree structure.

Overrides:

toString in class Predicate

add

public boolean add(Predicate o)

Specified by:

add in interface Collection<Predicate>

Specified by:

add in interface List<Predicate>

add

public void add(int index,
       Predicate element)

Specified by:

add in interface List<Predicate>

addAll

public boolean addAll(Collection<? extends Predicate> c)

Specified by:

addAll in interface Collection<Predicate>

Specified by:

addAll in interface List<Predicate>

addAll

public boolean addAll(int index,
             Collection<? extends Predicate> c)

Specified by:

addAll in interface List<Predicate>

clear

public void clear()

Specified by:

clear in interface Collection<Predicate>

Specified by:

clear in interface List<Predicate>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<Predicate>

Specified by:

contains in interface List<Predicate>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<Predicate>

Specified by:

containsAll in interface List<Predicate>

get

public Predicate get(int index)

Specified by:

get in interface List<Predicate>

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List<Predicate>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<Predicate>

Specified by:

isEmpty in interface List<Predicate>

iterator

public Iterator<Predicate> iterator()

Specified by:

iterator in interface Iterable<Predicate>

Specified by:

iterator in interface Collection<Predicate>

Specified by:

iterator in interface List<Predicate>

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<Predicate>

listIterator

public ListIterator<Predicate> listIterator()

Specified by:

listIterator in interface List<Predicate>

listIterator

public ListIterator<Predicate> listIterator(int index)

Specified by:

listIterator in interface List<Predicate>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<Predicate>

Specified by:

remove in interface List<Predicate>

remove

public Predicate remove(int index)

Specified by:

remove in interface List<Predicate>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<Predicate>

Specified by:

removeAll in interface List<Predicate>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<Predicate>

Specified by:

retainAll in interface List<Predicate>

set

public Predicate set(int index,
            Predicate element)

Specified by:

set in interface List<Predicate>

size

public int size()

Specified by:

size in interface Collection<Predicate>

Specified by:

size in interface List<Predicate>

subList

public List<Predicate> subList(int fromIndex,
                      int toIndex)

Specified by:

subList in interface List<Predicate>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<Predicate>

Specified by:

toArray in interface List<Predicate>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<Predicate>

Specified by:

toArray in interface List<Predicate>