copy Realm

摘要 乐趣 copyToRealm(obj : DynamicRealmObject , updatePolicy : UpdatePolicy = UpdatePolicy.ERROR): DynamicMutableRealmObject

将新对象复制到 Realm 中或更新现有对象。 将返回对象的托管版本。

这会将对象递归复制到 Realm。 带主键和不带主键的主键。 复制具有主键的对象的行为取决于指定的更新策略。 使用UpdatePolicy.ERROR进行调用将禁止更新现有对象。 因此,如果已存在具有相同主键的对象,则会引发错误。 因此,设置此项意味着只能创建新对象。 使用UpdatePolicy.ALL进行调用意味着具有匹配主键的现有对象的所有属性将使用输入对象的值进行更新。

已经托管的最新对象不会被复制,而只是返回实例本身。 尝试复制过时的对象会引发异常。 要获取对象的更新引用,请使用findLatest

返回

obj的托管版本。

参数

obj

要从中创建副本的对象。

更新 策略

导入对象时更新策略。

抛出异常

如果instance的对象图包含主键值已存在的对象且更新策略为UpdatePolicy.ERROR 、如果对象图包含先前版本的对象或者属性与底层模式不匹配。