SDK
SDK Android v3.x
1

You are currently looking at the documentation of a previous version of Kuzzle. We strongly recommend that you use the latest version. You can also use the version selector in the top menu.

subscribe #

Listens to changes occuring in this document. Throws an error if this document has not yet been created in Kuzzle.

The provided callback will be called everytime a notification is received from Kuzzle.


subscribe([options], callback) #

ArgumentsTypeDescription
optionsobjectSubscription configuration
callbackfunctionCallback that will be called each time a change has been detected on this document

Options #

Options are directly passed to the Room object constructor.


Return Value #

Returns an object exposing the following method: onDone(callback)

The callback argument is called when the subscription ends, either successfully or with an error.

Usage #

Room room = document.subscribe(new ResponseListener<NotificationResponse>() {
  @Override
  public void onSuccess(NotificationResponse object) {
    // called each time a change occurs on this document
  }
  @Override
  public void onError(JSONObject error) {
    // Handle error
    }
  })
  .onDone(new ResponseListener<Room>() {
    @Override
    public void onSuccess(Room response) {
      // Handle subscription success
    }
    @Override
    public void onError(JSONObject error) {
      // Handle subscription error
    }
  });