Skip to main content

confluent_kafka/producer/
producer_buffer_exhausted_error.rs

1// Copyright 2025 Confluent Inc.
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15//! Translated from `org.apache.kafka.clients.producer.BufferExhaustedException`.
16
17use crate::common::error::kafka_error_type;
18use crate::common::protocol::Errors;
19
20kafka_error_type! {
21    /// This error is returned if the producer cannot allocate memory for a
22    /// record within `max.block.ms` due to the buffer being too full. In
23    /// earlier versions a `TimeoutError` was returned instead of this. To keep
24    /// existing checks working, `Error::is_timeout_error` answers `true` for
25    /// it.
26    // Java `extends` chain: `BufferExhaustedException` -> `TimeoutException`
27    // -> `RetriableException` -> `ApiException` -> `KafkaException`. It is
28    // therefore retriable, and reports error code `Errors::RequestTimedOut`:
29    // it has no entry in `Errors` itself, and Java's `Errors.forException`
30    // walks up the superclass chain, finding `TimeoutException`'s.
31    #[doc(alias = "org.apache.kafka.clients.producer.BufferExhaustedException")]
32    ProducerBufferExhaustedError,
33    code: Errors::RequestTimedOut,
34    extends: [
35        is_kafka_error,
36        is_api_error,
37        is_retriable_error,
38        is_timeout_error,
39        is_producer_buffer_exhausted_error,
40    ],
41}