public enum ConnectState extends java.lang.Enum<ConnectState>
GluonObservable
can be in while a DataProvider
operation is in progress. All
observables begin in the READY
state. When the operation is started, the observable will enter the
RUNNING
state. Finally, depending on the operation outcome, the observable will always enter one of the
following states: SUCCEEDED
, FAILED
, REMOVED
or CANCELLED
. When
an exception was thrown during the operation, it will enter the FAILED
state. When the observable is a
GluonObservableObject
and it is passed in as a parameter to the remove method
,
then the object will enter the REMOVED
state when the remove operation succeeded successfully. When the
operation was cancelled, the state of the observable will be changed to CANCELLED
. Signaling the
cancellation of an operation is done by throwing a CancellationException
. In all other
cases, the state will become SUCCEEDED
.Enum Constant and Description |
---|
CANCELLED
A GluonObservable object in the
CANCELLED state signals that the last
executed synchronization operation was cancelled. |
FAILED
A GluonObservable object in the
FAILED state signals that the last
executed synchronization operation failed. |
READY
This is the initial state of a new GluonObservable object.
|
REMOVED
A GluonObservable object in the
REMOVED state signals that it is
successfully removed after executing the DataProvider.removeObject(GluonObservableObject, ObjectDataRemover) remove operation}. |
RUNNING
A GluonObservable object in the
RUNNING state means that a
synchronization operation is currently in progress. |
SUCCEEDED
A GluonObservable object in the
SUCCEEDED state signals that the last
executed synchronization operation completed successfully. |
Modifier and Type | Method and Description |
---|---|
static ConnectState |
valueOf(java.lang.String name)
Returns the enum constant of this type with the specified name.
|
static ConnectState[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final ConnectState READY
READY
state until the first synchronization operation is started.public static final ConnectState RUNNING
RUNNING
state means that a
synchronization operation is currently in progress.public static final ConnectState FAILED
FAILED
state signals that the last
executed synchronization operation failed. You can check the exception
to find out more about the reason of the failure.public static final ConnectState SUCCEEDED
SUCCEEDED
state signals that the last
executed synchronization operation completed successfully.public static final ConnectState CANCELLED
CANCELLED
state signals that the last
executed synchronization operation was cancelled. Cancellation is most likely caused
by a user that cancels an action that is required to proceed with the operation. For
example, when an operation requires an authenticated user, that operation is cancelled
when the user aborts the authentication process.public static final ConnectState REMOVED
REMOVED
state signals that it is
successfully removed after executing the DataProvider.removeObject(GluonObservableObject, ObjectDataRemover)
remove operation}.
The REMOVED
state is only applicable to GluonObservableObject
because
a GluonObservableList
can not be removed.public static ConnectState[] values()
for (ConnectState c : ConnectState.values()) System.out.println(c);
public static ConnectState valueOf(java.lang.String name)
name
- the name of the enum constant to be returned.java.lang.IllegalArgumentException
- if this enum type has no constant with the specified namejava.lang.NullPointerException
- if the argument is null