Enum CodecError 

#[non_exhaustive]
pub enum CodecError {
    Io(Error),
    Protocol(ProtocolError),
    PacketTooLarge {
        size: usize,
        max: usize,
    },
    MessageTooLarge {
        size: usize,
        limit: usize,
    },
    IncompletePacket {
        needed: usize,
    },
    InvalidHeader,
    ConnectionClosed,
    Cancelled,
    Encoding(String),
    Decoding(String),
}

Errors that can occur during packet encoding/decoding.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(Error)

IO error during read/write operations.

Protocol(ProtocolError)

Protocol-level error from tds-protocol.

PacketTooLarge

Packet too large.

Fields

size: usize

Actual packet size.

max: usize

Maximum allowed size.

MessageTooLarge

Assembled response message exceeded the configured size limit.

Fields

size: usize

Bytes accumulated when the limit was exceeded.

limit: usize

The configured limit.

IncompletePacket

Incomplete packet data.

Fields

needed: usize

Bytes needed to complete the packet.

InvalidHeader

Invalid packet header.

ConnectionClosed

Connection closed unexpectedly.

Cancelled

The in-flight request was cancelled via an Attention signal and the server acknowledged the cancellation (DONE_ATTN). The connection is drained and remains usable for new requests.

Encoding(String)

Encoding error.

Decoding(String)

Decoding error.

Implementations

impl CodecError

pub fn is_transient(&self) -> bool

Check if this error is transient and may succeed on retry.

IO errors and connection closures are typically transient. Protocol, encoding, and header errors are terminal.

pub fn is_terminal(&self) -> bool

Check if this error is terminal and will never succeed on retry.

Trait Implementations

impl Debug for CodecError

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

Formats the value using the given formatter.

impl Display for CodecError

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

Formats the value using the given formatter.

impl Error for CodecError

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 CodecError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for CodecError

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.