Deleting Multiple Objects

This API deletes multiple objects in a data table with a single request. Consider the following example, it demonstrates an API call which deletes all objects in the Person data table where the value of the age property is greater than 20:

Backendless.Data.of( "Person" ).remove( "age > 20", new AsyncCallback<Integer>()
{
  @Override
  public void handleResponse( Integer objectsDeleted )
  {
    Log.i( "MYAPP", "Server has deleted " + objectsDeleted + " objects" );
  }

  @Override
  public void handleFault( BackendlessFault fault )
  {
    Log.e( "MYAPP", "Server reported an error - " + fault );
  }
} );

Blocking API

Using Java Map

public int Backendless.Data.of( "TABLE-NAME" ).remove( 
                           String whereClause ) throws BackendlessException

Custom Class

public <E> int Backendless.Data.of( E ).remove( 
                           String whereClause ) throws BackendlessException

Non-Blocking API

Using Java Map

public void Backendless.Data.of( "TABLE-NAME" ).remove( 
                           String whereClause,
                           AsyncCallback<Integer> responder )

Custom Class

public <E> void Backendless.Data.of( E ).update( 
                           String whereClause,
                           AsyncCallback<Integer> responder )

where:

Argument	Description
TABLE-NAME	Name of the table where the objects expressed via java.util.Map instances will be updated.
E	Java class of the data objects to update in the database.
whereClause	A condition for selecting objects to be deleted in the data table.
responder	a responder object which will receive a callback when the method successfully deleted the objects or if an error occurs. Applies to the non-blocking method only.

Return Value

The method returns the number of objects deleted in the database.