---
title: "Batched Invocation Interceptors"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors
language: cpp
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: C++. Other languages: [C#](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/java.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/cpp/structIce_1_1InitializationData.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:

```cpp
constexpr int maxBatchSize = 64 * 1024; // in bytes
initData.batchRequestInterceptor =
    [](const Ice::BatchRequest& req, int count, int size)
    {
        if (size + req.getSize() > maxBatchSize)
        {
            req.getProxy().ice_flushBatchRequestsAsync(
                [](std::exception_ptr ex)
                {
                    // Log the failure.
                });
        }
        req.enqueue();
    };
```

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