ドキュメントの変更

更新操作パラメータ

updateOne()メソッドとupdateMany()メソッドにはどちらも次のパラメータがあります。

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

• update は、一致するドキュメントつまたは複数のドキュメントで変更するフィールドと値を指定します。このセクションの例では、 アップデート ビルダ を使用してアップデートドキュメントを作成します。

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

次のように、 Updatesビルダを使用してupdateDocumentを作成できます。

Bson update = Updates.operator(<field>, <value>);

更新ビルダとその使用方法の完全なリストを表示するには、 APIドキュメントの「 更新 」を参照してください。

更新 1 つの例

次の例では、 qty の値が 0 である最初に一致するドキュメントの colorフィールドの値を変更する方法を示しています。

Bson filter = Filters.eq("qty", 0);
Bson update = Updates.set("color", "dandelion");
// Updates first matching document
UpdateResult result = collection.updateOne(filter, update);

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

UpdateOptions options = UpdateOptions.sort(ascending("color"));
UpdateResult result = collection.updateOne(filter, document, options);

更新の多くの例

塗料店で新しい商品を受け取ったので、在庫を更新する必要があります。 入荷には、各塗料塗料の20缶が含まれています。

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

• すべての色に一致するクエリフィルター

• qtyフィールドを20 ずつ増加させるための手順を含む更新ドキュメント

Bson filter = Filters.empty();
Bson update = Updates.inc("qty", 20);
// Updates all documents and prints the number of matched and modified documents
UpdateResult result = collection.updateMany(filter, update);
System.out.println("Matched document count: " + result.getMatchedCount());
System.out.println("Modified document count: " + result.getModifiedCount());

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

 Matched document count: 5
 Modified document count: 5

以下は、 paint_inventoryコレクション内の更新されたドキュメントを示しています。

 { "_id": 1, "color": "red", "qty": 25 }
 { "_id": 2, "color": "purple", "qty": 28 }
 { "_id": 3, "color": "yellow", "qty": 20 }
 { "_id": 4, "color": "green", "qty": 26 }
 { "_id": 5, "color": "pink", "qty": 20 }

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

操作パラメータの置換

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

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

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

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

1 つの例を置き換え

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

在庫をアップデートするには、以下を指定して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()はコレクション内のドキュメントに変更を加えません。 一致するドキュメントがない場合に、ドキュメントを置き換える代わりに新しいドキュメントを挿入する方法については、アップサート ガイドを参照してください。