Struct App

Source

pub struct App;

Expand description

Application container facade

Provides static methods for service registration and resolution. Uses a global container with thread-local test overrides.

§Example

use ferro_rs::{App, bind, singleton};

// Register services at startup using macros
singleton!(DatabaseConnection::new(&url));
bind!(dyn HttpClient, RealHttpClient::new());

// Resolve anywhere
let db: DatabaseConnection = App::get().unwrap();
let client: Arc<dyn HttpClient> = App::make::<dyn HttpClient>().unwrap();

Implementations§

Source §

impl App

Source

pub fn init()

Initialize the application container

Should be called once at application startup. This is automatically called by Server::from_config().

Source

pub fn singleton<T: Any + Send + Sync + 'static>(instance: T)

Register a singleton instance (shared across all resolutions)

§Example

App::singleton(DatabaseConnection::new(&url));

Source

pub fn factory<T, F>(factory: F)
where T: Any + Send + Sync + 'static, F: Fn() -> T + Send + Sync + 'static,

Register a factory binding (new instance per resolution)

§Example

App::factory(|| RequestLogger::new());

Source

pub fn bind<T: ?Sized + Send + Sync + 'static>(instance: Arc<T>)

Bind a trait object to a concrete implementation (as singleton)

§Example

App::bind::<dyn HttpClient>(Arc::new(RealHttpClient::new()));

Source

pub fn bind_factory<T: ?Sized + Send + Sync + 'static, F>(factory: F)
where F: Fn() -> Arc<T> + Send + Sync + 'static,

Bind a trait object to a factory

§Example

App::bind_factory::<dyn HttpClient>(|| Arc::new(RealHttpClient::new()));

Source

pub fn get<T: Any + Send + Sync + Clone + 'static>() -> Option<T>

Resolve a concrete type

Checks test overrides first, then falls back to global container.

§Example

let db: DatabaseConnection = App::get().unwrap();

Source

pub fn make<T: ?Sized + Send + Sync + 'static>() -> Option<Arc<T>>

Resolve a trait binding - returns Arc<T>

Checks test overrides first, then falls back to global container.

§Example

let client: Arc<dyn HttpClient> = App::make::<dyn HttpClient>().unwrap();

Source

pub fn resolve<T: Any + Send + Sync + Clone + 'static>() -> Result<T, FrameworkError>

Resolve a concrete type, returning an error if not found

This allows using the ? operator in controllers and services for automatic error propagation with proper HTTP responses.

§Example

pub async fn index(_req: Request) -> Response {
    let service = App::resolve::<MyService>()?;
    // ...
}

Source

pub fn resolve_make<T: ?Sized + Send + Sync + 'static>() -> Result<Arc<T>, FrameworkError>

Resolve a trait binding, returning an error if not found

This allows using the ? operator for trait object resolution.

§Example

let client: Arc<dyn HttpClient> = App::resolve_make::<dyn HttpClient>()?;

Source

pub fn has<T: Any + 'static>() -> bool

Check if a concrete type is registered

Source

pub fn has_binding<T: ?Sized + 'static>() -> bool

Check if a trait binding is registered

Source

pub fn boot_services()

Boot all auto-registered services

This registers all services marked with #[service(ConcreteType)]. Called automatically by Server::from_config().

Source

pub fn set_inertia_config(config: InertiaConfig)

Set the process-global Inertia configuration.

Call once from bootstrap.rs before the server starts accepting requests. A downstream app then supplies only page props; the root template (title, <head> extras, mount node) comes from this config.

Subsequent calls are ignored (OnceLock semantics); a warning is emitted on the second call to surface the mistake.

Auto Trait Implementations§

§

impl UnwindSafe for App

Blanket Implementations§

Source §

impl<T> Any for T
where T: 'static + ?Sized,

Source §

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

Source §

impl<T> Borrow<T> for T
where T: ?Sized,

Source §

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

Source §

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source §

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

Source §

impl<T> Chain<T> for T

Source §

fn len(&self) -> usize

The number of items that this chain link consists of.

Source §

fn append_to(self, v: &mut Vec<T>)

Append the elements in this link to the chain.

Source §

impl<T> From<T> for T

Source §

fn from(t: T) -> T

Returns the argument unchanged.

Source §

impl<T> Instrument for T

Source §

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Source §

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Source §

impl<T, U> Into for T
where U: From<T>,

Source §

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source §

impl<T> IntoEither for T

Source §

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

Source §

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

Source §