Struct ServiceConfig 

pub struct ServiceConfig<Cfg: ServerAppConfig>(/* private fields */);

Listener and worker configuration used by ServerBuilder::configure.

Listeners are registered by name. Each worker then runs the on_worker_start callbacks, which attach a service to each name through ServiceRuntime::service.

Implementations

impl<Cfg: ServerAppConfig> ServiceConfig<Cfg>

pub fn bind( &self, name: impl AsRef<str>, addr: impl ToSocketAddrs, ) -> Result<&Self>

Binds TCP listeners under the specified name.

A listener is created for every address resolved from addr, using the builder’s backlog. Binding succeeds if at least one address binds. The service for name is attached later with ServiceRuntime::service.

pub fn listen(&self, name: impl AsRef<str>, lst: TcpListener) -> &Self

Registers an existing TCP listener under the specified name.

The listener is switched to non-blocking mode. The service for name is attached later with ServiceRuntime::service.

pub fn on_worker_start<F>(&self, f: F) -> &Self

where F: AsyncFnOnce(ServiceRuntime<Cfg::State>) -> Result<()> + Send + Clone + 'static,

Registers an asynchronous worker configuration callback.

The callback runs on each worker thread while the worker creates its services, and it should attach a service to every registered name. Multiple callbacks run in registration order. An error fails the worker’s service creation. Names left without a service are logged as errors, and their connections are dropped.

Trait Implementations

impl<Cfg: ServerAppConfig> Clone for ServiceConfig<Cfg>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Cfg: Debug + ServerAppConfig> Debug for ServiceConfig<Cfg>

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

Formats the value using the given formatter.