Enum ProtocolError 

#[non_exhaustive]
pub enum ProtocolError {
    EarlyClose,
    Parse(String),
    HttpParse(String),
    MissingHeader(&'static str),
    Header(String),
    Body(String),
    BodyTooLarge {
        size: usize,
        max: usize,
    },
    InvalidField {
        field: ProtocolField,
        value: String,
    },
    InvalidISTag(String),
    Serialization(String),
    Utf8(Utf8Error),
    FromUtf8(FromUtf8Error),
    HeaderName(InvalidHeaderName),
    HeaderValue(InvalidHeaderValue),
    HeaderToStr(ToStrError),
}

Wire-protocol failures: parsing, missing/invalid headers, encapsulation, …

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.

EarlyClose

Peer closed the connection before a full ICAP header block arrived.

Parse(String)

Failed to parse an ICAP message.

HttpParse(String)

Failed to parse an embedded HTTP message.

MissingHeader(&'static str)

Required header was absent.

Header(String)

Malformed header (catch-all). Prefer a more specific variant when possible.

Body(String)

Body-handling error (chunked decoder, dechunking, etc.).

BodyTooLarge

Embedded body exceeded a configured byte limit.

Fields

size: usize

max: usize

InvalidField

Invalid value for a specific ICAP/HTTP field.

Fields

field: ProtocolField

value: String

InvalidISTag(String)

ISTag validation failed.

Serialization(String)

Outgoing message could not be serialized.

Utf8(Utf8Error)

Invalid UTF-8 in wire data.

FromUtf8(FromUtf8Error)

Invalid UTF-8 while converting owned bytes into text.

HeaderName(InvalidHeaderName)

Invalid HTTP header name.

HeaderValue(InvalidHeaderValue)

Invalid HTTP header value.

HeaderToStr(ToStrError)

HTTP header value could not be represented as text.

Implementations

impl ProtocolError

pub fn invalid(field: ProtocolField, value: impl Into<String>) -> Self

Build Self::InvalidField tersely.

Trait Implementations

impl Debug for ProtocolError

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

Formats the value using the given formatter.

impl Display for ProtocolError

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

Formats the value using the given formatter.

impl Error for ProtocolError

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<FromUtf8Error> for ProtocolError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderName> for ProtocolError

fn from(source: InvalidHeaderName) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for ProtocolError

fn from(source: InvalidHeaderValue) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for Error

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.

impl From<ToStrError> for ProtocolError

fn from(source: ToStrError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for ProtocolError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.