安装包 io.realm.mongodb.sync

类同步

java.lang.Object

io.realm.mongodb.sync.Sync

公共抽象类Sync扩展了对象

同步经理，用于处理本地 Realm 与远程 Realm 应用的同步。

其主要角色是访问已同步 Realm 的SyncSession 。打开同步 Realm 后，您可以访问SyncSession并执行同步相关操作，如下所示：

     App app = new App("应用程序 ID"); User user = app.login(Credentials.anonymous()); SyncConfiguration syncConfiguration = new SyncConfiguration.Builder(user, "<partition value>") .build(); Realm 实例 = Realm.getInstance(syncConfiguration); SyncSession session = app.getSync().getSession(syncConfiguration); 实例.executeTransaction(域 -> { 域.insert(...); }); session.uploadAllLocalChanges(); 实例.close();
 

另请参阅：

App.getSync()， getSession(SyncConfiguration)

嵌套类摘要

嵌套类

修饰符和类型	class	说明
static class	Sync.Debug	调试相关选项。

方法摘要

修饰符和类型	方法	说明
Collection<SyncSession>	getAllSessions()	获取所有缓存的SyncSession的collection。
SyncSession	getOrCreateSession(SyncConfiguration syncConfiguration)	获取给定 的任何缓存的SyncSession SyncConfiguration，如果不存在，则创建一个新缓存。
SyncSession	getSession(SyncConfiguration syncConfiguration)	获取给定 的缓存SyncSession SyncConfiguration，如果尚不存在，则抛出异常。
void	reconnect()	Realm 会自动检测设备何时在离线后恢复连接并恢复同步。

从类 java.lang.继承的方法对象

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

getSession

public SyncSession getSession( SyncConfiguration syncConfiguration) 抛出IllegalStateException

获取给定 的缓存 ，如果尚不存在，则抛出异常。在您使用SyncSession 打开SyncConfigurationSyncConfiguration Realm 后，应存在一个会话。

参数：

syncConfiguration — 同步 Realm 的配置对象。

返回：

指定 Realm 的SyncSession 。

抛出异常：

IllegalArgumentException - 如果 syncConfiguration 为null 。

IllegalStateException - 如果使用提供的SyncConfiguration找不到会话。

getAllSessions

public Collection < SyncSession > getAllSessions()

获取所有缓存的SyncSession的collection。

返回：

collection的SyncSession。

getOrCreateSession

public SyncSession getOrCreateSession( SyncConfiguration syncConfiguration)

获取给定 的任何缓存的SyncSession SyncConfiguration，如果不存在，则创建一个新缓存。注意：这主要供内部使用，请考虑改用getSession(SyncConfiguration) 。

参数：

syncConfiguration — 同步 Realm 的配置对象。

返回：

指定 Realm 的SyncSession 。

抛出异常：

IllegalArgumentException - 如果 syncConfiguration 为null 。

重新连接

public void reconnect()

Realm 会自动检测设备何时在离线后恢复连接并恢复同步。

但是，由于其中一些检查是使用增量退避来执行的，因此在某些情况下这不会立即发生。

在这些情况下，手动调用此方法可能会有好处，这将强制所有会话立即尝试重新连接，并重置它们用于增量退避的任何计时器。