Skip to main content

Service

rs_zero::core::service

Trait Service

pub trait Service:
    Send
    + Sync
    + 'static {
    // Required methods
    fn name(&self) -> &str;
    fn start(&self, shutdown: ShutdownToken) -> ServiceFuture<'_>;

    // Provided method
    fn stop(&self) -> ServiceFuture<'_> { ... }
}

Expand description

Async service lifecycle managed by crate::core::ServiceGroup.

Implementors should return from Service::start when the supplied ShutdownToken is cancelled. Service::stop is a best-effort hook used to unblock resources that do not observe the token directly.

Required Methods§

fn name(&self) -> &str

Logical service name used in logs and error messages.

fn start(&self, shutdown: ShutdownToken) -> ServiceFuture<'_>

Starts the service and runs until shutdown or failure.

Provided Methods§

fn stop(&self) -> ServiceFuture<'_>

Stops the service. The default implementation is a no-op.

Implementations on Foreign Types§

impl Service for Arc<RestService>

fn name(&self) -> &str

fn start(&self, shutdown: ShutdownToken) -> ServiceFuture<'_>

fn stop(&self) -> ServiceFuture<'_>

Implementors§

impl Service for RestService

impl Service for TonicHealthService

impl<F, Fut> Service for FnService<F>
where F: Fn(ShutdownToken) -> Fut + Send + Sync + 'static, Fut: Future<Output = CoreResult<()>> + Send + 'static,

impl<S> Service for TonicService<S>
where S: Service<Request<Body>, Response = Response<Body>, Error = Infallible> + NamedService + Clone + Send + Sync + 'static, S::Future: Send + 'static,