io.realm

Class ClientResetRequiredError

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.realm.ObjectServerError

io.realm.ClientResetRequiredError

All Implemented Interfaces:

Serializable

public class ClientResetRequiredError
extends ObjectServerError

Class encapsulating information needed for handling a Client Reset event.

See Also:

for more information about when and why Client Reset occurs and how to deal with it., Serialized Form

Constructor Summary

Constructors

Constructor and Description
ClientResetRequiredError(ErrorCode errorCode, String errorMessage, String backupFilePath, RealmConfiguration configuration)

Method Summary

Modifier and Type	Method and Description
void	executeClientReset() Calling this method will execute the Client Reset manually instead of waiting until next app restart.
File	getBackupFile() Returns the location of the backed up Realm file.
File	getOriginalFile() Returns the location of the original Realm file.

Methods inherited from class io.realm.ObjectServerError

getCategory, getErrorCode, getErrorMessage, getException, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientResetRequiredError

public ClientResetRequiredError(ErrorCode errorCode,
                                String errorMessage,
                                String backupFilePath,
                                RealmConfiguration configuration)

Method Detail

executeClientReset

public void executeClientReset()

Calling this method will execute the Client Reset manually instead of waiting until next app restart. This will only be possible if all instances of that Realm have been closed, otherwise a IllegalStateException will be thrown.

After this method returns, the backup file can be found in the location returned by getBackupFile(). The file at getOriginalFile() have been deleted, but will be recreated from scratch next time a Realm instance is opened.

Throws:

IllegalStateException - if not all instances have been closed.

getBackupFile

public File getBackupFile()

Returns the location of the backed up Realm file. The file will not be present until the Client Reset has been fully executed.

Returns:

a reference to the location of the backup file once Client Reset has been executed. Use file.exists() to check if the file exists or not.

getOriginalFile

public File getOriginalFile()

Returns the location of the original Realm file. After the Client Reset has completed, the file at this location will be deleted.

Returns:

a reference to the location of the original Realm file. After Client Reset has been executed this file will no longer exists. Use file.exists() to check this.