io.realm

Class SyncConfiguration

java.lang.Object

io.realm.RealmConfiguration

io.realm.SyncConfiguration

public final class SyncConfiguration
extends RealmConfiguration

This software is considered in beta phase. It indicates that any public interface can change without prior announcements. Moreover, classes, constructors, and methods annotated as beta are not considered at production quality, and should be used with care.

An SyncConfiguration is used to setup a Realm that can be synchronized between devices using the Realm Object Server.

A valid SyncUser is required to create a SyncConfiguration. See SyncCredentials and SyncUser.loginAsync(SyncCredentials, String, SyncUser.Callback) for more information on how to get a user object.

A minimal SyncConfiguration can be found below.

 
 SyncConfiguration config = new SyncConfiguration.Builder(context)
   .serverUrl("realm://objectserver.realm.io/~/default")
   .user(myUser)
   .build();
 
 

Synchronized Realms only support additive migrations which can be detected and performed automatically, so the following builder options are not accessible compared to a normal Realm:

• deleteRealmIfMigrationNeeded()
• schemaVersion(long version)
• migration(Migration)

Synchronized Realms are created by using Realm.getInstance(RealmConfiguration) and Realm.getDefaultInstance() like ordinary unsynchronized Realms.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SyncConfiguration.Builder Builder used to construct instances of a SyncConfiguration in a fluent manner.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_FILE_NAME_LENGTH
static int	MAX_FULL_PATH_LENGTH
static int	PORT_REALM
static int	PORT_REALMS

Fields inherited from class io.realm.RealmConfiguration

DEFAULT_REALM_NAME, KEY_LENGTH

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
SyncSession.ErrorHandler	getErrorHandler()
URI	getServerUrl() Returns the fully disambiguated URI for the remote Realm i.e., the /~/ placeholder has been replaced by the proper user ID.
SyncUser	getUser() Returns the user.
int	hashCode()
boolean	shouldDeleteRealmOnLogout() Returns true if the Realm file must be deleted once the SyncUser owning it logs out.
String	toString()

Methods inherited from class io.realm.RealmConfiguration

getDurability, getEncryptionKey, getMigration, getPath, getRealmDirectory, getRealmFileName, getRealmObjectClasses, getRxFactory, getSchemaVersion, shouldDeleteRealmIfMigrationNeeded

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

PORT_REALM

public static final int PORT_REALM

See Also:

Constant Field Values

PORT_REALMS

public static final int PORT_REALMS

See Also:

Constant Field Values

MAX_FULL_PATH_LENGTH

public static final int MAX_FULL_PATH_LENGTH

See Also:

Constant Field Values

MAX_FILE_NAME_LENGTH

public static final int MAX_FILE_NAME_LENGTH

See Also:

Constant Field Values

Method Detail

equals

public boolean equals(Object o)

Overrides:

equals in class RealmConfiguration

hashCode

public int hashCode()

Overrides:

hashCode in class RealmConfiguration

toString

public String toString()

Overrides:

toString in class RealmConfiguration

getUser

public SyncUser getUser()

Returns the user.

Returns:

the user.

getServerUrl

public URI getServerUrl()

Returns the fully disambiguated URI for the remote Realm i.e., the /~/ placeholder has been replaced by the proper user ID.

Returns:

URI identifying the remote Realm this local Realm is synchronized with.

getErrorHandler

public SyncSession.ErrorHandler getErrorHandler()

shouldDeleteRealmOnLogout

public boolean shouldDeleteRealmOnLogout()

Returns true if the Realm file must be deleted once the SyncUser owning it logs out.

Returns:

true if the Realm file must be deleted if the SyncUser logs out. false if the file is allowed to remain behind.