Struct ServiceHandle 

pub struct ServiceHandle { /* private fields */ }

A handle to a service in the server.

This is returned by crate::server::Server::add_service() and provides methods to declare that other services depend on this one.

Example

let db_handle = server.add_service(database_service);
let cache_handle = server.add_service(cache_service);

let api_handle = server.add_service(api_service);
api_handle.add_dependency(&db_handle);
api_handle.add_dependency(&cache_handle);

Implementations

impl ServiceHandle

pub fn name(&self) -> &str

Returns the name of the service.

pub fn add_dependency(&self, dependency: impl Borrow<ServiceHandle>)

Declares that this service depends on another service.

This service will not start until the specified dependency has started and signaled readiness.

Example

let db_id = server.add_service(database_service);
let api_id = server.add_service(api_service);

// API service depends on database
api_id.add_dependency(&db_id);

pub fn add_dependencies<'a, D>(&self, dependencies: impl IntoIterator<Item = D>)

where D: Borrow<ServiceHandle> + 'a,

Declares that this service depends on the given other services.

This service will not start until the specified dependencies have started and signaled readiness.

Example

let db_id = server.add_service(database_service);
let cache_id = server.add_service(cache_service);
let api_id = server.add_service(api_service);

// API service depends on database
api_id.add_dependencies(&[&db_id, &cache_id]);

Trait Implementations

impl Clone for ServiceHandle

fn clone(&self) -> ServiceHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceHandle

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

Formats the value using the given formatter.