Cirreum.Startup 1.0.117

Cirreum - Startup Library

This package defines contracts and extension methods for startup services in C# .NET and Blazor applications.

Description

Cirreum.Startup allows developers to define one or more classes that implement specific interfaces, which are then automatically executed during application startup. This is particularly useful for initializing services, performing setup tasks, or executing configuration logic before the application begins its normal operation.

Key Interfaces

1. ISystemInitializer

• Purpose: Defines a service that performs core application initialization, setup, or configuration.
• Execution Order: Runs first, before any other startup services.
• Usage: Typically used by component/library/service authors for critical system setup.
• Restrictions: Must not depend on other startup interfaces.

2. IAutoInitialize

• Purpose: Allows existing services to be automatically initialized during application startup.
• Execution Order: Runs after ISystemInitializer and before IStartupTask.
• Usage: Useful for services that need initialization before they can be used.
• Auto-registration: The system attempts to auto-register services implementing this interface.

3. IStartupTask

• Purpose: Defines a service that performs tasks after the application has been initialized.
• Execution Order: Runs last, after ISystemInitializer and IAutoInitialize.
• Customizable Priority: Includes an Order property to specify execution priority.

Important Notes

• These interfaces are intended for Singleton services (Scoped in Blazor WASM).
• Services implementing these interfaces are materialized during startup and are not disposed.
• Each interface's primary method (RunAsync, InitializeAsync, ExecuteAsync) is called only once during application startup.

Usage

Implement the appropriate interface based on your initialization needs:

• Use ISystemInitializer for core system setup.
• Use IAutoInitialize for general service initialization.
• Use IStartupTask for tasks that should run after the application is fully initialized.

Refer to individual interface documentation for detailed usage examples and restrictions.

Cirreum Foundation Framework - Layered simplicity for modern .NET