Struct libp2p_swarm::protocols_handler::OneShotHandler
source · [−]pub struct OneShotHandler<TInbound, TOutbound, TEvent> where
TOutbound: OutboundUpgradeSend, { /* private fields */ }
Expand description
A ProtocolsHandler
that opens a new substream for each request.
Implementations
impl<TInbound, TOutbound, TEvent> OneShotHandler<TInbound, TOutbound, TEvent> where
TOutbound: OutboundUpgradeSend,
impl<TInbound, TOutbound, TEvent> OneShotHandler<TInbound, TOutbound, TEvent> where
TOutbound: OutboundUpgradeSend,
pub fn new(
listen_protocol: SubstreamProtocol<TInbound, ()>,
config: OneShotHandlerConfig
) -> Self
pub fn new(
listen_protocol: SubstreamProtocol<TInbound, ()>,
config: OneShotHandlerConfig
) -> Self
Creates a OneShotHandler
.
Returns the number of pending requests.
Returns a reference to the listen protocol configuration.
Note: If you modify the protocol, modifications will only applies to future inbound substreams, not the ones already being negotiated.
Returns a mutable reference to the listen protocol configuration.
Note: If you modify the protocol, modifications will only applies to future inbound substreams, not the ones already being negotiated.
Opens an outbound substream with upgrade
.
Trait Implementations
impl<TInbound, TOutbound, TEvent> Default for OneShotHandler<TInbound, TOutbound, TEvent> where
TOutbound: OutboundUpgradeSend,
TInbound: InboundUpgradeSend + Default,
impl<TInbound, TOutbound, TEvent> Default for OneShotHandler<TInbound, TOutbound, TEvent> where
TOutbound: OutboundUpgradeSend,
TInbound: InboundUpgradeSend + Default,
impl<TInbound, TOutbound, TEvent> ProtocolsHandler for OneShotHandler<TInbound, TOutbound, TEvent> where
TInbound: InboundUpgradeSend + Send + 'static,
TOutbound: Debug + OutboundUpgradeSend,
TInbound::Output: Into<TEvent>,
TOutbound::Output: Into<TEvent>,
TOutbound::Error: Error + Send + 'static,
SubstreamProtocol<TInbound, ()>: Clone,
TEvent: Debug + Send + 'static,
impl<TInbound, TOutbound, TEvent> ProtocolsHandler for OneShotHandler<TInbound, TOutbound, TEvent> where
TInbound: InboundUpgradeSend + Send + 'static,
TOutbound: Debug + OutboundUpgradeSend,
TInbound::Output: Into<TEvent>,
TOutbound::Output: Into<TEvent>,
TOutbound::Error: Error + Send + 'static,
SubstreamProtocol<TInbound, ()>: Clone,
TEvent: Debug + Send + 'static,
type InEvent = TOutbound
type InEvent = TOutbound
Custom event that can be received from the outside.
type OutEvent = TEvent
type OutEvent = TEvent
Custom event that can be produced by the handler and that will be returned to the outside.
type Error = ProtocolsHandlerUpgrErr<<Self::OutboundProtocol as OutboundUpgradeSend>::Error>
type Error = ProtocolsHandlerUpgrErr<<Self::OutboundProtocol as OutboundUpgradeSend>::Error>
The type of errors returned by ProtocolsHandler::poll
.
type InboundProtocol = TInbound
type InboundProtocol = TInbound
The inbound upgrade for the protocol(s) used by the handler.
type OutboundProtocol = TOutbound
type OutboundProtocol = TOutbound
The outbound upgrade for the protocol(s) used by the handler.
type OutboundOpenInfo = ()
type OutboundOpenInfo = ()
The type of additional information passed to an OutboundSubstreamRequest
.
type InboundOpenInfo = ()
type InboundOpenInfo = ()
The type of additional information returned from listen_protocol
.
The InboundUpgrade
to apply on inbound
substreams to negotiate the desired protocols. Read more
fn inject_fully_negotiated_inbound(
&mut self,
out: <Self::InboundProtocol as InboundUpgradeSend>::Output,
(): Self::InboundOpenInfo
)
fn inject_fully_negotiated_inbound(
&mut self,
out: <Self::InboundProtocol as InboundUpgradeSend>::Output,
(): Self::InboundOpenInfo
)
Injects the output of a successful upgrade on a new inbound substream.
fn inject_fully_negotiated_outbound(
&mut self,
out: <Self::OutboundProtocol as OutboundUpgradeSend>::Output,
_: Self::OutboundOpenInfo
)
fn inject_fully_negotiated_outbound(
&mut self,
out: <Self::OutboundProtocol as OutboundUpgradeSend>::Output,
_: Self::OutboundOpenInfo
)
Injects the output of a successful upgrade on a new outbound substream. Read more
Injects an event coming from the outside in the handler.
fn inject_dial_upgrade_error(
&mut self,
_info: Self::OutboundOpenInfo,
error: ProtocolsHandlerUpgrErr<<Self::OutboundProtocol as OutboundUpgradeSend>::Error>
)
fn inject_dial_upgrade_error(
&mut self,
_info: Self::OutboundOpenInfo,
error: ProtocolsHandlerUpgrErr<<Self::OutboundProtocol as OutboundUpgradeSend>::Error>
)
Indicates to the handler that upgrading an outbound substream to the given protocol has failed.
Returns until when the connection should be kept alive. Read more
fn poll(
&mut self,
_: &mut Context<'_>
) -> Poll<ProtocolsHandlerEvent<Self::OutboundProtocol, Self::OutboundOpenInfo, Self::OutEvent, Self::Error>>
fn poll(
&mut self,
_: &mut Context<'_>
) -> Poll<ProtocolsHandlerEvent<Self::OutboundProtocol, Self::OutboundOpenInfo, Self::OutEvent, Self::Error>>
Should behave like Stream::poll()
.
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>
)
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>,
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,
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,
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. Read more
Creates a builder that allows creating a NodeHandler
that handles this protocol
exclusively. Read more
Auto Trait Implementations
impl<TInbound, TOutbound, TEvent> !RefUnwindSafe for OneShotHandler<TInbound, TOutbound, TEvent>
impl<TInbound, TOutbound, TEvent> Send for OneShotHandler<TInbound, TOutbound, TEvent> where
TEvent: Send,
TInbound: Send,
impl<TInbound, TOutbound, TEvent> Sync for OneShotHandler<TInbound, TOutbound, TEvent> where
TEvent: Sync,
TInbound: Sync,
TOutbound: Sync,
<TOutbound as OutboundUpgradeSend>::Error: Sync,
impl<TInbound, TOutbound, TEvent> Unpin for OneShotHandler<TInbound, TOutbound, TEvent> where
TEvent: Unpin,
TInbound: Unpin,
TOutbound: Unpin,
<TOutbound as OutboundUpgradeSend>::Error: Unpin,
impl<TInbound, TOutbound, TEvent> !UnwindSafe for OneShotHandler<TInbound, TOutbound, TEvent>
Blanket Implementations
Mutably borrows from an owned value. Read more
type Handler = Self
type Handler = Self
The protocols handler.
Builds the protocols handler. Read more
Return the handler’s inbound protocol.
fn select<TProto2>(
self,
other: TProto2
) -> IntoProtocolsHandlerSelect<Self, TProto2> where
Self: Sized,
fn select<TProto2>(
self,
other: TProto2
) -> IntoProtocolsHandlerSelect<Self, TProto2> where
Self: Sized,
Builds an implementation of IntoProtocolsHandler
that handles both this protocol and the
other one together. Read more
Creates a builder that will allow creating a NodeHandler
that handles this protocol
exclusively. Read more