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.

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	getSession(SyncConfiguration syncConfiguration) Gets any cached SyncSession for the given SyncConfiguration or create a new one if no one exists.
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.

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.currentUser() 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)

Gets any cached SyncSession for the given SyncConfiguration or create a new one if no one exists.

Parameters:

syncConfiguration - configuration object for the synchronized Realm.

Returns:

the SyncSession for the specified Realm.

Throws:

IllegalArgumentException - if syncConfiguration is null.