org.springframework.data.solr.core.query

Class Criteria

java.lang.Object

org.springframework.data.solr.core.query.Criteria

Direct Known Subclasses:

SimpleStringCriteria

public class Criteria
extends Object

Criteria is the central class when constructing queries. It follows more or less a fluent API style, which allows to easily chain together multiple criteria.

Author:

Christoph Strobl

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Criteria.CriteriaEntry
static class	Criteria.OperationKey

Field Summary

Fields

Modifier and Type	Field and Description
static String	CRITERIA_VALUE_SEPERATOR
static String	WILDCARD

Constructor Summary

Constructors

Modifier	Constructor and Description
	Criteria()
	Criteria(Field field) Creates a new Criteria for the given field
protected	Criteria(List<Criteria> criteriaChain, Field field)
protected	Criteria(List<Criteria> criteriaChain, String fieldname)
	Criteria(String fieldname) Creates a new Criteria for the Filed with provided name

Method Summary

Methods

Modifier and Type	Method and Description
Criteria	and(Criteria... criterias) Chain using AND
Criteria	and(Criteria criteria) Chain using AND
Criteria	and(Field field) Chain using AND
Criteria	and(String fieldname) Chain using AND
Criteria	between(Object lowerBound, Object upperBound) Crates new CriteriaEntry for RANGE [lowerBound TO upperBound]
Criteria	between(Object lowerBound, Object upperBound, boolean includeLowerBound, boolean includeUppderBound) Crates new CriteriaEntry for RANGE [lowerBound TO upperBound]
Criteria	boost(float boost) Boost positive hit with given factor. eg. ^2.3
Criteria	contains(String s) Crates new CriteriaEntry with leading and trailing wildcards NOTE: mind your schema as leading wildcards may not be supported and/or execution might be slow.
Criteria	endsWith(String s) Crates new CriteriaEntry with leading wildcard NOTE: mind your schema and execution times as leading wildcards may not be supported.
Criteria	expression(String s) Crates new CriteriaEntry allowing native solr expressions
Criteria	fuzzy(String s) Crates new CriteriaEntry with trailing ~
Criteria	fuzzy(String s, float levenshteinDistance) Crates new CriteriaEntry with trailing ~ followed by levensteinDistance
float	getBoost() Boost criteria value
String	getConjunctionOperator() Conjunction to be used with this criteria (AND | OR)
List<Criteria>	getCriteriaChain() Get the collection of criterias
Set<Criteria.CriteriaEntry>	getCriteriaEntries()
Field	getField() Field targeted by this Criteria
Criteria	greaterThan(Object lowerBound) Crates new CriteriaEntry for RANGE &#123;lowerBound TO *]
Criteria	greaterThanEqual(Object lowerBound) Crates new CriteriaEntry for RANGE [lowerBound TO *]
Criteria	in(Iterable<?> values) Crates new CriteriaEntry for multiple values (arg0 arg1 arg2 ...)
Criteria	in(Object... values) Crates new CriteriaEntry for multiple values (arg0 arg1 arg2 ...)
Criteria	is(Object o) Crates new CriteriaEntry without any wildcards
boolean	isNegating()
Criteria	lessThan(Object upperBound) Crates new CriteriaEntry for RANGE [* TO upperBound&#125;
Criteria	lessThanEqual(Object upperBound) Crates new CriteriaEntry for RANGE [* TO upperBound]
Criteria	near(BoundingBox box) Creates new CriteriaEntriy for {@code !
Criteria	near(GeoLocation location, Distance distance) Creates new CriteriaEntry for {@code !
Criteria	not() Crates new CriteriaEntry with leading -
Criteria	or(Criteria criteria) Chain using OR
Criteria	or(Field field) Chain using OR
Criteria	or(String fieldname) Chain using OR
Criteria	startsWith(String s) Crates new CriteriaEntry with trailing wildcard
static Criteria	where(Field field) Static factory method to create a new Criteria for provided field
static Criteria	where(String field) Static factory method to create a new Criteria for field with given name
Criteria	within(GeoLocation location, Distance distance) Creates new CriteriaEntry for {@code !

Methods inherited from class java.lang.Object

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

Field Detail

WILDCARD

public static final String WILDCARD

See Also:

Constant Field Values

CRITERIA_VALUE_SEPERATOR

public static final String CRITERIA_VALUE_SEPERATOR

See Also:

Constant Field Values

Constructor Detail

Criteria

public Criteria()

Criteria

public Criteria(String fieldname)

Creates a new Criteria for the Filed with provided name

Parameters:

fieldname -

Criteria

public Criteria(Field field)

Creates a new Criteria for the given field

Parameters:

field -

Criteria

protected Criteria(List<Criteria> criteriaChain,
        String fieldname)

Criteria

protected Criteria(List<Criteria> criteriaChain,
        Field field)

Method Detail

where

public static Criteria where(String field)

Static factory method to create a new Criteria for field with given name

Parameters:

field -

Returns:

where

public static Criteria where(Field field)

Static factory method to create a new Criteria for provided field

Parameters:

field -

Returns:

and

public Criteria and(Field field)

Chain using AND

Parameters:

field -

Returns:

and

public Criteria and(String fieldname)

Chain using AND

Parameters:

field -

Returns:

and

public Criteria and(Criteria criteria)

Chain using AND

Parameters:

field -

Returns:

and

public Criteria and(Criteria... criterias)

Chain using AND

Parameters:

field -

Returns:

or

public Criteria or(Field field)

Chain using OR

Parameters:

field -

Returns:

or

public Criteria or(Criteria criteria)

Chain using OR

Parameters:

field -

Returns:

or

public Criteria or(String fieldname)

Chain using OR

Parameters:

field -

Returns:

is

public Criteria is(Object o)

Crates new CriteriaEntry without any wildcards

Parameters:

o -

Returns:

contains

public Criteria contains(String s)

Crates new CriteriaEntry with leading and trailing wildcards
NOTE: mind your schema as leading wildcards may not be supported and/or execution might be slow.

Parameters:

o -

Returns:

startsWith

public Criteria startsWith(String s)

Crates new CriteriaEntry with trailing wildcard

Parameters:

o -

Returns:

endsWith

public Criteria endsWith(String s)

Crates new CriteriaEntry with leading wildcard
NOTE: mind your schema and execution times as leading wildcards may not be supported.

Parameters:

o -

Returns:

not

public Criteria not()

Crates new CriteriaEntry with leading -

Parameters:

s -

Returns:

fuzzy

public Criteria fuzzy(String s)

Crates new CriteriaEntry with trailing ~

Parameters:

s -

Returns:

fuzzy

public Criteria fuzzy(String s,
             float levenshteinDistance)

Crates new CriteriaEntry with trailing ~ followed by levensteinDistance

Parameters:

s -

levenshteinDistance -

Returns:

expression

public Criteria expression(String s)

Crates new CriteriaEntry allowing native solr expressions

Parameters:

o -

Returns:

boost

public Criteria boost(float boost)

Boost positive hit with given factor. eg. ^2.3

Parameters:

boost -

Returns:

between

public Criteria between(Object lowerBound,
               Object upperBound)

Crates new CriteriaEntry for RANGE [lowerBound TO upperBound]

Parameters:

lowerBound -

upperBound -

Returns:

between

public Criteria between(Object lowerBound,
               Object upperBound,
               boolean includeLowerBound,
               boolean includeUppderBound)

Crates new CriteriaEntry for RANGE [lowerBound TO upperBound]

Parameters:

lowerBound -

upperBound -

includeLowerBound -

includeUppderBound -

Returns:

lessThan

public Criteria lessThan(Object upperBound)

Crates new CriteriaEntry for RANGE [* TO upperBound}

Parameters:

upperBound -

Returns:

lessThanEqual

public Criteria lessThanEqual(Object upperBound)

Crates new CriteriaEntry for RANGE [* TO upperBound]

Parameters:

upperBound -

Returns:

greaterThan

public Criteria greaterThan(Object lowerBound)

Crates new CriteriaEntry for RANGE {lowerBound TO *]

Parameters:

lowerBound -

Returns:

greaterThanEqual

public Criteria greaterThanEqual(Object lowerBound)

Crates new CriteriaEntry for RANGE [lowerBound TO *]

Parameters:

lowerBound -

Returns:

in

public Criteria in(Object... values)

Crates new CriteriaEntry for multiple values (arg0 arg1 arg2 ...)

Parameters:

lowerBound -

Returns:

in

public Criteria in(Iterable<?> values)

Crates new CriteriaEntry for multiple values (arg0 arg1 arg2 ...)

Parameters:

c - the collection containing the values to match against

Returns:

within

public Criteria within(GeoLocation location,
              Distance distance)

Creates new CriteriaEntry for !geodist

Parameters:

location - Geolocation in degrees

distance -

Returns:

near

public Criteria near(BoundingBox box)

Creates new CriteriaEntriy for !bbox with exact coordinates

Parameters:

box -

Returns:

near

public Criteria near(GeoLocation location,
            Distance distance)

Creates new CriteriaEntry for !bbox for a specified distance. The difference between this and within is this is approximate while within is exact.

Parameters:

location -

distance -

Returns:

getField

public Field getField()

Field targeted by this Criteria

Returns:

getCriteriaEntries

public Set<Criteria.CriteriaEntry> getCriteriaEntries()

getConjunctionOperator

public String getConjunctionOperator()

Conjunction to be used with this criteria (AND | OR)

Returns:

getCriteriaChain

public List<Criteria> getCriteriaChain()

Get the collection of criterias

Returns:

isNegating

public boolean isNegating()

Returns:

true if not() criteria

getBoost

public float getBoost()

Boost criteria value

Returns:

Float.NaN if not set