Enum JournalError 

pub enum JournalError {
    Io(Error),
    Serialize(String),
    Deserialize(String),
    SeqGap {
        expected: u64,
        got: u64,
    },
    DuplicateEventId(Uuid),
    TruncatedRecord,
    UnsupportedSchemaVersion(u16),
    PayloadTooLarge {
        size: usize,
    },
    NoValidFrames {
        file_len: u64,
    },
    RunIdMismatch {
        expected: Uuid,
        got: Uuid,
    },
    InconsistentRunId {
        seq: u64,
        expected: Uuid,
        got: Uuid,
    },
    BackgroundWriterSend(String),
    BackgroundWriterJoin(String),
    RecordHashMismatch {
        seq: u64,
        expected: String,
        computed: String,
    },
    HashChainBreak {
        seq: u64,
        prev_hash: Option<String>,
        expected: Option<String>,
    },
}

Errors that can occur during journal I/O (write, read, encode/decode).

Variants

Io(Error)

Underlying I/O error.

Serialize(String)

Serialization failure.

Deserialize(String)

Deserialization failure.

SeqGap

Non-contiguous sequence number detected during read.

Fields

expected: u64

got: u64

DuplicateEventId(Uuid)

Duplicate event_id detected during read.

TruncatedRecord

Frame is shorter than declared length (file truncated mid-record).

UnsupportedSchemaVersion(u16)

Journal event has a schema version this binary does not support.

PayloadTooLarge

Encoded payload exceeds the 4-byte length prefix maximum (u32::MAX).

Fields

size: usize

NoValidFrames

Non-empty journal file has no decodable frames (e.g. encoding mismatch).

Fields

file_len: u64

RunIdMismatch

Existing journal run_id does not match the writer run_id.

Fields

expected: Uuid

got: Uuid

InconsistentRunId

Existing journal contains multiple run_ids across records.

Fields

seq: u64

expected: Uuid

got: Uuid

BackgroundWriterSend(String)

Background writer thread has disconnected or the channel is full.

BackgroundWriterJoin(String)

Background writer thread returned an I/O error.

RecordHashMismatch

Record hash does not match recomputed hash.

Fields

seq: u64

expected: String

computed: String

HashChainBreak

Hash chain linkage is broken (prev_record_hash does not match previous record).

Fields

seq: u64

prev_hash: Option<String>

expected: Option<String>

Trait Implementations

impl Debug for JournalError

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

Formats the value using the given formatter.

impl Display for JournalError

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

Formats the value using the given formatter.

impl Error for JournalError

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.

impl From<Error> for JournalError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JournalError> for ReplayError

fn from(source: JournalError) -> Self

Converts to this type from the input type.