---
title: "Batched Invocation Interceptors"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors
language: java
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Batched Invocation Interceptors

Programming language: Java. Other languages: [C++](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/csharp.md), [Python](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/python.md).

A batch invocation interceptor lets you flush batched requests with your own policy, and handle a failed flush.

You install an interceptor by setting the `batchRequestInterceptor` field of the [InitializationData](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/InitializationData.html) object you use to create your communicator. The communicator invokes the interceptor for each batch request, passing the following arguments:

- `req`: an object representing the batch request being queued
- `count`: the number of requests already in the queue
- `size`: the number of bytes of the queued batch message, including its header

The request represented by `req` is not included in `count` and `size`, and is queued only when the interceptor calls `enqueue` on it.

The following interceptor flushes the queued requests when adding the new request would make the batch message larger than 64 KiB:

```java
final int maxBatchSize = 64 * 1024; // in bytes
initData.batchRequestInterceptor = (req, count, size) -> {
    if (size + req.getSize() > maxBatchSize) {
        req.getProxy().ice_flushBatchRequestsAsync().exceptionally(ex -> {
            System.err.println("Failed to flush batch requests: " + ex);
            return null;
        });
    }
    req.enqueue();
};
```

Installing an interceptor does not turn off [automatic flushing](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocations/java.md#automatic-flushing).
