Mongodb 的ORM框架 Morphia 之 Query接口

来源：互联网发布：淘宝商品数据包编辑：程序博客网时间：2024/06/04 18:07

Introduction(简介)

Query接口是个相当直接的方法。他允许非常确切的过滤方式(基于属性)，排序，一个偏移和限制返回结果的数量。

query实现也实现了QueryResults接口，此接口允许在查询中访问结果。

Filter（过滤）

一般的.filter(criteria, value)语法被支持。标准语法是属性名和操作("field > ", or "field in")的整合。所有的语法被逻辑"and" 暗暗的联系在一起。

1Datastore ds = ...  
2Query q = ds.createQuery(MyEntity.class).filter("foo >",12);  
3Datastore ds = ... Query q = ds.createQuery(MyEntity.class).filter("foo >",12);

查询foo在12和30之间的实体对象，的方法如下：

1   Datastore ds = ... 
2 
3Query q = ds.createQuery(MyEntity.class).filter("foo >",12).filter("foo <",30);  
4Datastore ds = ... Query q = ds.createQuery(MyEntity.class).filter("foo >",12).filter("foo <",30);

Operators(操作符)

操作符被用在fileter(...)和MongoDB的查询操作紧密的匹配。

operator

mongo op=$eq!=, <>$ne>,<,>=,<=$gt,$lt,$gte,$ltein$innin$ninelem$elemMatchexists$existsall$allsize$size...... 操作符被用在fileter(...)和MongoDB的查询操作紧密的匹配。

operator

mongo op=$eq!=, <>$ne>,<,>=,<=$gt,$lt,$gte,$ltein$innin$ninelem$elemMatchexists$existsall$allsize$size......

Fluent Interface

沿着.filter(...)方法，这里有个流水型的方法。这些提供一个非常已读的格式。

fluent 接口以field(name)开始。接着一下任何一个方法都可以添加到这个格式中，

1Query q = ds.createQuery(MyEntity.class).field("foo").equal(1);
2
3q.field("bar").greaterThan(12);
4q.field("bar").lessThan(40);

Methods(方法)

methodoperationcommentexists$exists doesNotExist$exists greaterThan,greatherThanOrEq,lessThan,lessThanOrEe$gt,$gte,$lt,$lte equal,notEqual$eq, $ne hasThisOne$eq hasAllOf$all hasAnyOf$in hasNoneOf$nin hasThisElement$elemMatch sizeEq$size

Geo-spatial

所有的geo-spatial方法都被分解为"near, 和within"。所有的near查询将会产生结果，按远程和最近的结果。

下面的方法接受一个球形的最后参数，表名他们是否应该使用$sphere选项。

Methodoperationcommentnear(x, y)$near near(x, y, r)$near(w/maxDistance of r)within(x, y, r)$within + $center within(x1, y1, x2, y2)$within + $box

01@Entity
02static privateclass Place {
03        @Idprotected ObjectId id;
04        protectedString name = "";
05        @Indexed(IndexDirection.GEO2D)
06        protecteddouble[] loc = null;
07
08        publicPlace(String name, double[] loc) {
09                this.name = name;
10                this.loc = loc; }
11
12        privatePlace() {}
13}
14
15Place place1 = newPlace("place1",new double[] {1,1});
16ds.save(place1);
17
18Place found = ds.find(Place.class).field("loc").near(, ).get();

使用流式查询接口时你也可以像一下这样使用"or"查询

1Query<Person> q = ad.createQuery(Person.class);
2q.or(
3 q.criteria("firstName").equal("scott"),
4 q.criteria("lastName").equal("scott")
5);

Fields

属性名也可以像在本地MongoDB查询中那样使用"."标识

1Query q = ds.createQuery(Person.class).field("addresses.city").equal("San Francisco");
2//or with filter, or with this helper method
3Query q = ds.find(Person.class,"addresses.city", "San Francisco");

Validation(验证)

验证被应用在属性名，和数据类型上。如果在查询中使用的属性名在指定的java类中没有找到将会抛出一个异常。如果一个属性名被“.”标识连接，那么这个表达式的每个

部分都将会在指定的java对象中进行验证(有一个异常Map来记录那个属性名被跳过)。

数据类型问题(比较属性类型和参数类型)作为警告被记录，由于服务器可能会把数据强制转换，或者你发送意思不那么的有意义；服务器使用字节表示一些参数，所以有些类型

不同的数值也可以匹配(例如数字)。

Disabling validation（是验证无效）

通过调用disableValidation()可以使验证变为无效，在开始等于查询或每个查询语句上。

1Datastore ds = ...  
2Query q = ds.createQuery(MyEntity.class).disableValidation(); 
3   
4//or it can be disabled for just one filter  
5   
6Query q = ds.createQuery(MyEntity.class).disableValidation().filter("someOldField", value).enableValidation().filter("realField", otherVal);

Sort（排序）

你可以通过一个或多个属性名对结果进行升序或降序排序

1Datastore ds = ...  
2Query q = ds.createQuery(MyEntity.class).filter("foo >",12).order("dateAdded"); 
3... // desc order  
4Query q = ds.createQuery(MyEntity.class).filter("foo >",12).order("-dateAdded"); 
5... // asc dateAdded, desc foo  
6Query q = ds.createQuery(MyEntity.class).filter("foo >",12).order("dateAdded, -foo");

Offset(skip)

你可以通过在查询是指定一个偏移值是服务器跳过一些记录元素。这将比使用几个属性的范围进行查询要低效的多。如下所示：

1Datastore ds = ...  
2Query q = ds.createQuery(MyEntity.class).filter("foo >",12).offset(1000);

Ignoring Fields（忽略属性）

MongoDB也支持只返回一些属性。这在应用中显得有点奇怪，但是这个在修剪掉一部分嵌套时是非常有用的方法。这将会导致局部实体对象，应该不慎重使用，如果可以的话。

01Datastore ds = ...  
02MyEntity e = ds.createQuery(MyEntity.class).retrievedFields(true,"foo").get();  
03   
04val = e.getFoo(); // only field returned  
05   
06...  
07   
08MyEntity e = ds.createQuery(MyEntity.class).retrievedFields(false,"foo").get();  
09   
10val = e.getFoo(); // only field not returned 
11Datastore ds = ... MyEntity e = ds.createQuery(MyEntity.class).retrievedFields(true,"foo").get(); val = e.getFoo();// only field returned ... MyEntity e = ds.createQuery(MyEntity.class).retrievedFields(false, "foo").get(); val = e.getFoo(); // only field not returned

Returning Data （返回值）

仅仅访问QueryResults的一个方法就可以返回你的数据。没有一个方法会影响Query。他们将会单独的离开Query，因此你可以继续通过调用相应的方法来获取你想要的数据。

methoddoesget()返回第一个Entity,--使用limit(1)asList()以一个集合的方式返回所有的结果项，如果一个大的数据结果将会付出代价fetch()明确的返回一个Iterable实例asKeyList()以List的方式返回所有数据项的Key<T> ---仅仅在服务器中得到ID属性fetchEmptyEntities()仅仅想fetch()方法，但是使用id属性填充

01Datastore ds = ...  
02Query q = ds.createQuery(MyEntity.class).filter("foo >",12);  
03   
04//single entity   
05MyEntity e = q.get();  
06   
07e = q.sort("foo").get(); 
08  
09//for   
10for (MyEntity e : q) 
11  print(e);  
12   
13//list   
14List<MyEntity> entities = q.asList();

0 0