Batch Concepts

A batch accumulates and packages multiple operations (method calls) on objects. The batch is then executed in a single operation.

A batch can significantly improve performance. You should consider using a batch when application logic lends itself to executing a series of operations that can be completed (or be in progress) independently, without reliance on either the state of another object included in the batch, or the result of another operation in the batch. For example, batch processing is suitable for retrieving some property values for each object in a collection of Document objects. In this case, all of the property fetches are executed in a single roundtrip to the server.

Each operation included in a batch is referenced as a BatchItemHandle instance. A batch is a subclass of the Batch abstract class, and contains the list of BatchItemHandle instances. Whether a batch is a transactional operation depends on its type: