DBCursor

DBCurosr 是 DBCollection 的 find 方法返回的对象,可以设置 skip、limit 等属性之后,执行查询,得到查询结果,

用法如下:

Java代码

Listobj

=collection.find(query).skip(1000).limit(100).toArray();

DBCursor 类的方法可以可以分为两类:修改查询属性 和 执行查询。

以上面的代码为例,find、skip、limit 就是修改查询属性,而 toArrray 就是执行查询。

在实际的实现中,修改查询属性的方法实际上是修改 DBCursor 对象的属性,执行查询则是通过调用 DBCollection._find 得到查询结果。

修改查询属性

Java代码

//排序

publicDBCursorsort(DBObjectorderBy)

//添加特殊设置

publicDBCursoraddSpecial(Stringname,Objecto)

//hint,建议MongoDB使用的索引

publicDBCursorhint(DBObjectindexKeys)

//快照

publicDBCursorsnapshot()

//设置返回结果数量

publicDBCursorlimit(intn)

//每次读取的数量

publicDBCursorbatchSize(intn)

//设置开始读取的位置

publicDBCursorskip(intn)

//添加查询设置

publicDBCursoraddOption(intoption)

//指定查询设置

publicvoidsetOptions(intoptions)

以 sort 为例:

Java代码

//设置排序

publicDBCursorsort(DBObjectorderBy){

//检查是否已经执行过查询

if(_it!=null)

thrownewIllegalStateException("can'tsortafterexecutingquery");

//设置_ordderBy,返回

_orderBy=orderBy;

returnthis;

}

首先,修改查询属性必须放在执行查询之前,否则将抛异常。

其次,修改查询属性往往会修改 DBCursor 对象的属性,比如上面的代码中修改了 _orderBy 。

修改查询属性是为执行查询做准备,执行查询时会将这些设置合并到查询对象 (_query)中。

执行查询

Java代码

//Iterator方式查询,检查是否存在下一个对象

publicbooleanhasNext()

//Iterator方式查询,读取下一个对象

publicDBObjectnext()

//Iterator方式查询,读取当前对象

publicDBObjectcurr()

//Array方式查询,直接获得所有结果

publicListtoArray(intmax)

以 toArray 为例:

Java代码

//执行查询,将结果转为list

publicListtoArray(intmax)

throwsMongoException{

//检查cursor类型

_checkType(CursorType.ARRAY);

//执行查询,填充元素

_fill(max);

return_all;

}

执行查询前需要先通过 _checkType() 检查 cursor 类型。

执行 hasNext()、 hasNext()、curr() 后 cursor 类型为 CursorType.ITERATOR;

cusor 类型不为 CursorType.ARRAY 时,是不能调用 toArray 的。

也就是说,得到 curosr 后,要么用 next() 等方式遍历结果,要么将结果直接转为 list,这两种方式是不能混用的

Java代码

//检查cursor类型

void_checkType(CursorTypetype){

if(_cursorType==null){

_cursorType=type;

return;

}

if(type==_cursorType)

return;

thrownewIllegalArgumentException("can'tswitchcursoraccessmethods");

}

//执行查询,填充元素

void_fill(intn)

throwsMongoException{

//检查cursor类型

_checkType(CursorType.ARRAY);

//循环调用_next()

while(n>=_all.size()&&_hasNext())

_next();

}

可以看出,Array 方式的查询,实际上是循环调用 _next(),读取所有结果。

_next() 中又通过 _check() 来执行查询,实现如下:

Java代码

//下一个元素

privateDBObject_next()

throwsMongoException{

//cursor类型为null时,设置为CursorType.ITERATOR

//执行toArray()时,这里的判断不会通过

if(_cursorType==null)

_checkType(CursorType.ITERATOR);

//执行查询

_check();

_cur=null;

_cur=_it.next();

_num++;

//检查是否只读取部分字段

if(_keysWanted!=null&&_keysWanted.keySet().size()>0){

_cur.markAsPartialObject();

}

//如果cursor类型为CursorType.ARRAY

//将对象添加到结果集中

if(_cursorType==CursorType.ARRAY){

_all.add(_cur);

}

//返回当前对象

return_cur;

}

执行查询实际上是将之前的设置合并,构造出查询对象,然后调用 DBCollection.__find() 得到结果:

Java代码

//执行查询

privatevoid_check()

throwsMongoException{

if(_it!=null)

return;

if(_collection!=null&&_query!=null){

//根据查询对象的keySet,自动设置hint

//以便优化查询性能

_lookForHints();

DBObjectfoo=_query;

//特殊查询

if(hasSpecialQueryFields()){

foo=_specialFields==null?newBasicDBObject():_specialFields;

//_addToQueryObject方法调用了query.put(key,dbObject);

//第三个参数表示"dbObject"为空对象(没有keySet)时是否执行put方法,缺省为true

//查询条件

_addToQueryObject(foo,"query",_query,true);

//排序

_addToQueryObject(foo,"orderby",_orderBy,false);

//设置hint

_addToQueryObject(foo,"$hint",_hint);

//执行计划

if(_explain)

foo.put("$explain",true);

//快照

if(_snapshot)

foo.put("$snapshot",true);

}

//通过DBCollection.__find执行查询

_it=_collection.__find(foo,_keysWanted,_skip,_batchSize,_limit,_options);

}

//结果为空

if(_it==null){

_it=(newLinkedList()).iterator();

_fake=true;

}

}  

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,874评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,102评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,676评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,911评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,937评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,935评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,860评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,660评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,113评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,363评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,506评论 1 346
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,238评论 5 341
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,861评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,486评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,674评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,513评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,426评论 2 352

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,649评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,621评论 18 399
  • 昨天虽然休息,但是还是跟师傅去市区了,主要去给他刚买的新车挂拍照,他不认路,所以要导航。因为是新手,就拉着...
    天空蓝上阅读 120评论 0 0
  • “什么?你们要走?”本来坐在椅子上的少绾惊讶地跳了起来,“不是不是,你们这才来了几日,啊?几日啊?就说要走,你们。...
    转角花开阅读 2,531评论 5 45