io.realm.sync

Class Subscription

java.lang.Object

io.realm.RealmObject

io.realm.sync.Subscription

All Implemented Interfaces:

RealmModel

public class Subscription
extends RealmObject

Subscriptions represents the data from the server that a device is interested in when using Query-based Realms.

They are created automatically when using RealmQuery.findAllAsync() or RealmQuery.findAllAsync(String) on those Realms, but can also be created manually using RealmQuery.subscribe() and RealmQuery.subscribe(String).

As long as any subscription exist that include an object, that object will be present on the device. If an object is not covered by an active subscription it will be removed from the device, but not the server.

Subscriptions are Realm objects, so deleting them e.g. by calling RealmObject.deleteFromRealm(), is the same as calling unsubscribe().

Warning: Instances of this class should never be created directly through Realm.createObject(Class) but only by using RealmQuery.subscribe() or RealmQuery.subscribe(String).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Subscription.State The different states a Subscription can be in.

Constructor Summary

Constructors

Constructor and Description
Subscription()
Subscription(String name, RealmQuery<?> query) Creates a unmanaged named subscription from a RealmQuery.

Method Summary

Modifier and Type	Method and Description
String	getErrorMessage() Returns the error message if getState() returned Subscription.State.ERROR, otherwise the empty string is returned.
String	getName() Returns the name of the subscription.
String	getQueryClassName() Returns the internal name of the Class being queried.
String	getQueryDescription() Returns a textual description of the query that created this subscription.
Subscription.State	getState() Returns the state of the subscription
String	toString()
void	unsubscribe() Cancels the subscription.

Methods inherited from class io.realm.RealmObject

addChangeListener, addChangeListener, addChangeListener, addChangeListener, asChangesetObservable, asChangesetObservable, asFlowable, asFlowable, deleteFromRealm, deleteFromRealm, getRealm, getRealm, isLoaded, isLoaded, isManaged, isManaged, isValid, isValid, load, load, removeAllChangeListeners, removeAllChangeListeners, removeChangeListener, removeChangeListener, removeChangeListener, removeChangeListener

Methods inherited from class java.lang.Object

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

Constructor Detail

Subscription

public Subscription()

Subscription

public Subscription(String name,
                    RealmQuery<?> query)

Creates a unmanaged named subscription from a RealmQuery. This will not take effect until it has been added to the Realm.

Parameters:

name - name of the query.

query - the query to turn into a subscription.

Method Detail

getName

public String getName()

Returns the name of the subscription.

Returns:

the name of the subscription.

getQueryDescription

public String getQueryDescription()

Returns a textual description of the query that created this subscription.

Returns:

a textual description of the query.

getQueryClassName

public String getQueryClassName()

Returns the internal name of the Class being queried.

Returns:

the internal name of the of the class being queried.

getState

public Subscription.State getState()

Returns the state of the subscription

Returns:

the state of the subscription.

See Also:

Subscription.State

getErrorMessage

public String getErrorMessage()

Returns the error message if getState() returned Subscription.State.ERROR, otherwise the empty string is returned.

Returns:

the error string if the subscription encountered an error.

unsubscribe

public void unsubscribe()

Cancels the subscription. After this, if the objects covered by the subscription are not part of any other subscription, they will be removed locally from the device (but not on the server).

The effect of unsubscribing is not immediate. The local Realm must coordinate with the Realm Object Server before it can happen. When it happens, any objects removed will trigger a standard change notification, and from the perspective of the device it will look like they where deleted.

Calling this method is the equivalent of calling RealmObject.deleteFromRealm().

Throws:

IllegalStateException - if the Realm is not in a write transaction.

toString

public String toString()

Overrides:

toString in class Object