copy
抽象 fun <t : RealmObject> copyToRealm(instance : T 、 updatePolicy : UpdatePolicy = UpdatePolicy.ERROR): t
新しいオブジェクトを Realm にコピーするか、既存のオブジェクトを更新します。
これにより、オブジェクトが Realm に再帰的にコピーされます。 プライマリキーを持つものとないものの両方。 プライマリキーを持つオブジェクトをコピーする動作は、指定された更新ポリシーによって異なります。 UpdatePolicy.ERRORを使用して を呼び出すと、既存のオブジェクトの更新が禁止されます。 したがって、同じプライマリキーを持つオブジェクトがすでに存在する場合は、エラーがスローされます。 これを設定すると、新しい オブジェクトのみが作成可能になります。 UpdatePolicy.ALLを使用して を呼び出すと、一致するプライマリキーを持つ既存のオブジェクトが、すべてのプロパティを入力オブジェクトの値で更新されます。
すでに管理されている更新ためのオブジェクトはコピーされず、インスタンス自体が返されます。 古くなったオブジェクトをコピーしようとすると、例外がスローされます。 オブジェクトの更新された参照を取得するには、 findManyを使用します。
Return
instanceの管理対象バージョン。
パラメーター
インスタンス
コピーを作成するオブジェクト。
更新
オブジェクトのインポート時における更新ポリシー。
スロー
instanceのオブジェクト グラフに、プライマリキー値がすでに存在するオブジェクトが含まれており、更新ポリシーがUpdatePolicy.ERRORである場合、またはオブジェクト グラフに以前のバージョンのオブジェクトが含まれている場合。