org.springframework.data.mongodb.core.query

Class Query

java.lang.Object

org.springframework.data.mongodb.core.query.Query

Direct Known Subclasses:

BasicQuery, TextQuery

public class Query
extends Object

Author:

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

Constructor Summary

Constructors

Constructor and Description
Query()
Query(CriteriaDefinition criteriaDefinition) Creates a new Query using the given CriteriaDefinition.

Method Summary

Modifier and Type	Method and Description
Query	addCriteria(CriteriaDefinition criteriaDefinition) Adds the given CriteriaDefinition to the current Query.
Query	comment(String comment)
boolean	equals(Object obj)
Query	exhaust()
Field	fields()
protected List<CriteriaDefinition>	getCriteria()
com.mongodb.DBObject	getFieldsObject()
String	getHint()
int	getLimit() Get the maximum number of documents to be return.
Meta	getMeta()
com.mongodb.DBObject	getQueryObject()
Set<Class<?>>	getRestrictedTypes()
int	getSkip() Get the number of documents to skip.
com.mongodb.DBObject	getSortObject()
int	hashCode()
static boolean	isRestrictedTypeKey(String key) Deprecated. don't call this method as the restricted type handling will undergo some significant changes going forward.
Query	limit(int limit) Limit the number of returned documents to limit.
Query	maxScan(long maxScan)
Query	maxTime(long timeout, TimeUnit timeUnit)
Query	maxTimeMsec(long maxTimeMsec)
Query	noCursorTimeout()
Query	partialResults()
static Query	query(CriteriaDefinition criteriaDefinition) Static factory method to create a Query using the provided CriteriaDefinition.
protected boolean	querySettingsEquals(Query that) Tests whether the settings of the given Query are equal to this query.
Query	restrict(Class<?> type, Class<?>... additionalTypes) Restricts the query to only return documents instances that are exactly of the given types.
void	setMeta(Meta meta)
Query	skip(int skip) Set number of documents to skip before returning results.
Query	slaveOk()
String	toString()
Query	useSnapshot()
Query	with(Pageable pageable) Sets the given pagination information on the Query instance.
Query	with(Sort sort) Adds a Sort to the Query instance.
Query	withHint(String name) Configures the query to use the given hint when being executed.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Query

public Query()

Query

public Query(CriteriaDefinition criteriaDefinition)

Creates a new Query using the given CriteriaDefinition.

Parameters:

criteriaDefinition - must not be null.

Since:

1.6

Method Detail

query

public static Query query(CriteriaDefinition criteriaDefinition)

Static factory method to create a Query using the provided CriteriaDefinition.

Parameters:

criteriaDefinition - must not be null.

Returns:

Since:

1.6

addCriteria

public Query addCriteria(CriteriaDefinition criteriaDefinition)

Adds the given CriteriaDefinition to the current Query.

Parameters:

criteriaDefinition - must not be null.

Returns:

Since:

1.6

fields

public Field fields()

skip

public Query skip(int skip)

Set number of documents to skip before returning results.

Parameters:

skip -

Returns:

limit

public Query limit(int limit)

Limit the number of returned documents to limit.

Parameters:

limit -

Returns:

withHint

public Query withHint(String name)

Configures the query to use the given hint when being executed.

Parameters:

name - must not be null or empty.

Returns:

with

public Query with(Pageable pageable)

Sets the given pagination information on the Query instance. Will transparently set skip and limit as well as applying the Sort instance defined with the Pageable.

Parameters:

pageable -

Returns:

with

public Query with(Sort sort)

Adds a Sort to the Query instance.

Parameters:

sort -

Returns:

getRestrictedTypes

public Set<Class<?>> getRestrictedTypes()

Returns:

the restrictedTypes

restrict

public Query restrict(Class<?> type,
                      Class<?>... additionalTypes)

Restricts the query to only return documents instances that are exactly of the given types.

Parameters:

type - may not be null

additionalTypes - may not be null

Returns:

getQueryObject

public com.mongodb.DBObject getQueryObject()

getFieldsObject

public com.mongodb.DBObject getFieldsObject()

getSortObject

public com.mongodb.DBObject getSortObject()

getSkip

public int getSkip()

Get the number of documents to skip.

Returns:

getLimit

public int getLimit()

Get the maximum number of documents to be return.

Returns:

getHint

public String getHint()

Returns:

maxTimeMsec

public Query maxTimeMsec(long maxTimeMsec)

Parameters:

maxTimeMsec -

Returns:

Since:

1.6

See Also:

Meta.setMaxTimeMsec(long)

maxTime

public Query maxTime(long timeout,
                     TimeUnit timeUnit)

Parameters:

timeout -

timeUnit -

Returns:

Since:

1.6

See Also:

Meta.setMaxTime(long, TimeUnit)

maxScan

public Query maxScan(long maxScan)

Parameters:

maxScan -

Returns:

Since:

1.6

See Also:

Meta.setMaxScan(long)

comment

public Query comment(String comment)

Parameters:

comment -

Returns:

Since:

1.6

See Also:

Meta.setComment(String)

useSnapshot

public Query useSnapshot()

Returns:

Since:

1.6

See Also:

Meta.setSnapshot(boolean)

noCursorTimeout

public Query noCursorTimeout()

Returns:

Since:

1.10

See Also:

Meta.CursorOption.NO_TIMEOUT

exhaust

public Query exhaust()

Returns:

Since:

1.10

See Also:

Meta.CursorOption.EXHAUST

slaveOk

public Query slaveOk()

Returns:

Since:

1.10

See Also:

Meta.CursorOption.SLAVE_OK

partialResults

public Query partialResults()

Returns:

Since:

1.10

See Also:

Meta.CursorOption.PARTIAL

getMeta

public Meta getMeta()

Returns:

never null.

Since:

1.6

setMeta

public void setMeta(Meta meta)

Parameters:

meta - must not be null.

Since:

1.6

getCriteria

protected List<CriteriaDefinition> getCriteria()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

querySettingsEquals

protected boolean querySettingsEquals(Query that)

Tests whether the settings of the given Query are equal to this query.

Parameters:

that -

Returns:

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isRestrictedTypeKey

@Deprecated
public static boolean isRestrictedTypeKey(String key)

Deprecated. don't call this method as the restricted type handling will undergo some significant changes going forward.

Returns whether the given key is the one used to hold the type restriction information.

Parameters:

key -

Returns: