Struct ServiceHandler 

pub struct ServiceHandler { /* private fields */ }

Handle for managing a running service: grpc or http.

This handle provides control over a running service, allowing you to:

• Wait for the service to start accepting connections
• Signal graceful shutdown
• Wait for the service to fully stop
• Check if the service task has completed

The handle uses a cancellation token for graceful shutdown and provides async methods for coordinating server lifecycle events.

Implementations

impl ServiceHandler

pub async fn wait_for_start(&mut self) -> Result<()>

Waits for the server to start accepting connections.

This method blocks until the server has successfully bound to its configured address and is ready to accept gRPC requests.

Panics

Panics if called more than once, as the start signal is consumed.

pub async fn wait_for_stop(self) -> Result<()>

Waits for the server to completely stop.

This method consumes the handle and blocks until the server task has finished executing. Use this after calling shutdown() to ensure clean termination.

Panics

Panics if the server task panicked during execution.

pub fn shutdown(&self)

Signals the server to begin graceful shutdown.

This method triggers the shutdown process but does not wait for completion. Use wait_for_stop() to wait for the server to fully stop.

pub fn is_finished(&self) -> bool

Checks if the server task has completed.

Returns true if the server has finished running, either due to shutdown or an error condition.