mongodb dirver for java【写入操作】

环境

MongoDB：3.+
mongodb dirver for Java: 3.+
@author：喻涛

概要

本篇是翻译官网：
https://mongodb.github.io/mongo-java-driver/3.4/driver/tutorials/perform-write-operations/

讲解的是用java代码对MongoDB进行写入操作。

写入操作（插入、更新、替换、删除）

执行写入操作为了插入新文档到集合中，更新集合中已有的文档或者多个文档、在集合中替换已有的文档、或者从集合中删除一个或多个文档。

先决条件

在test数据库中要有一个restaurants集合。
（你可以使用你本地的测试环境中的集合，来做下面的测试）

可能需要import的声明：

 import com.mongodb.*; import com.mongodb.MongoClient; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import com.mongodb.client.model.Filters; import static com.mongodb.client.model.Filters.*; import static com.mongodb.client.model.Updates.*; import com.mongodb.client.model.UpdateOptions; import com.mongodb.client.result.*; import org.bson.Document; import org.bson.types.ObjectId; import java.util.List; import java.util.Arrays; import java.util.ArrayList;

连接数据库

这里我贴出我自己的代码：

            //连接数据库 start            MongoCredential credential =             //根据自己的情况修改            MongoCredential.createCredential("gg_openapi",             "gg_openapi", "gg..openapi#!".toCharArray());            //根据自己的情况修改            serverAddress = new ServerAddress("106.75.51.20", 35520);            List<ServerAddress> addrs = new ArrayList<ServerAddress>();            addrs.add(serverAddress);            List<MongoCredential> credentials = new ArrayList<MongoCredential>();            credentials.add(credential);            @SuppressWarnings("resource")            MongoClient mongoClient = new MongoClient(addrs, credentials);            MongoDatabase database = mongoClient.getDatabase("gg_openapi");            System.out.println("Connect to database successfully");            //连接数据库 end

insert 新文档

为了在集合中插入一个文档，可以使用集合中的insertOne()方法。

Document document = new Document("name", "Café Con Leche")      .append("contact", new Document("phone", "228-555-0149")      .append("email", "[e-mail]")      .append("location",Arrays.asList(-73.92502, 40.8279556)))      .append("stars", 3)      .append("categories", Arrays.asList("Bakery", "Coffee", "Pastries"));collection.insertOne(document);

如果没有指定主键_id字段，java驱动程序会自动添加_id字段插入到文档中。

insert 多个文档

要添加多个文档，你可以使用集合中的方法insertMany()方法，该方法会插入一组文档。

下面例子是插入两个文档：

Document doc1 = new Document("name", "Amarcord Pizzeria")    .append("contact", new Document("phone", "264-555-0193")    .append("email", "[e-mail]")    .append("location",Arrays.asList(-73.88502, 40.749556)))    .append("stars", 2)    .append("categories", Arrays.asList("Pizzeria", "Italian", "Pasta"));Document doc2 = new Document("name", "Blue Coffee Bar")    .append("contact", new Document("phone", "604-555-0102")    .append("email", "[e-mail]")    .append("location",Arrays.asList(-73.97902, 40.8479556)))    .append("stars", 5)    .append("categories", Arrays.asList("Coffee", "Pastries"));List<Document> documents = new ArrayList<Document>();documents.add(doc1);documents.add(doc2);collection.insertMany(documents);

如果没有指定主键_id字段，java驱动程序会自动添加_id字段插入到文档中。

update 已有文档

为了在集合中更新已有的文档，你可以使用updateOne()或updateMany方法。

Filters

你可以给这个方法传入一个过滤器文档来指定要更新哪些文档。过滤器文档格式和read operations中一样。
这里也可以参考我翻译文章：mongodb dirver for java【读取操作】

为了方便创建过滤对象，java驱动程序提供了Filters助手。

要指定空的过滤器（也就是查询全部的文档），可以使用空的Document对象。

update 操作符

要在一个文档中更新一个字段，MongoDB提供了update operators，要指定使用更新操作符的修改，需要使用更新文档。

为了方便创建更新格式的文档，java驱动程序提供了Updates类，

在update时，_id是不可变的，你不能修改_id字段的值。

update 一个文档

即使过滤器匹配到了多个文档，updateOne()方法最多只更新一个文档。

下面的操作是对_id为ObjectId("57506d62f57802807471dd41")进行更新。

collection.updateOne(    eq("_id", new ObjectId("57506d62f57802807471dd41")),    combine(set("stars", 1), set("contact.phone", "228-555-9999"),           currentDate("lastModified")));

说明：

Updates.set：设置字段stars为1和字段contact.phone为228-555-9999。
Updates.currentDate：将字段lastModified修改为当前时间。
如果字段lastModified不存在，该操作会将这个字段添加到文档中去。

在某些情况下，你可能需要更新多个字段，这时使用replace会更有效。
请参考：Replace a Document.

update 多个文档

updateMany方法会更新匹配到的所有文档。

下面操作是对字段stars等于2的所有的文档进行更新。

collection.updateMany(              eq("stars", 2),              combine(set("stars", 0), currentDate("lastModified")));

说明 ：

①Updates.set：将字段stars的值设置为0，并且
②Updates.currentDate：将字段lastModified的值设置为当前时间，如果字段lastModified不存在，该操作将其添加进文档。

Update 选项

使用updateOne()和updateMany方法时，你可以使用包含UpdateOptions格式的文档来指定upsert选项或者bypassDocumentationValidation选项。

collection.updateOne(                eq("_id", 1),                combine(set("name", "Fresh Breads and Tulips"),                 currentDate("lastModified")),          new UpdateOptions().upsert(true).bypassDocumentValidation(true));

说明：
①upsert：true，要是文档中没有，就创建一个新的文档。默认为false。
②bypassDocumentationValidation：是否绕过文档验证。

replace 已有的文档

为了替换在集合中已有的文档，你可以使用集合中replaceOne方法。

_id字段是不可变的，你不能替换_id字段的值。

Filters

你可以传递一个过滤器来指定要替换的文档。
过滤器文档格式和read operations中一样。
这里也可以参考我翻译文章：mongodb dirver for java【读取操作】

为了方便创建过滤对象，java驱动程序提供了Filters助手。

要指定一个空的过滤器（也就是匹配全部文档）， 可以使用空的Document对象。
这里的空指的是：Document document = new Document();

即使过滤条件匹配到了多个文档，replaceOne方法最多也就替换一个。

replace 一个文档

要替换一个文档，请传入一个新文档给replaceOne方法。

替换文档可以具有与原始文档不同的字段。在替换文档中，你可以忽略字段_id，因为字段_id是不可变的。然而，如果你包含了字段_id字段，你不能指定不同的的。说白了，以前_id值是多少，你传入的也要和它相同。

下面代码是对_id：ObjectId(“57506d62f57802807471dd41”)进行替换。

collection.replaceOne(         eq("_id", new ObjectId("57506d62f57802807471dd41")),         new Document("name", "Green Salads Buffet")         .append("contact", "TBD")         .append("categories", Arrays.asList("Salads", "Health Foods", "Buffet")));

另请参考：Update a Document.

update 选项

使用replaceOne方法时，你可以指定一个UpdateOptions文档对象，来指定upsert选项和bypassDocumentationValidation选项。

results = collection.replaceOne(     eq("name", "Orange Patisserie and Gelateria"),     new Document("stars", 5)     .append("contact", "TBD")     .append("categories", Arrays.asList("Cafe", "Pastries", "Ice Cream")),     new UpdateOptions().upsert(true).bypassDocumentValidation(true));

说明：
①upsert：true，要是文档中没有，就创建一个新的文档。默认为false。
②bypassDocumentationValidation：是否绕过文档验证。

Delete 文档

要在集合中删除文档，你可以使用deleteOne和deleteMany方法。

Filters

你可以给删除方法传递一个过滤器文档对象来指定要删除的文档。

过滤器文档格式和read operations中一样。
这里也可以参考我翻译文章：mongodb dirver for java【读取操作】

为了方便创建过滤对象，java驱动程序提供了Filters助手。

要指定一个空的过滤器（也就是匹配全部文档）， 可以使用空的Document对象。
这里的空指的是：Document document = new Document();

删除 一个文档

即使过滤条件匹配多个文档，deleteOne方法最多删除一个文档。

下面代码对_id：ObjectId("57506d62f57802807471dd41")的文档进行删除：

collection.deleteOne(eq("_id", new ObjectId("57506d62f57802807471dd41")));

删除 多个文档

deleteMany方法会删除匹配到的全部文档。
下面的操作是删除字段stars等于4的全部文档。

collection.deleteMany(eq("stars", 4));

Write Concern

Write Concern 描述了MongoDB写入操作要求的确认级别。

应用程序可以在三个层次中配置Write Concern。

一、在MongoClient()
①通过MongoClientOptions，如下所示：

MongoClientOptions options = MongoClientOptions.builder()            .writeConcern(WriteConcern.MAJORITY).build();MongoClient mongoClient = new MongoClient(Arrays.asList(            new ServerAddress("host1", 27017),            new ServerAddress("host1", 27018)), options);

②通过MongoClientURI，如下所示：

 MongoClient mongoClient = new MongoClient( new MongoClientURI("mongodb://host1:27017,host2:27017/?w=majority"));

二、在MongoDatabase中通过withWriteConcern方法，如下所示：

 MongoDatabase database =  mongoClient.getDatabase("test").withWriteConcern(WriteConcern.MAJORITY);

三、在MongoCollection中通过withWriteConcern方法，如下所示：

MongoCollection<Document> collection = database.getCollection("restaurants").withWriteConcern(WriteConcern.MAJORITY);

注意：

MongoDatabase和MongoCollection实例是不可变的。
在已存在的MongoDatabase和MongoCollection实例中调用withReadPreference()方法会返回一个新的实例并不影响调用该方法的实例。

例如，下面代码，collWithWriteConcern实例的write concern为majority而collection的write concern是不是影响的。

你可以构建MongoClientOptions，MongoDatabase或者MongoCollection来包含write concern、read concern和read preference的组合。
如下所示：

collection = database.getCollection("restaurants")                .withReadPreference(ReadPreference.primary())                .withReadConcern(ReadConcern.MAJORITY)                .withWriteConcern(WriteConcern.MAJORITY);

总结

在驱动程序2+中，其实是有insert()和update()方法。
在3+中，已经没有了有的只是：

insertOne()insertMany()updateOne()updateMany()

可以说变化是非常大，因为里面的参数都变成了Bson类型。