Пример MongoDB findOne
Метод MongoDB findOne() возвращает только один документ, удовлетворяющий введенным критериям. Если введенные критерии соответствуют более чем одному документу, метод возвращает только один документ в соответствии с естественным порядком, который отражает порядок, в котором документы хранятся в базе данных.
MongoDB найтиOne
- Параметр проекции принимает логические значения 1 или true , 0 или false. Если поля проекции не указаны, будут получены все поля.
- MongoDB findOne() всегда включает поле _id, даже если оно не указано явно в параметре проекции, если оно не исключено.
- MongoDB findOne() возвращает только документ, но не курсор.
MongoDB findOne — пустая спецификация запроса
Эта операция возвращает один документ из указанной коллекции. Например, db.car.findOne()
Вывод:
{
"_id" : 2,
"name" : "Polo", "color" : "White",
"cno" : "H411", "speed" : 45, "mfdcountry" : "Japan"
}
Из коллекции car
извлекается только одна запись. Обратите внимание, что «Polo» был добавлен в базу данных первым.
MongoDB findOne — Спецификация запроса
Эта операция MongoDB findOne возвращает первый соответствующий документ из указанной коллекции вместе с введенными критериями выбора. Например:
>db.car.findOne(
... {
... $or:[
... {name:"Zen"},
... {speed: {$gt:60}} ... ]
... }
... )
{
"_id" : ObjectId("546cb92393f464ed49d620db"),
"name" : "Zen",
"color" : "JetRed",
"cno" : "H671",
"speed" : 67,
"mfdcountry" : "Rome"
}
Эта операция ищет автомобиль с именем \Zen или со скоростью выше 60 и извлекает первый документ, удовлетворяющий введенным критериям, из коллекции автомобилей.
Проекция в MongoDB findOne()
Параметр проекции также применим для метода findOne MongoDB. Давайте рассмотрим несколько сценариев, в которых мы можем использовать проекцию в findOne.
MongoDB findOne — укажите возвращаемые поля
Эта операция отображает только поля, указанные в запросе. Например:
>db.car.findOne(
... { },
... {name:1,color:1}
... )
{ "_id" : 2, "name" : "Polo", "color" : "White" }
Отображается первый документ из коллекции Car с полями id, name и color.
MongoDB findOne — вернуть все поля, кроме исключенного
Эта операция извлекает первый документ, исключая поля, указанные в критериях выбора. Например;
>db.car.findOne(
... { name:"Volkswagen" },
... {_id:0, mfdcountry:0,cno:0 }
... )
{ "name" : "Volkswagen", "color" : "JetBlue", "speed" : 62 }
Название автомобиля с Volkswagen извлекается за исключением полей id, mfdcountry и cno.
Документ результатов MongoDB findOne
Методы курсора не будут работать в этой операции, так как метод возвращает только один документ. Чтобы распечатать значения отдельных полей из документа, мы можем использовать приведенный ниже код.
>var car = db.car.findOne();
> if (car) {
... var carName = car.name;
... print (tojson(carName));
... }
"Polo"
При этом извлекается только название автомобиля «Polo».
MongoDB findOne Пример Java
Ниже приведена программа Java, показывающая различные параметры, которые мы можем использовать с MongoDB findOne(). MongoDBFindOne.java
package com.journaldev.mongodb;
import com.mongodb.BasicDBObject;
import com.mongodb.DB;
import com.mongodb.DBCollection;
import com.mongodb.DBObject;
import com.mongodb.MongoClient;
import java.net.UnknownHostException;
public class MongoDBFindOne {
// method retrieves the first document without any criteria
public static void emptyFindOne() throws UnknownHostException {
// Get a new connection to the db assuming that it is running
MongoClient mongoClient = new MongoClient("localhost");
// use test as a datbase,use your database here
DB db = mongoClient.getDB("test");
// fetch the collection object ,car is used here,use your own
DBCollection coll = db.getCollection("car");
// invoking findOne() method
DBObject doc = coll.findOne();
// prints the resultant document
System.out.println(doc);
}
// method that retrieves the document based on the selection criteria
public static void querySpecification() throws UnknownHostException {
// getting a connection everytime is not needed (could be done once
// globally).
MongoClient mongoClient = new MongoClient("localhost");
DB db = mongoClient.getDB("test");
DBCollection coll = db.getCollection("car");
// query to filter the document based on name and speed values by
// creating new object
DBObject query = new BasicDBObject("name", "Zen").append("speed",
new BasicDBObject("$gt", 30));
// resultant document fetched by satisfying the criteria
DBObject d1 = coll.findOne(query);
// prints the document on console
System.out.println(d1);
}
public static void projectionFields() throws UnknownHostException {
MongoClient mongoClient = new MongoClient("localhost");
DB db = mongoClient.getDB("test");
DBCollection coll = db.getCollection("car");
// creates new db object
BasicDBObject b1 = new BasicDBObject();
// criteria to display only name and color fields in the resultant
// document
BasicDBObject fields = new BasicDBObject("name", 1).append("color", 1);
// method that retrieves the documents by accepting fields and object
// criteria
DBObject d1 = coll.findOne(b1, fields);
System.out.println(d1);
}
public static void excludeByfields() throws UnknownHostException {
MongoClient m1 = new MongoClient("localhost");
DB db = m1.getDB("test");
DBCollection col = db.getCollection("car");
// filter criteria for car name volkswagen
DBObject query = new BasicDBObject("name", "Volkswagen");
// excluding the fields mfdcountry,cno and id fields
BasicDBObject fields = new BasicDBObject("mfdcountry", 0).append("cno",
0).append("_id", 0);
DBObject d1 = col.findOne(query, fields);
System.out.println(d1);
}
public static void printDoc() throws UnknownHostException {
MongoClient m1 = new MongoClient("localhost");
DB db = m1.getDB("test");
DBCollection col = db.getCollection("car");
DBObject d1 = col.findOne();
// prints only the name of the car
System.out.println((d1.get("name")));
}
public static void main(String[] args) throws UnknownHostException {
// invoking all the methods from main
emptyFindOne();
querySpecification();
projectionFields();
excludeByfields();
printDoc();
}
}
Вывод вышеуказанной программы:
{ "_id" : 2.0 , "name" : "Polo" , "color" : "White" , "cno" : "H411" , "speed" : 45.0 , "mfdcountry" : "Japan"}
{ "_id" : { "$oid" : "546cb92393f464ed49d620db"} , "name" : "Zen" , "color" : "JetRed" , "cno" : "H671" , "speed" : 67 , "mfdcountry" : "Rome"}
{ "_id" : 2.0 , "name" : "Polo" , "color" : "White"}
{ "name" : "Volkswagen" , "color" : "JetBlue" , "speed" : 62}
Polo
Это все, что касается метода MongoDB findOne(), мы рассмотрим дополнительные параметры MongoDB в следующих сообщениях. Ссылка: Официальный документ