Unconditional Delivery Listeners¶
The where clause
argument in the addUpdateListener
method is optional. When it is not provided, the real-time database will deliver any object which is being updated in the database's table:
EventHandler<Map> orderEventHandler = Backendless.Data.of( "Order" ).rt();
orderEventHandler.addUpdateListener( new AsyncCallback<Map>()
{
@Override
public void handleResponse( Map updatedOrder )
{
Log.i( "MYAPP", "an Order object has been updated. Object ID - " + updatedOrder.get( "objectId" ) );
}
@Override
public void handleFault( BackendlessFault fault )
{
Log.e( "MYAPP", "Server reported an error " + fault.getDetail() );
}
} );
EventHandler<Order> orderEventHandler = Backendless.Data.of( Order.class ).rt();
orderEventHandler.addUpdateListener( new AsyncCallback<Order>()
{
@Override
public void handleResponse( Order updatedOrder )
{
Log.i( "MYAPP", "an Order object has been updated. Object ID - " + updatedOrder.objectId );
}
@Override
public void handleFault( BackendlessFault fault )
{
Log.e( "MYAPP", "Server reported an error " + fault.getDetail() );
}
} );
Codeless Reference¶
where:
Argument | Description |
---|---|
id |
Unique identifier of the new event listener. |
table name |
The name of the data table where a conditional event listener must be registered. |
where clause |
Optional parameter. Sets the condition for an event listener which gets triggered every time the condition is met when the update operation is invoked for a specific data table. For more information about the where clause syntax, see the Condition Syntax section of the guide. |
object |
When a listener gets triggered, the Backendless delivers a callback object containing the updated object to the listener. |
The example below registers a new event listener for the "Person"
data table with the id``"1EFD-3GEF2-FF4C-AC21"
. The listener is triggered when an existing object is updated in the data table.
Assume an object in the data table is updated, and the Codeless logic below executes a custom block of code; First the following sentence is printed: "Update operation has triggered the listener."
, then the value of the property objectId
is retrieved from the object
variable and also gets printed.