copyToRealm

抽象 fun copyToRealm(obj : DeploymentRealmObject updatePolicy : UpdatePolicy = UpdatePolicy.ERROR): DicalMutableRealmObject

新しいオブジェクトを Realm にコピーするか、既存のオブジェクトを更新します。 オブジェクトの管理対象バージョンが返されます。

これにより、オブジェクトが Realm に再帰的にコピーされます。 プライマリキーを持つものとないものの両方。 プライマリキーを持つオブジェクトをコピーする動作は、指定された更新ポリシーによって異なります。 UpdatePolicy.ERRORを使用して を呼び出すと、既存のオブジェクトの更新が禁止されます。 したがって、同じプライマリキーを持つオブジェクトがすでに存在する場合は、エラーがスローされます。 これを設定すると、新しい オブジェクトのみが作成可能になります。 UpdatePolicy.ALLで を呼び出すと、一致するプライマリキーを持つ既存のオブジェクトが、すべてのプロパティを入力オブジェクトの値で更新されます。

すでに管理されている最新のオブジェクトはコピーされず、インスタンス自体が返されます。 古くなったオブジェクトをコピーしようとすると、例外がスローされます。 オブジェクトの更新された参照を取得するには、 findManyを使用します。

Return

オブジェクトの管理対象バージョン。

パラメーター

obj

コピーを作成するオブジェクト。

更新 ポリシー

オブジェクトのインポート時における更新ポリシー。

スロー

instanceのオブジェクト グラフに、すでに存在するプライマリキー値を持つオブジェクトが含まれており、 かつ 更新ポリシーがUpdatePolicy.ERRORである場合、オブジェクト グラフに以前のバージョンのオブジェクトが含まれている場合、またはプロパティが基礎のスキーマと一致しない場合。 。