Struct ServiceHandle 

pub struct ServiceHandle { /* private fields */ }

Shared handle for spawning, stopping, and inspecting managed services.

Implementations

impl ServiceHandle

pub fn new(service: Arc<dyn ManagedService>, context: ServiceContext) -> Self

Creates a new handle around a service and context.

pub fn named( name: impl Into<String>, protocol: Option<Protocol>, service: Arc<dyn ManagedService>, ) -> Self

Creates a handle for a named service.

pub fn context(&self) -> ServiceContext

Returns the shared service context.

pub async fn spawn(&self) -> RuntimeResult<()>

Spawns the service task if it is not already running.

pub async fn stop(&self) -> RuntimeResult<()>

Requests service shutdown and waits for the service task.

pub async fn wait(&self) -> RuntimeResult<()>

Waits for the service task to finish if it was spawned.

pub async fn readiness( &self, max_wait: Duration, ) -> RuntimeResult<ServiceStatus>

Waits until the service reports readiness or the timeout elapses.

pub fn status(&self) -> ServiceStatus

Returns the latest status.

pub async fn snapshot(&self) -> RuntimeResult<ServiceSnapshot>

Returns the latest snapshot.