218.5.2. 作成/更新操作

IN メッセージボディーから取得した MongoDB コレクションに新しいオブジェクトを挿入します。型変換は、Document または List に変換します。
1 つの挿入と複数の挿入の 2 つのモードがサポートされます。複数の挿入の場合、エンドポイントは、すべてのタイプのオブジェクトの List、Array、または Collections を想定し ます。例:

from("direct:insert")
    .to("mongodb3:myDb?database=flights&collection=tickets&operation=insert");

操作は WriteResult を返します。WriteConcern または invokeGetLastError オプションの値によっては、getLastError（） が呼び出されました。書き込み操作の最終的な結果にアクセスするには、WriteResult で getLastError（）または getCachedLastError （） を呼び出して CommandResult を取得する必要があります。その後、CommandResult. ok（）、CommandResult. getErrorMessage（）、および/または CommandResult.getException ( )を呼び出すことで結果を確認できます。

新しいオブジェクトの _id は、コレクションで一意である必要があることに注意してください。値を指定しない場合、MongoDB は自動的に生成します。しかし、指定して一意でない場合は、挿入操作は失敗します（Camel が通知するには、callGetLastError を有効にするか、書き込み結果を待つ WriteConcern を設定する必要があります）。

これはコンポーネントの制限ではありませんが、MongoDB でスループットを向上する方法です。カスタムの _id を使用している場合は、一意のアプリケーションレベル（およびこれが適切なプラクティスである）で確認できることが想定されます。

挿入されたレコードの OID は、 CamelMongoOid キー（MongoDbConstants.OID 定数）のメッセージヘッダーに保存されます。保存された値は、単一の挿入の場合は org.bson.types.ObjectId になり ます。複数のレコードが挿入されている場合は java.util.List<org.bson.types.ObjectId > になります。

MongoDB Java Driver 3.x では、insertOne および insertMany 操作が void を返します。Camel 挿入操作は、挿入されたドキュメントの Document または List を返します。必要に応じて、各ドキュメントが新しい OID によって更新されることに注意してください。