Updating Multiple Objects¶

This API updates multiple objects in a data table with a single request. Consider the following example, it demonstrates an API call which updates all objects in the Person data table where the value of the property age is greater than 20. As a result of the request, all updated objects will have the contactType property set to "personal":

Map<String, Object> changes = new HashMap<>();
changes.put( "contactType", "personal" );
Backendless.Data.of( "Person" ).update( "age > 20", changes, new AsyncCallback<Integer>()
{
  @Override
  public void handleResponse( Integer objectsUpdated )
  {
    Log.i( "MYAPP", "Server has updated " + objectsUpdated + " 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" ).update( 
                           String whereClause, 
                           Map<String, Object> changes ) throws BackendlessException

Custom Class

public <E> int Backendless.Data.of( E ).update( 
                           String whereClause, 
                           Map<String, Object> changes ) throws BackendlessException

Non-Blocking API¶

Using Java Map

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

Custom Class

public <E> void Backendless.Data.of( E ).update( 
                           String whereClause,
                           Map<String, Object> changes, 
                           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 in the data table which will be updated.
`changes`	An instance of `java.util.Map` containing the changes which will be applied to all objects in the data table which match the condition expressed via `whereClause`.
`responder`	a responder object which will receive a callback when the method successfully updates the objects or if an error occurs. Applies to the non-blocking method only.

Return Value¶

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