Struct Plugin 

pub struct Plugin { /* private fields */ }

A lexical provider scope containing operations and nested plugins.

Implementations

impl Plugin

pub fn new(name: impl Into<String>) -> Self

pub fn provide(self, provider: Provider) -> Self

pub fn security_scheme(self, scheme: SecuritySchemeDescriptor) -> Self

Registers an application security scheme from this plugin scope.

pub fn operation(self, operation: ExecutableOperation) -> Self

pub fn routes( self, operations: impl IntoIterator<Item = ExecutableOperation>, ) -> Self

pub fn plugin(self, plugin: Self) -> Self

pub fn on_request<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext) -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async hook that runs before dependency resolution.

pub fn pre_parse<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext) -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async hook before typed input extraction begins.

pub fn pre_validate<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext) -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async hook immediately before input validation.

pub fn pre_handler<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext) -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async hook after input preparation and before the user handler future is polled.

pub fn pre_serialize<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext) -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async hook after the handler and before transport response projection.

pub fn on_error<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext, HookOutcome) -> HookFuture + 'static, HookFuture: Future<Output = ()> + 'static,

Adds an async observer for rejected, domain-error, and internal-error outcomes.

pub fn on_response<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn(HookContext, HookOutcome) -> HookFuture + 'static, HookFuture: Future<Output = ()> + 'static,

Adds an async observer that runs after the handler and DI finalizers.

pub fn on_startup<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn() -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async application startup hook.

Startup executes parent hooks before child hooks. A failure stops startup before the server accepts requests.

pub fn on_shutdown<Hook, HookFuture>(self, hook: Hook) -> Self

where Hook: Fn() -> HookFuture + 'static, HookFuture: Future<Output = Result<(), DependencyError>> + 'static,

Adds a fallible async application shutdown hook.

Shutdown executes child hooks before parent hooks and continues after a failure so every registered cleanup receives a chance to run.