io.realm

Class ObjectServerError

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.realm.ObjectServerError

All Implemented Interfaces:

Serializable

public class ObjectServerError
extends RuntimeException

See Also:

for a list of possible errors., Serialized Form

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.

This class is a wrapper for all errors happening when communicating with the Realm Object Server. This include both exceptions and protocol errors. Only getErrorCode() is guaranteed to contain a value. If the error was caused by an underlying exception getErrorMessage() is null and getException() is set, while if the error was a protocol error getErrorMessage() is set and getException() is null.

Constructor Summary

Constructors

Constructor and Description
ObjectServerError(ErrorCode errorCode, String errorMessage) Create an error caused by an error in the protocol when communicating with the Object Server.
ObjectServerError(ErrorCode errorCode, String title, String hint) Errors happening while trying to authenticate a user.
ObjectServerError(ErrorCode errorCode, String errorMessage, Throwable exception) Generic error happening that could happen anywhere.
ObjectServerError(ErrorCode errorCode, Throwable exception) Create an error caused by an an exception when communicating with the Object Server.

Method Summary

Modifier and Type	Method and Description
ErrorCode.Category	getCategory() Returns the ErrorCode.Category category for this error.
ErrorCode	getErrorCode() Returns the error code uniquely identifying this type of error.
String	getErrorMessage() Returns a more detailed error message about the cause of this error.
Throwable	getException() Returns the underlying exception causing this error, if any.
String	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

ObjectServerError

public ObjectServerError(ErrorCode errorCode,
                         String errorMessage)

Create an error caused by an error in the protocol when communicating with the Object Server.

Parameters:

errorCode - error code for this type of error.

errorMessage - detailed error message.

ObjectServerError

public ObjectServerError(ErrorCode errorCode,
                         Throwable exception)

Create an error caused by an an exception when communicating with the Object Server.

Parameters:

errorCode - error code for this type of error.

exception - underlying exception causing this error.

ObjectServerError

public ObjectServerError(ErrorCode errorCode,
                         String errorMessage,
                         Throwable exception)

Generic error happening that could happen anywhere.

Parameters:

errorCode - error code for this type of error.

errorMessage - detailed error message.

exception - underlying exception if the error was caused by this.

ObjectServerError

public ObjectServerError(ErrorCode errorCode,
                         String title,
                         String hint)

Errors happening while trying to authenticate a user.

Parameters:

errorCode - error code for this type of error.

title - Title for this type of error.

hint - a hint for resolving the error.

Method Detail

getErrorCode

public ErrorCode getErrorCode()

Returns the error code uniquely identifying this type of error.

Returns:

the error code identifying the type of error.

See Also:

ErrorCode

getErrorMessage

public String getErrorMessage()

Returns a more detailed error message about the cause of this error.

Returns:

a detailed error message or null if one was not available.

getException

public Throwable getException()

Returns the underlying exception causing this error, if any.

Returns:

the underlying exception causing this error, or null if not caused by an exception.

getCategory

public ErrorCode.Category getCategory()

Returns the ErrorCode.Category category for this error. Errors that are ErrorCode.Category.RECOVERABLE mean that it is still possible for a given SyncSession to resume synchronization. ErrorCode.Category.FATAL errors means that session has stopped and cannot be recovered.

Returns:

the error category.

toString

public String toString()

Overrides:

toString in class Throwable