在单个操作中插入或更新
此版本的文档已存档，不再提供支持。 查看 最新文档，学习；了解如何升级您的Java驱动程序版本。
Overview
通过本指南，您可以了解如何使用 MongoDB Java 驱动程序执行更新或插入。
应用程序使用插入和更新操作来存储和修改数据。有时，您需要根据文档是否存在，在插入和更新操作之间进行选择。MongoDB通过 upsert 更新或插入选项帮助我们简化了决策流程。
An upsert:
更新与查询过滤器相匹配的文档
如果没有与查询过滤器匹配的项，则插入一个文档
指定更新或插入
要使用 updateOne() 或 updateMany() 方法指定 upsert，请将 true 传递给 UpdateOptions.upsert()。
要使用 replaceOne() 方法指定更新或插入，请将 true 传递给 ReplaceOptions.upsert() 。
在以下示例中，一家油漆店销售八种不同颜色的油漆。这家商店举行了一年一度的网上促销活动。他们的 paint_inventory 集合现在显示以下文档：
{ "_id": { "$oid": "606b4cfbcd83be7518b958da" }, "color": "red", "qty": 5 } { "_id": { "$oid": "606b4cfbcd83be7518b958db" }, "color": "purple", "qty": 8 } { "_id": { "$oid": "606b4cfbcd83be7518b958dc" }, "color": "blue", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958dd" }, "color": "white", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958de" }, "color": "yellow", "qty": 6 } { "_id": { "$oid": "606b4cfbcd83be7518b958df" }, "color": "pink", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958e0" }, "color": "green", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958e1" }, "color": "black", "qty": 8 }
商店收到了新的货物，需要更新其库存。第一批货物是十罐橙色油漆。
要更新此清单，请查询 paint_inventory 集合（其中 color 为 "orange"），指定一个更新以便将 qty 字段increment 10，然后将 UpdateOptions.upsert() 指定为 true：
// Creates a filter and update document to increment the matching document's "qty" value Bson filter = Filters.eq("color", "orange"); Bson update = Updates.inc("qty", 10); // Updates the matching document or inserts a document if none match the query filter UpdateOptions options = new UpdateOptions().upsert(true); System.out.println(collection.updateOne(filter, update, options));
该方法返回：
AcknowledgedUpdateResult{ matchedCount=0, modifiedCount=0, upsertedId=BsonObjectId{ value=606b4cfc1601f9443b5d6978 }}
此 AcknowledgedUpdateResult 告诉我们：
与查询筛选器匹配的文档数为零
集合中无任何文档被修改
一份
_id为606b4cfc1601f9443b5d6978的文档更新或插入
下面显示了 paint_inventory 集合中的文档：
{ "_id": { "$oid": "606b4cfbcd83be7518b958da" }, "color": "red", "qty": 5 } { "_id": { "$oid": "606b4cfbcd83be7518b958db" }, "color": "purple", "qty": 8 } { "_id": { "$oid": "606b4cfbcd83be7518b958dc" }, "color": "blue", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958dd" }, "color": "white", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958de" }, "color": "yellow", "qty": 6 } { "_id": { "$oid": "606b4cfbcd83be7518b958df" }, "color": "pink", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958e0" }, "color": "green", "qty": 0 } { "_id": { "$oid": "606b4cfbcd83be7518b958e1" }, "color": "black", "qty": 8 } { "_id": { "$oid": "606b4cfc1601f9443b5d6978" }, "color": "orange", "qty": 10 }]
注意
不包括 UpdateOptions 不会导致集合发生任何变化。
Bson filter = Filters.eq("color", "orange"); Bson update = Updates.inc("qty", 10); System.out.println(collection.updateOne(filter, update));
该方法返回：
AcknowledgedUpdateResult{ matchedCount=0, modifiedCount=0, upsertedId=null }
有关本节中提到的方法和类的详情，请参阅以下 API 文档：