Struct request_response::RequestResponse[][src]

pub struct RequestResponse<TCodec> where
    TCodec: RequestResponseCodec
{ /* fields omitted */ }

A request/response protocol for some message codec.


impl<TCodec> RequestResponse<TCodec> where
    TCodec: RequestResponseCodec + Clone

pub fn new<I>(codec: TCodec, protocols: I, cfg: RequestResponseConfig) -> Self where
    I: IntoIterator<Item = (TCodec::Protocol, ProtocolSupport)>, 

Creates a new RequestResponse behaviour for the given protocols, codec and configuration.

pub fn throttled<I>(
    c: TCodec,
    protos: I,
    cfg: RequestResponseConfig
) -> Throttled<TCodec> where
    I: IntoIterator<Item = (TCodec::Protocol, ProtocolSupport)>,
    TCodec: Send,
    TCodec::Protocol: Sync

Creates a RequestResponse which limits requests per peer.

The behaviour is wrapped in Throttled and detects the limits per peer at runtime which are then enforced.

pub fn send_request(
    &mut self,
    peer: &PeerId,
    request: TCodec::Request
) -> RequestId

Initiates sending a request.

If the targeted peer is currently not connected, a dialing attempt is initiated and the request is sent as soon as a connection is established.

Note: In order for such a dialing attempt to succeed, the RequestResonse protocol must either be embedded in another NetworkBehaviour that provides peer and address discovery, or known addresses of peers must be managed via RequestResponse::add_address and RequestResponse::remove_address.

pub fn send_response(
    &mut self,
    ch: ResponseChannel<TCodec::Response>,
    rs: TCodec::Response
) -> Result<(), TCodec::Response>

Initiates sending a response to an inbound request.

If the ResponseChannel is already closed due to a timeout or the connection being closed, the response is returned as an Err for further handling. Once the response has been successfully sent on the corresponding connection, RequestResponseEvent::ResponseSent is emitted. In all other cases RequestResponseEvent::InboundFailure will be or has been emitted.

The provided ResponseChannel is obtained from an inbound RequestResponseMessage::Request.

pub fn add_address(&mut self, peer: &PeerId, address: Multiaddr)[src]

Adds a known address for a peer that can be used for dialing attempts by the Swarm, i.e. is returned by NetworkBehaviour::addresses_of_peer.

Addresses added in this way are only removed by remove_address.

pub fn remove_address(&mut self, peer: &PeerId, address: &Multiaddr)[src]

Removes an address of a peer previously added via add_address.

pub fn is_connected(&self, peer: &PeerId) -> bool[src]

Checks whether a peer is currently connected.

pub fn is_pending_outbound(&self, peer: &PeerId, request_id: &RequestId) -> bool[src]

Checks whether an outbound request to the peer with the provided PeerId initiated by RequestResponse::send_request is still pending, i.e. waiting for a response.

pub fn is_pending_inbound(&self, peer: &PeerId, request_id: &RequestId) -> bool[src]

Checks whether an inbound request from the peer with the provided PeerId is still pending, i.e. waiting for a response by the local node through RequestResponse::send_response.

Trait Implementations

impl<TCodec> NetworkBehaviour for RequestResponse<TCodec> where
    TCodec: RequestResponseCodec + Send + Clone + 'static, 

type ProtocolsHandler = RequestResponseHandler<TCodec>

Handler for all the protocols the network behaviour supports.

type OutEvent = RequestResponseEvent<TCodec::Request, TCodec::Response>

Event generated by the NetworkBehaviour and that the swarm will report back.

Auto Trait Implementations

impl<TCodec> !RefUnwindSafe for RequestResponse<TCodec>

impl<TCodec> Send for RequestResponse<TCodec> where
    TCodec: Send

impl<TCodec> Sync for RequestResponse<TCodec> where
    TCodec: Sync,
    <TCodec as RequestResponseCodec>::Protocol: Sync,
    <TCodec as RequestResponseCodec>::Request: Sync,
    <TCodec as RequestResponseCodec>::Response: Sync

impl<TCodec> Unpin for RequestResponse<TCodec> where
    TCodec: Unpin,
    <TCodec as RequestResponseCodec>::Protocol: Unpin,
    <TCodec as RequestResponseCodec>::Request: Unpin,
    <TCodec as RequestResponseCodec>::Response: Unpin

impl<TCodec> !UnwindSafe for RequestResponse<TCodec>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized

impl<T> Borrow<T> for T where
    T: ?Sized

impl<T> BorrowMut<T> for T where
    T: ?Sized

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,