Docs 菜单
Docs 主页
/ /
Atlas Device SDKs
/ / /

接口 SyncSession.ClientResetHandler

在此页面上

  • io.realm.mongodb.sync
  • 继承方法

实现的接口:

封装类:

SyncSession

针对称为“客户端重置”的特定错误事件的回调,由错误代码ErrorCode.CLIENT_RESET确定。

同步的 Realm 可能需要重置,因为 MongoDB Realm Server 遇到错误,必须从备份中恢复,或者因为客户端连接到服务器已经太长时间,因此服务器已轮换日志。

由于服务器没有使客户端完全更新所需的完整信息,因此会发生客户端重置。

重置过程如下:将 Realm 的本地副本复制到恢复目录以妥善保管,然后从原始位置删除。 下次打开该 URL 的 Realm 时,将自动从 MongoDB Realm 重新下载该 Realm,并且可以正常使用。

在 Realm 的本地副本与备份远程副本分离后,写入 Realm 的数据将存在于 Realm 文件的本地恢复副本中。 重新下载的 Realm 最初仅包含在服务器上备份 Realm 时存在的数据。

可以通过以下两种方式之一启动客户端重置过程:

  1. 手动运行ClientResetRequiredError.executeClientReset() 。 在调用此方法之前,必须关闭所有 Realm 实例。

  2. 如果未手动执行客户端重置,则下次关闭并重新打开所有 Realm 实例时将自动执行客户端重置。 这很可能发生在应用重新启动时。

警告:在此回调和执行客户端重置之间对Realm 文件的任何写入都不会同步到MongoDB Realm。 这些更改将仅存在于备份文件中。 因此,建议尽快关闭所有打开的Realm实例。

后退

SyncSession