Enum RouteError 

pub enum RouteError<'a> {
    Decode(DecodeError),
    BatchNotAllowed,
    MethodNotFound(Method<'a>),
    InvalidParams {
        method: Method<'a>,
        reason: &'static str,
    },
}

Why a frame was refused.

Why the method name is borrowed

The name is borrowed from the frame rather than interned, because a table of “known” names is a second list that can disagree with the method table, and a disagreement here is silent: a legitimate method name that the intern list has not heard of would be reported to the operator as unknown, which is exactly the case an operator most needs to see. The frame outlives the error — the error is produced while reading it — so the borrow is free.

Variants

Decode(DecodeError)

The frame was not decodable at all.

BatchNotAllowed

A batch arrived and this session does not accept one (-32600).

InvalidRequest rather than a code of its own: the specification has no batch-specific code, and inventing one would make a peer that switches on codes meet something it has never heard of.

MethodNotFound(Method<'a>)

The method is not in this protocol’s table (-32601).

InvalidParams

The params did not fit the method (-32602).

Fields

method: Method<'a>

The method whose params did not fit.

reason: &'static str

Why.

Implementations

impl RouteError<'_>

pub const fn code(&self) -> IrErrorCode

The JSON-RPC code this failure is reported as.

The batch case answers InvalidRequest and the unknown-method case answers MethodNotFound; both are the codes the specification gives, and reporting a batch refusal as -32601 would tell the peer the wrong thing about which half of the problem to fix.

Trait Implementations

impl<'a> Clone for RouteError<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RouteError<'a>

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

Formats the value using the given formatter.

impl<'a> Display for RouteError<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for RouteError<'a>

impl<'a> Error for RouteError<'a>

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<'a> From<DecodeError> for RouteError<'a>

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl<'a> PartialEq for RouteError<'a>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'a> StructuralPartialEq for RouteError<'a>