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}