插入文档
此版本的文档已存档,不再提供支持。查看最新文档,学习;了解如何升级您的Java驱动程序版本。
您可以使用 MongoCollection
对象上的insertOne()
方法,将单个文档插入集合中。要插入文档,请构建一个 Document
对象,其中包含待存储的字段和值。若对一个尚不存在的集合调用 insertOne()
方法,服务器会自动创建该集合。
成功插入后,insertOne()
会返回 InsertOneResult
的实例。您可以通过对 InsertOneResult
实例调用 getInsertedId()
方法来检索信息,例如所插入文档的 _id
字段。
如果插入操作失败,驱动程序会引发异常。 有关特定条件下引发的异常类型的更多信息,请参阅本页底部链接的insertOne()
的 API 文档。
例子
以下代码片段用于在 movies
集合中插入单个文档。
注意
此示例使用连接 URI 连接到MongoDB实例。 要学习;了解有关连接到MongoDB实例的更多信息,请参阅连接指南。
package usage.examples; import java.util.Arrays; import org.bson.Document; import org.bson.types.ObjectId; import com.mongodb.MongoException; import com.mongodb.client.MongoClient; import com.mongodb.client.MongoClients; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import com.mongodb.client.result.InsertOneResult; public class InsertOne { public static void main(String[] args) { // Replace the uri string with your MongoDB deployment's connection string String uri = "<connection string uri>"; try (MongoClient mongoClient = MongoClients.create(uri)) { MongoDatabase database = mongoClient.getDatabase("sample_mflix"); MongoCollection<Document> collection = database.getCollection("movies"); try { InsertOneResult result = collection.insertOne(new Document() .append("_id", new ObjectId()) .append("title", "Ski Bloopers") .append("genres", Arrays.asList("Documentary", "Comedy"))); System.out.println("Success! Inserted document id: " + result.getInsertedId()); } catch (MongoException me) { System.err.println("Unable to insert due to an error: " + me); } } } }
运行该示例时,应看到类似于以下内容的输出,其中“值”字段中包含插入文档的 ObjectId
:
Inserted document id: BsonObjectId{value=...}
有关此页面上提及的类和方法的更多信息,请参阅以下 API 文档: