Struct ResponseRouter 

pub struct ResponseRouter<T: JsonRpcResponse = Value> { /* private fields */ }

Context for handling an incoming JSON-RPC response.

This is the response-side counterpart to Responder. While Responder handles incoming requests (where you send a response over the wire), ResponseRouter handles incoming responses (where you route the response to a local task waiting for it).

Both are fundamentally “sinks” that push the message through a send_fn, but they represent different points in the message lifecycle and carry different metadata.

Implementations

impl ResponseRouter<Value>

pub fn cast<T: JsonRpcResponse>(self) -> ResponseRouter<T>

Cast this response context to a different response type.

The provided type T will be serialized to JSON before sending.

impl<T: JsonRpcResponse> ResponseRouter<T>

pub fn method(&self) -> &str

Method of the original request

pub fn id(&self) -> Value

ID of the original request as a JSON value

pub fn role_id(&self) -> RoleId

The peer to which the original request was sent.

This is the peer from which we expect to receive the response.

pub fn erase_to_json(self) -> ResponseRouter<Value>

Convert to a ResponseRouter that expects a JSON value and which checks (dynamically) that the JSON value it receives can be converted to T.

pub fn respond_with_result( self, response: Result<T, Error>, ) -> Result<(), Error>

Complete the response by sending the result to the waiting task.

pub fn respond(self, response: T) -> Result<(), Error>

Complete the response by sending a value to the waiting task.

pub fn respond_with_internal_error( self, message: impl ToString, ) -> Result<(), Error>

Complete the response by sending an internal error to the waiting task.

pub fn respond_with_error(self, error: Error) -> Result<(), Error>

Complete the response by sending an error to the waiting task.

Trait Implementations

impl<T: JsonRpcResponse> Debug for ResponseRouter<T>

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

Formats the value using the given formatter.