com.mongodb

类 QueryBuilder

java.lang.Object

com.mongodb.QueryBuilder

public class QueryBuilder
extends java.lang.Object

Utility for creating DBObject queries

MongoDB documentation

Querying

构造器概要

构造器

构造器和说明
QueryBuilder() Creates a builder with an empty query

方法概要

限定符和类型	方法和说明
QueryBuilder	all(java.lang.Object object) Equivalent of the $all operand
QueryBuilder	and(DBObject... ands) Equivalent to an $and operand
QueryBuilder	and(java.lang.String key) Equivalent to QueryBuilder.put(key).
QueryBuilder	elemMatch(DBObject match) Equivalent to the $elemMatch operand
QueryBuilder	exists(java.lang.Object object) Equivalent of the $exists operand
DBObject	get() Creates a DBObject query to be used for the driver's find operations
QueryBuilder	greaterThan(java.lang.Object object) Equivalent to the $gt operator
QueryBuilder	greaterThanEquals(java.lang.Object object) Equivalent to the $gte operator
QueryBuilder	in(java.lang.Object object) Equivalent of the $in operand
QueryBuilder	is(java.lang.Object object) Equivalent of the find({key:value})
QueryBuilder	lessThan(java.lang.Object object) Equivalent to the $lt operand
QueryBuilder	lessThanEquals(java.lang.Object object) Equivalent to the $lte operand
QueryBuilder	mod(java.lang.Object object) Equivalent of the $mod operand
QueryBuilder	near(double x, double y) Equivalent of the $near operand
QueryBuilder	near(double x, double y, double maxDistance) Equivalent of the $near operand
QueryBuilder	nearSphere(double longitude, double latitude) Equivalent of the $nearSphere operand
QueryBuilder	nearSphere(double longitude, double latitude, double maxDistance) Equivalent of the $nearSphere operand
QueryBuilder	not() Equivalent to $not meta operator.
QueryBuilder	notEquals(java.lang.Object object) Equivalent of the $ne operand
QueryBuilder	notIn(java.lang.Object object) Equivalent of the $nin operand
QueryBuilder	or(DBObject... ors) Equivalent to an $or operand
QueryBuilder	put(java.lang.String key) Adds a new key to the query if not present yet.
QueryBuilder	regex(java.util.regex.Pattern regex) Passes a regular expression for a query
QueryBuilder	size(java.lang.Object object) Equivalent of the $size operand
static QueryBuilder	start() Returns a new QueryBuilder.
static QueryBuilder	start(java.lang.String key) Creates a new query with a document key
QueryBuilder	text(java.lang.String search) Equivalent to a $text operand.
QueryBuilder	text(java.lang.String search, java.lang.String language) Equivalent to a $text operand.
QueryBuilder	withinBox(double x, double y, double x2, double y2) Equivalent to a $within operand, based on a bounding box using represented by two corners
QueryBuilder	withinCenter(double x, double y, double radius) Equivalent of the $within operand, used for geospatial operation
QueryBuilder	withinCenterSphere(double longitude, double latitude, double maxDistance) Equivalent of the $centerSphere operand mostly intended for queries up to a few hundred miles or km.
QueryBuilder	withinPolygon(java.util.List<java.lang.Double[]> points) Equivalent to a $within operand, based on a bounding polygon represented by an array of points

从类继承的方法 java.lang.Object

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

构造器详细资料

QueryBuilder

public QueryBuilder()

Creates a builder with an empty query

方法详细资料

start

public static QueryBuilder start()

Returns a new QueryBuilder.

返回:

a builder

start

public static QueryBuilder start(java.lang.String key)

Creates a new query with a document key

参数:

key - MongoDB document key

返回:

this

put

public QueryBuilder put(java.lang.String key)

Adds a new key to the query if not present yet. Sets this key as the current key.

参数:

key - MongoDB document key

返回:

this

and

public QueryBuilder and(java.lang.String key)

Equivalent to QueryBuilder.put(key). Intended for compound query chains to be more readable, e.g. QueryBuilder.start("a").greaterThan(1).and("b").lessThan(3)

参数:

key - MongoDB document key

返回:

this

greaterThan

public QueryBuilder greaterThan(java.lang.Object object)

Equivalent to the $gt operator

参数:

object - Value to query

返回:

this

greaterThanEquals

public QueryBuilder greaterThanEquals(java.lang.Object object)

Equivalent to the $gte operator

参数:

object - Value to query

返回:

this

lessThan

public QueryBuilder lessThan(java.lang.Object object)

Equivalent to the $lt operand

参数:

object - Value to query

返回:

this

lessThanEquals

public QueryBuilder lessThanEquals(java.lang.Object object)

Equivalent to the $lte operand

参数:

object - Value to query

返回:

this

is

public QueryBuilder is(java.lang.Object object)

Equivalent of the find({key:value})

参数:

object - Value to query

返回:

this

notEquals

public QueryBuilder notEquals(java.lang.Object object)

Equivalent of the $ne operand

参数:

object - Value to query

返回:

this

in

public QueryBuilder in(java.lang.Object object)

Equivalent of the $in operand

参数:

object - Value to query

返回:

this

notIn

public QueryBuilder notIn(java.lang.Object object)

Equivalent of the $nin operand

参数:

object - Value to query

返回:

this

mod

public QueryBuilder mod(java.lang.Object object)

Equivalent of the $mod operand

参数:

object - Value to query

返回:

this

all

public QueryBuilder all(java.lang.Object object)

Equivalent of the $all operand

参数:

object - Value to query

返回:

this

size

public QueryBuilder size(java.lang.Object object)

Equivalent of the $size operand

参数:

object - Value to query

返回:

this

exists

public QueryBuilder exists(java.lang.Object object)

Equivalent of the $exists operand

参数:

object - Value to query

返回:

this

regex

public QueryBuilder regex(java.util.regex.Pattern regex)

Passes a regular expression for a query

参数:

regex - Regex pattern object

返回:

this

elemMatch

public QueryBuilder elemMatch(DBObject match)

Equivalent to the $elemMatch operand

参数:

match - the object to match

返回:

this

withinCenter

public QueryBuilder withinCenter(double x,
                                 double y,
                                 double radius)

Equivalent of the $within operand, used for geospatial operation

参数:

x - x coordinate

y - y coordinate

radius - radius

返回:

this

near

public QueryBuilder near(double x,
                         double y)

Equivalent of the $near operand

参数:

x - x coordinate

y - y coordinate

返回:

this

near

public QueryBuilder near(double x,
                         double y,
                         double maxDistance)

Equivalent of the $near operand

参数:

x - x coordinate

y - y coordinate

maxDistance - max distance

返回:

this

nearSphere

public QueryBuilder nearSphere(double longitude,
                               double latitude)

Equivalent of the $nearSphere operand

参数:

longitude - coordinate in decimal degrees

latitude - coordinate in decimal degrees

返回:

this

nearSphere

public QueryBuilder nearSphere(double longitude,
                               double latitude,
                               double maxDistance)

Equivalent of the $nearSphere operand

参数:

longitude - coordinate in decimal degrees

latitude - coordinate in decimal degrees

maxDistance - max spherical distance

返回:

this

withinCenterSphere

public QueryBuilder withinCenterSphere(double longitude,
                                       double latitude,
                                       double maxDistance)

Equivalent of the $centerSphere operand mostly intended for queries up to a few hundred miles or km.

参数:

longitude - coordinate in decimal degrees

latitude - coordinate in decimal degrees

maxDistance - max spherical distance

返回:

this

withinBox

public QueryBuilder withinBox(double x,
                              double y,
                              double x2,
                              double y2)

Equivalent to a $within operand, based on a bounding box using represented by two corners

参数:

x - the x coordinate of the first box corner.

y - the y coordinate of the first box corner.

x2 - the x coordinate of the second box corner.

y2 - the y coordinate of the second box corner.

返回:

this

withinPolygon

public QueryBuilder withinPolygon(java.util.List<java.lang.Double[]> points)

Equivalent to a $within operand, based on a bounding polygon represented by an array of points

参数:

points - an array of Double[] defining the vertices of the search area

返回:

this

text

public QueryBuilder text(java.lang.String search)

Equivalent to a $text operand.

参数:

search - the search terms to apply to the text index.

返回:

this

Since server release

2.6

text

public QueryBuilder text(java.lang.String search,
                         java.lang.String language)

Equivalent to a $text operand.

参数:

search - the search terms to apply to the text index.

language - the language to use.

返回:

this

Since server release

2.6

not

public QueryBuilder not()

Equivalent to $not meta operator. Must be followed by an operand, not a value, e.g. QueryBuilder.start("val").not().mod(Arrays.asList(10, 1))

返回:

this

or

public QueryBuilder or(DBObject... ors)

Equivalent to an $or operand

参数:

ors - the list of conditions to or together

返回:

this

and

public QueryBuilder and(DBObject... ands)

Equivalent to an $and operand

参数:

ands - the list of conditions to and together

返回:

this

get

public DBObject get()

Creates a DBObject query to be used for the driver's find operations

返回:

this

抛出:

java.lang.RuntimeException - if a key does not have a matching operand