SyncSession

A session controls how data is synchronized between a single Realm on the device and MongoDB on the server.

A SyncSession is created by opening a Realm instance using a SyncConfiguration. Once a session has been created, it will continue to exist until the app is closed or the Realm is closed.

A session is controlled by Realm, but can provide additional information in case of errors. These errors are passed along in the ErrorHandler.

When creating a session, Realm will establish a connection to the server. This connection is controlled by Realm and might be shared between multiple sessions.

The session itself has a different lifecycle than the underlying connection.

The SyncSession object is thread safe.

Types

ErrorHandler

fun fun interface ErrorHandler

Interface used to report any session errors.

State

enum State : Enum<SyncSession.State>

The possible states for SyncSession to be.

Functions

downloadAllServerChanges

abstract suspend fun downloadAllServerChanges(timeout: Duration = Duration.INFINITE): Boolean

Calling this method will block until all known remote changes have been downloaded and applied to the Realm or the specified timeout is hit.

pause

abstract fun pause()

Pauses synchronization with Atlas until the Realm is closed and re-opened again.

resume

abstract fun resume()

Attempts to resume the session and activate synchronization with Atlas.

uploadAllLocalChanges

abstract suspend fun uploadAllLocalChanges(timeout: Duration = Duration.INFINITE): Boolean

Calling this method will block until all known local changes have been uploaded to the server or the specified timeout is hit.

Properties

state

abstract val state: SyncSession.State

The current session state.