Struct ckb_network::ServiceBuilder

source · [−]

pub struct ServiceBuilder { /* private fields */ }

Expand description

Builder for Service

Implementations

source

impl ServiceBuilder

source

pub fn new() -> ServiceBuilder

New a default empty builder

source

pub fn build<H>(self, handle: H) -> Service<H> where
H: ServiceHandle + Unpin,

Combine the configuration of this builder with service handle to create a Service.

source

pub fn insert_protocol(self, protocol: ProtocolMeta) -> ServiceBuilder

Insert a custom protocol

source

pub fn key_pair(self, key_pair: SecioKeyPair) -> ServiceBuilder

Enable encrypted communication mode.

If you do not need encrypted communication, you do not need to call this method

source

pub fn forever(self, forever: bool) -> ServiceBuilder

When the service has no tasks, it will be turned off by default. If you do not want to close service, set it to true.

source

pub fn timeout(self, timeout: Duration) -> ServiceBuilder

Timeout for handshake and connect

Default 10 second

source

pub fn yamux_config(self, config: Config) -> ServiceBuilder

Yamux config for service

Panic when max_frame_length < yamux_max_window_size

source

pub fn max_frame_length(self, size: usize) -> ServiceBuilder

Secio max frame length

Panic when max_frame_length < yamux_max_window_size

source

pub fn set_send_buffer_size(self, size: usize) -> ServiceBuilder

Set send buffer size, default is 24Mb

source

pub fn set_recv_buffer_size(self, size: usize) -> ServiceBuilder

Set receive buffer size, default is 24Mb

source

pub fn keep_buffer(self, keep: bool) -> ServiceBuilder

If session is close by remote, did you want to keep unreceived message as more as possible default is false

source

pub fn upnp(self, enable: bool) -> ServiceBuilder

Whether to allow tentative registration upnp, default is disable(false)

upnp: https://en.wikipedia.org/wiki/Universal_Plug_and_Play

Upnp is a simple solution to nat penetration, which requires routing support for registration mapping.

The function provided here is that if the external ip of the query route is a public network, then an attempt is made to register the local listener port into the mapping so that it can receive the access request of the external network, and if the external ip of the route is not the public network, Then do nothing

source

pub fn max_connection_number(self, number: usize) -> ServiceBuilder

The limit of max open connection(file descriptors) If not limited, service will try to serve as many connections as possible until it exhausts system resources(os error), and then close the listener, no longer accepting new connection requests, and the established connections remain working

Default is 65535

source

pub fn tcp_bind(self, addr: Multiaddr) -> ServiceBuilder

Bind all the outbound connections to the local listening address.

In this way, any actively connected outbound connection is potentially connectable. Through this setting, the device after NAT can have the opportunity to be connected to the public network.

TCP Hole Punching: http://bford.info/pub/net/p2pnat/ STUN: https://tools.ietf.org/html/rfc5389

source