Enum BrokerClientError 

pub enum BrokerClientError {
    BrokerConnect(Error),
    BackendConnect(Error),
    Framing(FramingError),
    DecodeFrame(DecodeError),
    DecodeHelloReply(DecodeError),
    DecodeAdminReply(DecodeError),
    UnexpectedResponseFrame(&'static str),
    MissingHelloReplyResult,
    Refused {
        code: ErrorCode,
        reason: String,
        retry_after_ms: u64,
    },
    EmptyBackendPipe,
}

Errors produced by broker client helpers.

Variants

BrokerConnect(Error)

Could not connect to the broker.

BackendConnect(Error)

Broker negotiation succeeded but the returned backend endpoint failed.

Framing(FramingError)

Frame read/write failed.

DecodeFrame(DecodeError)

Broker response frame was malformed.

DecodeHelloReply(DecodeError)

Broker response payload was not a valid HelloReply.

DecodeAdminReply(DecodeError)

Broker response payload was not a valid AdminReply.

UnexpectedResponseFrame(&'static str)

Broker returned an unexpected response envelope.

MissingHelloReplyResult

Broker returned HelloReply without a result.

Refused

Broker refused the Hello request.

Fields

code: ErrorCode

Stable refusal code.

reason: String

Human-readable reason.

retry_after_ms: u64

Retry hint.

EmptyBackendPipe

Broker returned an empty backend endpoint.

Implementations

impl BrokerClientError

pub fn refusal_kind(&self) -> Option<RefusalKind>

Classify a broker refusal into a stable, matchable kind (#433 R7).

Returns Some only for BrokerClientError::Refused; every other (transport/decoding) error returns None. Consumers branch on RefusalKind instead of pattern-matching the raw i32 ErrorCode, so retry/escalate decisions stay readable and survive the addition of future codes (mapped to RefusalKind::Other).

Trait Implementations

impl Debug for BrokerClientError

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

Formats the value using the given formatter.

impl Display for BrokerClientError

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

Formats the value using the given formatter.

impl Error for BrokerClientError

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<BrokerClientError> for AdoptError

fn from(source: BrokerClientError) -> Self

Converts to this type from the input type.

impl From<FramingError> for BrokerClientError

fn from(source: FramingError) -> Self

Converts to this type from the input type.