ドキュメントの置換

操作パラメータの置換

replaceOne() メソッドには次のパラメーターがあります。

• query は、コレクション内の置き換えドキュメントと一致するための 条件でクエリフィルター を指定します。

• replacement は、一致したドキュメントを置き換える新しい Documentオブジェクトのフィールドと値を指定します。

• （任意） replaceOptions は、ドライバーが置換操作を実行する方法をカスタマイズするために設定できるオプションを指定します。このタイプの詳細については、ReplaceOptions のAPIドキュメントを参照してください。

1 つの例を置き換え

この例では、塗料店で 5 色の塗料を販売しています。paint_inventoryコレクションは現在の在庫を表します。

{ "_id": 1, "color": "red", "qty": 5 }
{ "_id": 2, "color": "purple", "qty": 8 }
{ "_id": 3, "color": "yellow", "qty": 0 }
{ "_id": 4, "color": "green", "qty": 6 }
{ "_id": 5, "color": "pink", "qty": 0 }

塗料店では、在庫を再度更新する必要があることが認識されています。 ページ内を表示

在庫をアップデートするには、以下を指定してreplaceOne()メソッドを呼び出します。

• colorが「pink」であるドキュメントに一致するクエリフィルター

• colorが "Orange" で、 qtyが " 25である置換ドキュメント

Bson filter = Filters.eq("color", "pink");
Document document = new Document("color", "orange").append("qty", 25);
// Replaces the first document that matches the filter with a new document
UpdateResult result = collection.replaceOne(filter, document);
// Prints the number of matched and modified documents
System.out.println("Matched document count: " + result.getMatchedCount());
System.out.println("Modified document count: " + result.getModifiedCount());

上記のコードの出力は、次のようになります。

 Matched document count: 1
 Modified document count: 1

以下は更新されたドキュメントを示しています。

 { "_id": 5, "color": "orange", "qty": 25 }

複数のドキュメントが replaceOne() メソッドで指定されたクエリフィルターに一致する場合は、最初の結果が置き換えられます。次のコードに示すように、サーバーが置換操作を実行する前に、一致したドキュメントに順序を適用するために、ReplaceOptionsインスタンスで並べ替えを指定できます。

ReplaceOptions options = ReplaceOptions.sort(ascending("qty"));
UpdateResult result = collection.replaceOne(filter, document, options);

置換操作でクエリクエリフィルターに一致するドキュメントがない場合、replaceOne() はコレクション内のドキュメントに変更を加えません。一致するドキュメントがない場合に、ドキュメントを置き換える代わりに新しいドキュメントを挿入する方法については、アップサートガイドをご覧ください。