Criteria (Spring Data MongoDB - Core 2.0.9.RELEASE API)

java.lang.Object
- org.springframework.data.mongodb.core.query.Criteria

All Implemented Interfaces:

CriteriaDefinition

Direct Known Subclasses:

GridFsCriteria
```
public class Criteria
extends Object
implements CriteriaDefinition
```
Central class for creating queries. It follows a fluent API style so that you can easily chain together multiple criteria. Static import of the 'Criteria.where' method will improve readability.

Author:

Thomas Risberg, Oliver Gierke, Thomas Darimont, Christoph Strobl, Mark Paluch

Constructor Summary

Constructors
Modifier Constructor and Description

Criteria()

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

Criteria(String key)

Constructors
Modifier	Constructor and Description
	`Criteria()`
`protected`	`Criteria(List<Criteria> criteriaChain, String key)`
	`Criteria(String key)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Criteria`	`alike(Example<?> sample)` Creates a criterion using the given object as a pattern.
`Criteria`	`all(Collection<?> o)` Creates a criterion using the $all operator.
`Criteria`	`all(Object... o)` Creates a criterion using the $all operator.
`Criteria`	`and(String key)` Static factory method to create a Criteria using the provided key
`Criteria`	`andOperator(Criteria... criteria)` Creates an 'and' criteria using the $and operator for all of the provided criteria.
`static Criteria`	`byExample(Example<?> example)` Static factory method to create a `Criteria` matching an example object.
`static Criteria`	`byExample(Object example)` Static factory method to create a `Criteria` matching an example object.
`Criteria`	`elemMatch(Criteria c)` Creates a criterion using the $elemMatch operator
`boolean`	`equals(Object obj)`
`Criteria`	`exists(boolean b)` Creates a criterion using the $exists operator.
`org.bson.Document`	`getCriteriaObject()` Get `Document` representation.
`String`	`getKey()` Get the identifying key.
`protected org.bson.Document`	`getSingleCriteriaObject()`
`Criteria`	`gt(Object o)` Creates a criterion using the $gt operator.
`Criteria`	`gte(Object o)` Creates a criterion using the $gte operator.
`int`	`hashCode()`
`Criteria`	`in(Collection<?> c)` Creates a criterion using the $in operator.
`Criteria`	`in(Object... o)` Creates a criterion using the $in operator.
`Criteria`	`intersects(GeoJson geoJson)` Creates criterion using `$geoIntersects` operator which matches intersections of the given `geoJson` structure and the documents one.
`Criteria`	`is(Object o)` Creates a criterion using equality
`Criteria`	`lt(Object o)` Creates a criterion using the $lt operator.
`Criteria`	`lte(Object o)` Creates a criterion using the $lte operator.
`Criteria`	`maxDistance(double maxDistance)` Creates a geo-spatial criterion using a $maxDistance operation, for use with $near
`Criteria`	`minDistance(double minDistance)` Creates a geospatial criterion using a $minDistance operation, for use with $near or $nearSphere.
`Criteria`	`mod(Number value, Number remainder)` Creates a criterion using the $mod operator.
`Criteria`	`ne(Object o)` Creates a criterion using the $ne operator.
`Criteria`	`near(Point point)` Creates a geospatial criterion using a $near operation.
`Criteria`	`nearSphere(Point point)` Creates a geospatial criterion using a $nearSphere operation.
`Criteria`	`nin(Collection<?> o)` Creates a criterion using the $nin operator.
`Criteria`	`nin(Object... o)` Creates a criterion using the $nin operator.
`Criteria`	`norOperator(Criteria... criteria)` Creates a 'nor' criteria using the $nor operator for all of the provided criteria.
`Criteria`	`not()` Creates a criterion using the $not meta operator which affects the clause directly following
`Criteria`	`orOperator(Criteria... criteria)` Creates an 'or' criteria using the $or operator for all of the provided criteria Note that mongodb doesn't support an $or operator to be wrapped in a $not operator.
`Criteria`	`regex(org.bson.BsonRegularExpression regex)`
`Criteria`	`regex(Pattern pattern)` Syntactical sugar for `is(Object)` making obvious that we create a regex predicate.
`Criteria`	`regex(String re)` Creates a criterion using a $regex operator.
`Criteria`	`regex(String re, String options)` Creates a criterion using a $regex and $options operator.
`Criteria`	`size(int s)` Creates a criterion using the $size operator.
`Criteria`	`type(int t)` Creates a criterion using the $type operator.
`static Criteria`	`where(String key)` Static factory method to create a Criteria using the provided key
`Criteria`	`within(Shape shape)` Creates a geospatial criterion using a $geoWithin operation.
`Criteria`	`withinSphere(Circle circle)` Creates a geospatial criterion using a $geoWithin $centerSphere operation.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Criteria
```
public Criteria()
```
  - Criteria
```
public Criteria(String key)
```
  - Criteria
```
protected Criteria(List<Criteria> criteriaChain,
                   String key)
```
- Method Detail
  - where
```
public static Criteria where(String key)
```
    Static factory method to create a Criteria using the provided key
    
    Parameters:
    
    key -
    
    Returns:
  - byExample
```
public static Criteria byExample(Object example)
```
    Static factory method to create a Criteria matching an example object.
    
    Parameters:
    
    example - must not be null.
    
    Returns:
    
    Since:
    
    1.8
    
    See Also:
    
    alike(Example)
  - byExample
```
public static Criteria byExample(Example<?> example)
```
    Static factory method to create a Criteria matching an example object.
    
    Parameters:
    
    example - must not be null.
    
    Returns:
    
    Since:
    
    1.8
    
    See Also:
    
    alike(Example)
  - and
```
public Criteria and(String key)
```
    Static factory method to create a Criteria using the provided key
    
    Returns:
  - is
```
public Criteria is(@Nullable
                   Object o)
```
    Creates a criterion using equality
    
    Parameters:
    
    o -
    
    Returns:
  - ne
```
public Criteria ne(@Nullable
                   Object o)
```
    Creates a criterion using the $ne operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $ne
  - lt
```
public Criteria lt(Object o)
```
    Creates a criterion using the $lt operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $lt
  - lte
```
public Criteria lte(Object o)
```
    Creates a criterion using the $lte operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $lte
  - gt
```
public Criteria gt(Object o)
```
    Creates a criterion using the $gt operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $gt
  - gte
```
public Criteria gte(Object o)
```
    Creates a criterion using the $gte operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $gte
  - in
```
public Criteria in(Object... o)
```
    Creates a criterion using the $in operator.
    
    Parameters:
    
    o - the values to match against
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $in
  - in
```
public Criteria in(Collection<?> c)
```
    Creates a criterion using the $in operator.
    
    Parameters:
    
    c - the collection containing the values to match against
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $in
  - nin
```
public Criteria nin(Object... o)
```
    Creates a criterion using the $nin operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $nin
  - nin
```
public Criteria nin(Collection<?> o)
```
    Creates a criterion using the $nin operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $nin
  - mod
```
public Criteria mod(Number value,
                    Number remainder)
```
    Creates a criterion using the $mod operator.
    
    Parameters:
    
    value -
    
    remainder -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $mod
  - all
```
public Criteria all(Object... o)
```
    Creates a criterion using the $all operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $all
  - all
```
public Criteria all(Collection<?> o)
```
    Creates a criterion using the $all operator.
    
    Parameters:
    
    o -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $all
  - size
```
public Criteria size(int s)
```
    Creates a criterion using the $size operator.
    
    Parameters:
    
    s -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $size
  - exists
```
public Criteria exists(boolean b)
```
    Creates a criterion using the $exists operator.
    
    Parameters:
    
    b -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $exists
  - type
```
public Criteria type(int t)
```
    Creates a criterion using the $type operator.
    
    Parameters:
    
    t -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $type
  - not
```
public Criteria not()
```
    Creates a criterion using the $not meta operator which affects the clause directly following
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $not
  - regex
```
public Criteria regex(String re)
```
    Creates a criterion using a $regex operator.
    
    Parameters:
    
    re -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $regex
  - regex
```
public Criteria regex(String re,
                      @Nullable
                      String options)
```
    Creates a criterion using a $regex and $options operator.
    
    Parameters:
    
    re -
    
    options -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $regex
  - regex
```
public Criteria regex(Pattern pattern)
```
    Syntactical sugar for is(Object) making obvious that we create a regex predicate.
    
    Parameters:
    
    pattern -
    
    Returns:
  - regex
```
public Criteria regex(org.bson.BsonRegularExpression regex)
```
  - withinSphere
```
public Criteria withinSphere(Circle circle)
```
    Creates a geospatial criterion using a $geoWithin $centerSphere operation. This is only available for Mongo 2.4 and higher.
    
    Parameters:
    
    circle - must not be null
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $geoWithin, MongoDB Query operator: $centerSphere
  - within
```
public Criteria within(Shape shape)
```
    Creates a geospatial criterion using a $geoWithin operation.
    
    Parameters:
    
    shape -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $geoWithin
  - near
```
public Criteria near(Point point)
```
    Creates a geospatial criterion using a $near operation.
    
    Parameters:
    
    point - must not be null
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $near
  - nearSphere
```
public Criteria nearSphere(Point point)
```
    Creates a geospatial criterion using a $nearSphere operation. This is only available for Mongo 1.7 and higher.
    
    Parameters:
    
    point - must not be null
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $nearSphere
  - intersects
```
public Criteria intersects(GeoJson geoJson)
```
    Creates criterion using $geoIntersects operator which matches intersections of the given geoJson structure and the documents one. Requires MongoDB 2.4 or better.
    
    Parameters:
    
    geoJson - must not be null.
    
    Returns:
    
    Since:
    
    1.8
  - maxDistance
```
public Criteria maxDistance(double maxDistance)
```
    Creates a geo-spatial criterion using a $maxDistance operation, for use with $near
    
    Parameters:
    
    maxDistance -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $maxDistance
  - minDistance
```
public Criteria minDistance(double minDistance)
```
    Creates a geospatial criterion using a $minDistance operation, for use with $near or $nearSphere.
    
    Parameters:
    
    minDistance -
    
    Returns:
    
    Since:
    
    1.7
  - elemMatch
```
public Criteria elemMatch(Criteria c)
```
    Creates a criterion using the $elemMatch operator
    
    Parameters:
    
    c -
    
    Returns:
    
    See Also:
    
    MongoDB Query operator: $elemMatch
  - alike
```
public Criteria alike(Example<?> sample)
```
    Creates a criterion using the given object as a pattern.
    
    Parameters:
    
    sample -
    
    Returns:
    
    Since:
    
    1.8
  - orOperator
```
public Criteria orOperator(Criteria... criteria)
```
    Creates an 'or' criteria using the $or operator for all of the provided criteria
    Note that mongodb doesn't support an $or operator to be wrapped in a $not operator.
    
    Parameters:
    
    criteria -
    
    Throws:
    
    IllegalArgumentException - if orOperator(Criteria...) follows a not() call directly.
  - norOperator
```
public Criteria norOperator(Criteria... criteria)
```
    Creates a 'nor' criteria using the $nor operator for all of the provided criteria.
    Note that mongodb doesn't support an $nor operator to be wrapped in a $not operator.
    
    Parameters:
    
    criteria -
    
    Throws:
    
    IllegalArgumentException - if norOperator(Criteria...) follows a not() call directly.
  - andOperator
```
public Criteria andOperator(Criteria... criteria)
```
    Creates an 'and' criteria using the $and operator for all of the provided criteria.
    Note that mongodb doesn't support an $and operator to be wrapped in a $not operator.
    
    Parameters:
    
    criteria -
    
    Throws:
    
    IllegalArgumentException - if andOperator(Criteria...) follows a not() call directly.
  - getKey
```
@Nullable
public String getKey()
```
    Description copied from interface: CriteriaDefinition
    
    Get the identifying key.
    
    Specified by:
    
    getKey in interface CriteriaDefinition
    
    Returns:
    
    can be null.
  - getCriteriaObject
```
public org.bson.Document getCriteriaObject()
```
    Description copied from interface: CriteriaDefinition
    
    Get Document representation.
    
    Specified by:
    
    getCriteriaObject in interface CriteriaDefinition
    
    Returns:
    
    never null.
  - getSingleCriteriaObject
```
protected org.bson.Document getSingleCriteriaObject()
```
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object

Class Criteria

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Criteria

Criteria

Criteria

Method Detail

where

byExample

byExample

and

is

ne

lt

lte

gt

gte

in

in

nin

nin

mod

all

all

size

exists

type

not

regex

regex

regex

regex

withinSphere

within

near

nearSphere

intersects

maxDistance

minDistance

elemMatch

alike

orOperator

norOperator

andOperator

getKey

getCriteriaObject

getSingleCriteriaObject

equals

hashCode