io.realm

Class SyncManager

java.lang.Object

io.realm.SyncManager

public class SyncManager
extends Object

The SyncManager is the central controller for interacting with the Realm Object Server. It handles the creation of SyncSessions and it is possible to configure session defaults and the underlying network client using this class.

Through the SyncManager, it is possible to add authentication listeners. An authentication listener will response to events like user logging in or out.

Default error handling for any SyncConfiguration can be added using the SyncManager.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SyncManager.Debug Debugging related options.

Field Summary

Fields

Modifier and Type	Field and Description
static String	APP_ID APP ID sent to the Realm Object Server.
static ThreadPoolExecutor	NETWORK_POOL_EXECUTOR Thread pool used when doing network requests against the Realm Object Server.

Constructor Summary

Constructors

Constructor and Description
SyncManager()

Method Summary

Modifier and Type	Method and Description
static void	addAuthenticationListener(AuthenticationListener listener) Sets a global authentication listener that will be notified about User events like login and logout.
static SyncSession	getOrCreateSession(SyncConfiguration syncConfiguration, URI resolvedRealmURL) Gets any cached SyncSession for the given SyncConfiguration or create a new one if no one exists.
static SyncSession	getSession(SyncConfiguration syncConfiguration) Gets a cached SyncSession for the given SyncConfiguration or throw if no one exists yet.
static UserStore	getUserStore()
static void	removeAuthenticationListener(AuthenticationListener listener) Removes the provided global authentication listener.
static void	setDefaultSessionErrorHandler(SyncSession.ErrorHandler errorHandler) Sets the default error handler used by all SyncConfiguration objects when they are created.
static void	setUserStore(UserStore userStore) Set the UserStore used by the Realm Object Server to save user information.

Methods inherited from class java.lang.Object

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

Field Detail

APP_ID

public static String APP_ID

APP ID sent to the Realm Object Server. Is automatically initialized to the package name for the app.

NETWORK_POOL_EXECUTOR

public static ThreadPoolExecutor NETWORK_POOL_EXECUTOR

Thread pool used when doing network requests against the Realm Object Server.

This pool is only exposed for testing purposes and replacing it while the queue is not empty will result in undefined behaviour.

Constructor Detail

SyncManager

public SyncManager()

Method Detail

setUserStore

public static void setUserStore(UserStore userStore)

Set the UserStore used by the Realm Object Server to save user information. If no Userstore is specified SyncUser.current() will always return null.

Parameters:

userStore - UserStore to use.

Throws:

IllegalArgumentException - if userStore is null.

addAuthenticationListener

public static void addAuthenticationListener(AuthenticationListener listener)

Sets a global authentication listener that will be notified about User events like login and logout.

Parameters:

listener - listener to register.

Throws:

IllegalArgumentException - if listener is null.

removeAuthenticationListener

public static void removeAuthenticationListener(AuthenticationListener listener)

Removes the provided global authentication listener.

Parameters:

listener - listener to remove.

setDefaultSessionErrorHandler

public static void setDefaultSessionErrorHandler(SyncSession.ErrorHandler errorHandler)

Sets the default error handler used by all SyncConfiguration objects when they are created.

Parameters:

errorHandler - the default error handler used when interacting with a Realm managed by a Realm Object Server.

getSession

public static SyncSession getSession(SyncConfiguration syncConfiguration)
                              throws IllegalStateException

Gets a cached SyncSession for the given SyncConfiguration or throw if no one exists yet. A session should exist after you open a Realm with a SyncConfiguration.

Parameters:

syncConfiguration - configuration object for the synchronized Realm.

Returns:

the SyncSession for the specified Realm.

Throws:

IllegalArgumentException - if syncConfiguration is null.

IllegalStateException - if the session could not be found using the provided SyncConfiguration.

getOrCreateSession

public static SyncSession getOrCreateSession(SyncConfiguration syncConfiguration,
                                             URI resolvedRealmURL)

Gets any cached SyncSession for the given SyncConfiguration or create a new one if no one exists. Note: This is mainly for internal usage, consider using getSession(SyncConfiguration) instead.

Parameters:

syncConfiguration - configuration object for the synchronized Realm.

resolvedRealmURL - resolved Realm URL with the user specific part if not a global Realm.

Returns:

the SyncSession for the specified Realm.

Throws:

IllegalArgumentException - if syncConfiguration is null.

getUserStore

public static UserStore getUserStore()