db.collection.findOne（）

定义¶

db.collection.findOne（查询，投影）¶

mongo 壳法

此页面记录了mongoshell方法，并且 没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

返回一个满足集合或视图上指定查询条件的文档。如果多个文档满足查询条件，则此方法将根据反映磁盘上文档顺序的自然顺序返回第一个文档。在加盖的集合中，自然顺序与插入顺序相同。如果没有文档满足查询条件，则该方法返回null。

参数	类型	描述
query	文献	可选的。使用查询运算符指定查询选择条件。
projection	文献	可选的。指定要使用投影运算符返回的字段。省略此参数可返回匹配文档中的所有字段。

该projection参数采用以下格式的文档：

复制

{ field1: <boolean>, field2: <boolean> ... }

的<boolean>可以是以下中的一个包括或排除值：

• 1或true包含在内。即使未在projection参数中明确指定该字段，该findOne() 方法也始终包含_id字段。
• 0或false排除。

投影参数不能混合包含和排除规范，但排除_id字段除外。

返回值：	满足作为此方法的第一个参数指定的条件的文档。如果指定projection 参数，则findOne()返回仅包含projection字段的文档。_id 除非您明确排除该字段，否则始终包含该字段。 尽管与该find()方法相似，但是该findOne()方法返回文档而不是游标。

行为¶

例子¶

db.bios.findOne()

db.bios.findOne(
   {
     $or: [
            { 'name.first' : /^G/ },
            { birth: { $lt: new Date('01/01/1945') } }
          ]
   }
)

db.bios.findOne(
    { },
    { name: 1, contribs: 1 }
)

db.bios.findOne(
   { contribs: 'OOP' },
   { _id: 0, 'name.first': 0, birth: 0 }
)

var myDocument = db.bios.findOne();

if (myDocument) {
   var myName = myDocument.name;

   print (tojson(myName));
}