Struct SharedServiceBuilder 

pub struct SharedServiceBuilder { /* private fields */ }

Builder for SharedService.

Implementations

impl SharedServiceBuilder

pub fn new(name: &str) -> Self

Create a new builder.

pub fn base_dir(self, dir: impl Into<PathBuf>) -> Self

Set base directory for service info files.

pub fn on_first_acquire<F, Fut>(self, f: F) -> Self

where F: Fn() -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ServiceInfo>> + Send + 'static,

Set callback for first client (service startup).

This is called when the first client acquires a reference. It should start the service and return ServiceInfo.

pub fn on_last_release<F, Fut>(self, f: F) -> Self

where F: Fn(ServiceInfo) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<()>> + Send + 'static,

Set callback for last client (service shutdown).

This is called when the last client releases their reference. It should stop the service.

pub fn on_health_check<F, Fut>(self, f: F) -> Self

where F: Fn(&ServiceInfo) -> Fut + Send + Sync + 'static, Fut: Future<Output = bool> + Send + 'static,

Set callback for health check.

This is called to verify the service is healthy. Return true if healthy, false if recovery is needed.

pub fn on_recover<F, Fut>(self, f: F) -> Self

where F: Fn(ServiceInfo) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<ServiceInfo>> + Send + 'static,

Set callback for recovery.

This is called when health check fails. It should recover the service and return new ServiceInfo.

pub fn build(self) -> Result<SharedService>

Build the SharedService.