插入多个文档
您可以通过调用对象上的insertMany()
MongoCollection
方法,在单个操作中将多个文档插入到一个collection中。要插入它们,请将Document
对象添加到List
中,并将List
作为参数传递给insertMany()
。 如果对尚不存在的集合调用insertMany()
方法,服务器则会创建该集合。
插入成功后, insertMany()
会返回InsertManyResult
的实例。 您可以通过对实例InsertManyResult
调用getInsertedIds()
方法来检索信息,例如所插入文档的_id
字段。
如果插入操作失败,驱动程序会引发异常。 有关特定条件下引发的异常类型的更多信息,请参阅本页底部链接的insertMany()
的 API 文档。
例子
以下代码段将多个文档插入到movies
collection中。
注意
此示例使用连接 URI 连接到MongoDB实例。 要学习;了解有关连接到MongoDB实例的更多信息,请参阅连接指南。
// Inserts sample documents describing movies by using the Java driver package usage.examples; import java.util.Arrays; import java.util.List; import org.bson.Document; 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.InsertManyResult; public class InsertMany { 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"); // Creates two sample documents containing a "title" field List<Document> movieList = Arrays.asList( new Document().append("title", "Short Circuit 3"), new Document().append("title", "The Lego Frozen Movie")); try { // Inserts sample documents describing movies into the collection InsertManyResult result = collection.insertMany(movieList); // Prints the IDs of the inserted documents System.out.println("Inserted document ids: " + result.getInsertedIds()); // Prints a message if any exceptions occur during the operation } catch (MongoException me) { System.err.println("Unable to insert due to an error: " + me); } } } }
运行该示例时,应看到类似于以下内容的输出,其中每个“值”字段中包含插入文档的 ObjectId
值:
Inserted document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}
有关此页面上提及的类和方法的更多信息,请参阅以下 API 文档: