过滤器

比较

比较操作符方法包括以下

• eq：匹配等于指定值的值。别名 equal，因为 eq 是保留字。

• gt：匹配大于指定值的值。

• gte：匹配大于或等于指定值的值。

• lt：匹配小于指定值的值。

• lte：匹配小于或等于指定值的值。

• ne：匹配所有不等于指定值的值。别名 notEqual，因为 neq 是保留字。

• in: 匹配数组中指定的任何值。

• nin: 匹配数组中未指定的任何值。

• empty: 匹配所有文档。

`eq`("qty", 20)
equal("qty", 20)

in("qty", 5, 15)

empty()

逻辑

逻辑运算符方法包括以下内容

• and: 使用逻辑 AND 连接过滤器，并选择同时符合两个过滤器条件的所有文档。

• or: 使用逻辑 OR 连接过滤器，并选择符合任一过滤器条件的所有文档。

• not: 反转查询表达式的效果，并选择不匹配过滤器条件的文档。

• nor: 使用逻辑 NOR 连接过滤器，并选择不满足两个过滤器条件的所有文档。

and(gt("qty", 20), equal("user", "jdoe"))

{
   "qty" : { "$gt" : 20 },
   "user" : "jdoe"
}

and(or(equal("price", 0.99), equal("price", 1.99)
    or(equal("sale", true), lt("qty", 20)))

{
 "$and" :
    [
      { "$or" : [ { "price" : 0.99 }, { "price" : 1.99 } ] },
      { "$or" : [ { "sale" : true }, { "qty" : { "$lt" : 20 } } ] }
    ]
}

数组

数组运算符方法包括以下内容：

• all：匹配包含查询中指定所有元素的数组。

• elemMatch：选择字段数组中的元素与指定的所有$elemMatch条件匹配的文档。

• size：选择数组字段为指定大小的文档。

all("tags", "ssl", "security")

元素

元素操作方法包括以下内容

• exists：选择具有指定字段的文档。

• type：选择字段类型为指定类型的文档。由于type是保留词，因此别名为bsonType。

and(exists("qty"), nin("qty", 5, 15))

评估

评估操作方法包括以下内容

• mod：对字段的值执行取模运算，并选择具有指定结果的文档。

• regex：选择值与指定正则表达式匹配的文档。

• text：选择与全文搜索表达式匹配的文档。

• where：匹配满足JavaScript表达式的文档。

text("coffee")

text("coffee", TextSearchOptions().caseSensitive(true))

text("café", TextSearchOptions().diacriticSensitive(true))

位运算

位运算符方法包括以下几种：

• bitsAllSet：选择所有指定位都被设置的字段文档。

• bitsAllClear：选择所有指定位都被清除的字段文档。

• bitsAnySet：选择至少有一个指定位被设置的字段文档。

• bitsAnyClear：选择至少有一个指定位被清除的字段文档。

bitsAllSet("bitField", 50)

地理空间

地理空间运算符方法包括以下内容

• geoWithin：选择包含字段值为落在边界 GeoJSON 几何形状内的 GeoJSON 几何形状的所有文档

• geoWithinBox：选择包含网格坐标数据的字段且完全位于指定框内的所有文档

• geoWithinPolygon：选择包含网格坐标数据的字段且完全位于指定多边形内的所有文档

• geoWithinCenter：选择包含网格坐标数据的字段且完全位于指定圆内的所有文档

• geoWithinCenterSphere：使用球面几何选择包含包含地理空间数据（GeoJSON 或旧坐标对）且完全位于指定圆内的几何形状

• geoIntersects：选择与 GeoJSON 几何形状相交的几何形状。支持 $geoIntersects 的 2dsphere 索引。

• near：返回接近某个点的地理空间对象。需要地理空间索引。支持 2dsphere 和 2d 索引的 $near。

• nearSphere：返回接近球面上某个点的地理空间对象。需要地理空间索引。支持 2dsphere 和 2d 索引的 $nearSphere。

为了更容易构建基于 GeoJSON 的过滤器，驱动程序还包括完整的 GeoJSON 类层次结构

• Point：表示 GeoJSON 的 Point

• MultiPoint：表示 GeoJSON 的 MultiPoint

• LineString：表示 GeoJSON 的 LineString

• MultiLineString：表示一个 GeoJSON 的 MultiLineString。

• Polygon：表示一个 GeoJSON 的 Polygon。

• MultiPolygon：表示一个 GeoJSON 的 MultiPolygon。

• GeometryCollection：表示一个 GeoJSON 的 GeometryCollection。

val polygon: Polygon = Polygon(Seq(Position(0, 0), Position(4, 0),
                                   Position(4, 4), Position(0, 4),
                                   Position(0, 0)))
geoWithin("geo", polygon)

geoIntersects("geo", Point(Position(4, 0)))