Struct PingHandler 

pub struct PingHandler { /* private fields */ }

Protocol handler that handles pinging the remote at a regular period and answering ping queries.

If the remote doesn’t respond, produces an error that closes the connection.

Implementations

impl PingHandler

pub fn new(config: PingConfig) -> Self

Builds a new PingHandler with the given configuration.

Trait Implementations

impl ProtocolsHandler for PingHandler

type InEvent = Void

Custom event that can be received from the outside.

type OutEvent = Result<PingSuccess, PingFailure>

Custom event that can be produced by the handler and that will be returned to the outside.

type Error = PingFailure

The type of errors returned by ProtocolsHandler::poll.

type InboundProtocol = Ping

The inbound upgrade for the protocol(s) used by the handler.

type OutboundProtocol = Ping

The outbound upgrade for the protocol(s) used by the handler.

type OutboundOpenInfo = ()

The type of additional information passed to an OutboundSubstreamRequest.

type InboundOpenInfo = ()

The type of additional information returned from listen_protocol.

fn listen_protocol(&self) -> SubstreamProtocol<Ping, ()>

The InboundUpgrade to apply on inbound substreams to negotiate the desired protocols.

fn inject_fully_negotiated_inbound( &mut self, stream: NegotiatedSubstream, (): (), )

Injects the output of a successful upgrade on a new inbound substream.

fn inject_fully_negotiated_outbound( &mut self, stream: NegotiatedSubstream, (): (), )

Injects the output of a successful upgrade on a new outbound substream.

fn inject_event(&mut self, _: Void)

Injects an event coming from the outside in the handler.

fn inject_dial_upgrade_error( &mut self, _info: (), error: ProtocolsHandlerUpgrErr<Void>, )

Indicates to the handler that upgrading an outbound substream to the given protocol has failed.

fn connection_keep_alive(&self) -> KeepAlive

Returns until when the connection should be kept alive.

fn poll( &mut self, cx: &mut Context<'_>, ) -> Poll<ProtocolsHandlerEvent<Ping, (), PingResult, Self::Error>>

Should behave like Stream::poll().

fn inject_address_change(&mut self, _new_address: &Multiaddr)

Notifies the handler of a change in the address of the remote.

fn inject_listen_upgrade_error( &mut self, _: Self::InboundOpenInfo, _: ProtocolsHandlerUpgrErr<<Self::InboundProtocol as InboundUpgradeSend>::Error>, )

Indicates to the handler that upgrading an inbound substream to the given protocol has failed.

fn map_in_event<TNewIn, TMap>(self, map: TMap) -> MapInEvent<Self, TNewIn, TMap>

where Self: Sized, TMap: Fn(&TNewIn) -> Option<&Self::InEvent>,

Adds a closure that turns the input event into something else.

fn map_out_event<TMap, TNewOut>(self, map: TMap) -> MapOutEvent<Self, TMap>

where Self: Sized, TMap: FnMut(Self::OutEvent) -> TNewOut,

Adds a closure that turns the output event into something else.

fn select<TProto2>( self, other: TProto2, ) -> ProtocolsHandlerSelect<Self, TProto2>

where Self: Sized,

Creates a new ProtocolsHandler that selects either this handler or other by delegating methods calls appropriately.

fn into_node_handler_builder(self) -> NodeHandlerWrapperBuilder<Self>

where Self: Sized,

Creates a builder that allows creating a NodeHandler that handles this protocol exclusively.