Struct AppBuilder 

pub struct AppBuilder<C>
where
    C: AppConfig,
{ /* private fields */ }

Builder for App.

The builder is the composition root for configuration validation, component registration, dependency injection, provider registration, and lifecycle hook ordering.

Implementations

impl<C> AppBuilder<C>

where C: AppConfig,

pub fn new(config: C) -> AppBuilder<C>

Create a new builder with the given application configuration.

pub fn with_graceful_timeout(self, timeout: Duration) -> AppBuilder<C>

Set the graceful shutdown timeout.

pub fn with_component(self, component: Arc<dyn Component>) -> AppBuilder<C>

Register a component to be started and stopped by the app lifecycle.

pub fn with_container(self, container: Arc<Container>) -> AppBuilder<C>

Use an existing typed DI container as the application container.

pub fn with_lifecycle_event_bus( self, lifecycle_events: EventBus<LifecycleEvent>, ) -> AppBuilder<C>

Use an existing bounded lifecycle event bus.

pub fn with_dependency<T>(self, dependency: Arc<T>) -> AppBuilder<C>

where T: Send + Sync + 'static,

Register a typed dependency in the application DI container.

pub fn with_provider<P>(self, provider: Arc<P>) -> AppBuilder<C>

where P: Provider + Send + Sync + 'static,

Register a provider implementation in the application DI container.

pub fn before_start<F, Fut>(self, hook: F) -> AppBuilder<C>

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

Register a hook called before components start.

pub fn after_start<F, Fut>(self, hook: F) -> AppBuilder<C>

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

Register a hook called after components start and readiness checks pass.

pub fn before_stop<F, Fut>(self, hook: F) -> AppBuilder<C>

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

Register a hook called before components stop.

pub fn after_stop<F, Fut>(self, hook: F) -> AppBuilder<C>

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

Register a hook called after components stop.

pub fn build(self) -> Result<App<Built, C>, AppError>

Validate config and build the application in the Built state.