Enum Error 

pub enum Error {
    Closed,
    Timeout,
    Transport(Arc<Error>),
    Remote(Error),
    UnexpectedResponse {
        expected: &'static str,
        received: &'static str,
    },
    WrongDirection(&'static str),
    TooLarge(usize),
    Malformed,
    InboundRequestLimitExceeded(usize),
    InboundByteLimitExceeded(usize),
}

Failure of a protocol operation.

A remote application’s error is carried by Error::Remote, and it does not by itself end the session.

Variants

Closed

The session or server was closed locally, including by dropping its owner.

Timeout

The operation’s absolute deadline expired.

Remote work may still run.

Transport(Arc<Error>)

The underlying transport failed or the peer reset the session.

Remote(Error)

The peer returned an application error for this request.

UnexpectedResponse

A Message variant differs from the payload type it is converted to.

Promise::wait returns it for a response of the wrong type. This does not end the session.

Fields

expected: &'static str

Type name of the payload the caller expected.

received: &'static str

Type name of the payload that arrived.

WrongDirection(&'static str)

The submitted message cannot be sent from this session’s side.

It is reported through the request or reply promise and does not end the session. Converting a Message into the content oneof of a direction it cannot travel in fails with this error too.

TooLarge(usize)

The encoded message exceeds the transport’s sending limit, transport::MAX_MESSAGE_SIZE.

It carries the encoded size in bytes.

Malformed

The peer sent an invalid envelope or payload.

The session closes when this is detected. Nested payloads are checked only when Session::recv or Promise::wait reads them.

InboundRequestLimitExceeded(usize)

A peer request would exceed the session’s request limit.

It also occurs when the limit is lowered below usage. It carries the configured request limit and closes the session.

InboundByteLimitExceeded(usize)

Buffering an incoming envelope would exceed the session’s byte limit.

It also occurs when the limit is lowered below usage. It carries the configured byte limit and closes the session.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<!> for Error

fn from(error: Infallible) -> Self

Allows Promise::wait to return a Message without extracting a variant.

impl From<Arc<Error>> for Error

fn from(source: Arc<Error>) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(error: Error) -> Self

Wraps a transport error in an Arc so pending promises can share it.

impl From<Error> for Error

fn from(error: Error) -> Self

Wraps the peer’s error code and message in Error::Remote.