Struct KafkaStorageError 

pub struct KafkaStorageError { /* private fields */ }

Miscellaneous disk-related IOException occurred when handling a request. Client should request metadata update and retry if the response shows KafkaStorageError

Here are the guidelines on how to handle KafkaStorageError and IOException:

1. If the server has not finished loading logs, IOException does not need to be converted to KafkaStorageError
2. After the server has finished loading logs, IOException should be caught and trigger LogDirFailureChannel.maybeAddOfflineLogDir(). Then the IOException should either be swallowed and logged, or be converted and re-thrown as KafkaStorageError
3. It is preferred for IOException to be caught in Log rather than in ReplicaManager or LogSegment.

Translation notes

Error code Errors::KafkaStorageError.

Implementations

impl KafkaStorageError

pub fn new(message: impl Into<String>) -> Self

Create the error with the given message and no cause, mirroring Java’s (String message) constructor.

This keeps the plain name under CLAUDE.md §2: the dominant Java shape among the classes this macro declares is (String message) + (String message, Throwable cause), whose parameter-name intersection is {message} — matched exactly by (String message).

pub fn with_source(message: impl Into<String>, source: Error) -> Self

Create the error with the given message and an underlying cause, mirroring Java’s (String message, Throwable cause) constructor.

Suffixed with the one parameter beyond the {message} intersection (CLAUDE.md §2) — see new.

pub fn with_default_message() -> Self

Create the error with the default message for its error code, mirroring Java’s Errors.exception().

Not a constructor overload, so CLAUDE.md §2’s suffixing does not apply: it translates the Errors static factory, which fills in Errors.message() and has no Java constructor counterpart.

pub fn message(&self) -> &str

The error message.

pub fn source(&self) -> Option<&Error>

The underlying cause, if any. Mirrors Java’s getCause().

Trait Implementations

impl Clone for KafkaStorageError

fn clone(&self) -> KafkaStorageError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KafkaStorageError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for KafkaStorageError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for KafkaStorageError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.