Enum Dispatch 

pub enum Dispatch<Req: JsonRpcRequest = UntypedMessage, Notif: JsonRpcNotification = UntypedMessage> {
    Request(Req, Responder<Req::Response>),
    Notification(Notif),
    Response(Result<Req::Response, Error>, ResponseRouter<Req::Response>),
}

An incoming request, notification, or response being dispatched through handlers. Requests include the context used to answer them; responses include the context used to route them to the local requester.

Type parameters allow specifying the concrete request and notification types. By default, both are UntypedMessage for dynamic dispatch. The request context’s response type matches the request’s response type.

Variants

Request(Req, Responder<Req::Response>)

Incoming request and the context where the response should be sent.

Notification(Notif)

Incoming notification.

Response(Result<Req::Response, Error>, ResponseRouter<Req::Response>)

Incoming response to a request we sent.

The first field is the response result (success or error from the remote). The second field is the context for forwarding the response to its destination (typically a waiting oneshot channel).

Implementations

impl<Req: JsonRpcRequest, Notif: JsonRpcNotification> Dispatch<Req, Notif>

pub fn map<Req1, Notif1>( self, map_request: impl FnOnce(Req, Responder<Req::Response>) -> (Req1, Responder<Req1::Response>), map_notification: impl FnOnce(Notif) -> Notif1, ) -> Dispatch<Req1, Notif1>

where Req1: JsonRpcRequest<Response = Req::Response>, Notif1: JsonRpcNotification,

Map the request and notification types to new types.

Note: Response variants are passed through unchanged since they don’t contain a parseable message payload.

pub fn to_untyped_message(&self) -> Result<UntypedMessage, Error>

Convert the message in self to an untyped message.

Note: Response variants don’t have an untyped message representation. This returns an error for Response variants.

pub fn into_untyped_dispatch(self) -> Result<Dispatch, Error>

Convert self to an untyped message context.

Note: Response variants cannot be converted. This returns an error for Response variants.

pub fn id(&self) -> Option<&RequestId>

Returns the request ID if this is a request or response, None if notification.

pub fn method(&self) -> &str

Returns the method of the message.

For requests and notifications, this is the method from the message payload. For responses, this is the method of the original request.

impl Dispatch

pub fn has_field(&self, field_name: &str) -> bool

True if this message has a field with the given name.

Returns false for Response variants.

pub fn into_notification<N: JsonRpcNotification>( self, ) -> Result<Result<N, Dispatch>, Error>

Try to parse this as a notification of the given type.

Returns

• Ok(Ok(typed)) if this is a notification of the requested type
• Ok(Err(self)) if this is not a matching notification
• Err if its method matches the requested type but parsing fails

pub fn into_request<Req: JsonRpcRequest>( self, ) -> Result<Result<(Req, Responder<Req::Response>), Dispatch>, Error>

Try to parse this as a request of the given type.

Returns

• Ok(Ok(typed)) if this is a request of the requested type
• Ok(Err(self)) if this is not a matching request
• Err if its method matches the requested type but parsing fails

impl<M: JsonRpcRequest + JsonRpcNotification> Dispatch<M, M>

pub fn message(&self) -> Option<&M>

Returns the message payload for requests and notifications.

Returns None for Response variants since they don’t contain a message payload.

Trait Implementations

impl<Req: Debug + JsonRpcRequest, Notif: Debug + JsonRpcNotification> Debug for Dispatch<Req, Notif>

where Req::Response: Debug,

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

Formats the value using the given formatter.