Stashbox

https://github.com/z4kn4fein/stashbox
Admin
Stashbox is a lightweight, fast, and portable dependency injection framework for .NET-based...
Tokens:34,782
Snippets:466
Trust Score:8.7
License:MIT
Update:4 months ago
Show doc for...
Tokens:
Raw
### Resolution Tree Example

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/glossary.md

Illustrates the instantiation order of dependencies required to resolve a target type. This helps visualize the dependency graph.

```cs
class A
{
    public A(B b, C c) { }
}

class B
{
    public B(C c, D d) { }
}

class C { }
class D { }
```

--------------------------------

### ConstructorNotFoundException Example

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/diagnostics/validation.md

Shows how ConstructorNotFoundException is thrown when attempting to register a service with non-existent constructor argument types.

```csharp
class Service
{
    public Service(Dependency dep) { }
}

container.Register<Service>(options => options.WithConstructorByArgumentTypes(typeof(string), typeof(int)));
```

```text
Constructor not found for Namespace.Service with the given argument types: System.String, System.Int32.
```

--------------------------------

### Property/Field Injection Example

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/service-resolution.md

Shows how to register and resolve a service with property/field injection enabled. Use 'WithAutoMemberInjection()' during registration to allow Stashbox to inject properties.

```cs
class DbBackup : IJob
{
    public ILogger Logger { get; set; }
    public IEventBroadcaster EventBroadcaster { get; set; }

    public DbBackup() 
    { }
}

container.Register<ILogger, ConsoleLogger>();
container.Register<IEventBroadcaster, MessageBus>();

// registration of service with auto member injection.
container.Register<IJob, DbBackup>(options => 
    options.WithAutoMemberInjection());

// resolution will inject the properties.
IJob job = container.Resolve<IJob>();
```

--------------------------------

### Install Stashbox via Package Manager Console

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/introduction.md

Use this command in the Package Manager Console to install the Stashbox NuGet package.

```powershell
Install-Package Stashbox -Version 5.20.0
```

--------------------------------

### Constructor Injection Example

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/service-resolution.md

Demonstrates how to register and resolve a service using constructor injection. Ensure the required services (ILogger, IEventBroadcaster) are registered before resolving the dependent service (IJob).

```cs
class DbBackup : IJob
{
    private readonly ILogger logger;
    private readonly IEventBroadcaster eventBroadcaster;

    public DbBackup(ILogger logger, IEventBroadcaster eventBroadcaster)
    {
        this.logger = logger;
        this.eventBroadcaster = eventBroadcaster;
    }
}

container.Register<ILogger, ConsoleLogger>();
container.Register<IEventBroadcaster, MessageBus>();

container.Register<IJob, DbBackup>();

// resolution using the available constructor.
IJob job = container.Resolve<IJob>();
```

--------------------------------

### Initialize Container with Configuration Options

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/container-configuration.md

Configure container behavior during initialization using a fluent API. This example sets rules for disposable transient tracking, constructor selection, and registration behavior.

```cs
var container = new StashboxContainer(options => options
    .WithDisposableTransientTracking()
    .WithConstructorSelectionRule(Rules.ConstructorSelection.PreferLeastParameters)
    .WithRegistrationBehavior(Rules.RegistrationBehavior.ThrowException));
```

--------------------------------

### Implementing a Logging Interceptor

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

Provides an example of a LoggingInterceptor that uses Castle DynamicProxy to log method calls before and after execution, including execution duration. This demonstrates Aspect-Oriented Programming.

```cs
public class LoggingInterceptor : IInterceptor 
{
    private readonly ILogger logger;

    public LoggingInterceptor(ILogger logger)
    {
        this.logger = logger;
    }

    public void Intercept(IInvocation invocation)
    {
        var stopwatch = new Stopwatch();
        stopwatch.Start();

        // log before we invoke the intercepted method.
        this.logger.Log($"Method begin: {invocation.GetConcreteMethod().Name}");

        // call the intercepted method.
        invocation.Proceed();

        // log after we invoked the intercepted method and print how long it ran.
        this.logger.Log($"Method end: {invocation.GetConcreteMethod().Name}, execution duration: {stopwatch.ElapsedMiliseconds} ms");
    }
}

// create a DefaultProxyBuilder from the DynamicProxy library.
var proxyBuilder = new DefaultProxyBuilder();

// build a proxy for the IEventProcessor interface.
var eventProcessorProxy = proxyBuilder.CreateInterfaceProxyTypeWithTargetInterface(
    typeof(IEventProcessor), 
    new Type[0], 
    ProxyGenerationOptions.Default);

// register the logger for LoggingInterceptor.
container.Register<ILogger, ConsoleLogger>();

// register the service that we will intercept.
container.Register<IEventProcessor, GeneralEventProcessor>();

// register the interceptor.
container.Register<IInterceptor, LoggingInterceptor>();

// register the built proxy as a decorator.
container.RegisterDecorator<IEventProcessor>(eventProcessorProxy);

```

--------------------------------

### Install Stashbox via dotnet CLI

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/introduction.md

Use this command with the dotnet CLI to add Stashbox as a package dependency.

```bash
dotnet add package Stashbox --version 5.20.0
```

--------------------------------

### Registering a service with a custom lifetime

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

This example shows how to register a service using a custom lifetime implementation. It assumes a 'CustomLifetime' class has been defined elsewhere, inheriting from either ExpressionLifetimeDescriptor or FactoryLifetimeDescriptor.

```cs
container.Register<IJob, DbBackup>(options => options.WithLifetime(new CustomLifetime()));
```

--------------------------------

### Re-configure Existing Container

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/container-configuration.md

Modify an existing container's configuration by calling the .Configure() method. This example enables tracking of disposable transient objects.

```cs
var container = new StashboxContainer();
container.Configure(options => options.WithDisposableTransientTracking());
```

--------------------------------

### Registering a service instance without wire-up

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Register an existing instance of a service using `WithInstance`. This example creates a new `ConsoleLogger` instance without enabling member/method injection.

```csharp
container.Register<ILogger>(options => options
    .WithInstance(new ConsoleLogger()));
```

--------------------------------

### Registering Multiple Decorators for Service Extension

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

This example demonstrates how to register multiple decorators for a single service. The decorators are applied in the order they are registered, creating a pipeline of extended functionality. The first registered decorator wraps the base service, and subsequent decorators wrap the already decorated service.

```cs
container.Register<IEventProcessor, GeneralProcessor>();
container.RegisterDecorator<IEventProcessor, LoggerProcessor>();
container.RegisterDecorator<IEventProcessor, ValidatorProcessor>();

// new ValidatorProcessor(new LoggerProcessor(new GeneralProcessor()));
var processor = container.Resolve<IEventProcessor>();
```

--------------------------------

### Fluent Registration and Resolution

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/basics.md

Chain multiple registration calls using the fluent API for concise setup. This allows registering several services and resolving one in a single statement.

```cs
var job = container.Register<IJob, DbBackup>()
    .Register<ILogger, ConsoleLogger>()
    .Resolve<IJob>();
```

--------------------------------

### Registering a service with a custom initializer

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Set a custom initializer delegate for a service registration using `WithInitializer`. This delegate will be invoked when the service is being instantiated, allowing for custom setup logic.

```csharp
container.Register<ILogger, FileLogger>(options => options
    .WithInitializer((logger, resolver) => logger
        .OpenFile()));
```

--------------------------------

### CompositionRootNotFoundException Example

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/diagnostics/validation.md

Illustrates the scenario where container.ComposeAssembly is called without an ICompositionRoot implementation in the target assembly.

```csharp
container.ComposeAssembly(typeof(Service).Assembly);
```

```text
No ICompositionRoot found in the given assembly: {your-assembly-name}
```

--------------------------------

### Get all service registration mappings

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/diagnostics/utilities.md

Call GetRegistrationMappings() to retrieve all registrations in the container as a collection of KeyValuePair<Type, ServiceRegistration>.

```cs
IEnumerable<KeyValuePair<Type, ServiceRegistration>> mappings = 
    container.GetRegistrationMappings();
```

--------------------------------

### Registering a Single Decorator for Event Processing

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

This example shows how to register a validator decorator for an IEventProcessor service. The decorator adds validation logic before the main processing occurs. It demonstrates the composition of services using decorators.

```cs
class Event { }
class UpdateEvent : Event { }

interface IEventProcessor
{
    void ProcessEvent(Event @event);
}

interface IEventValidator
{
    bool IsValid(Event @event);
}

class EventValidator : IEventValidator
{
    public bool IsValid(Event @event) { /* do the actual validation. */ }
}

class GeneralEventProcessor : IEventProcessor
{
    public void ProcessEvent(Event @event)
    {
        // suppose this method is processing the given event.
        this.DoTheActualProcessing(@event);
    }
}

class ValidatorProcessor : IEventProcessor
{
    private readonly IEventProcessor nextProcessor;
    private readonly IEventValidator eventValidator;
    public ValidatorProcessor(IEventProcessor eventProcessor, IEventValidator eventValidator)
    {
        this.nextProcessor = eventProcessor;
        this.eventValidator = eventValidator;
    }

    public void ProcessEvent(Event @event)
    {
        // validate the event first.
        if (!this.eventValidator.IsValid(@event))
            throw new InvalidEventException();

        // if everything is ok, call the next processor.
        this.nextProcessor.ProcessEvent(@event);
    }
}

using var container = new StashboxContainer();

container.Register<IEventValidator, EventValidator>();
container.Register<IEventProcessor, GeneralEventProcessor>();
container.RegisterDecorator<IEventProcessor, ValidatorProcessor>();

// new ValidatorProcessor(new GeneralEventProcessor(), new EventValidator())
var eventProcessor = container.Resolve<IEventProcessor>();

// process the event.
eventProcessor.ProcessEvent(new UpdateEvent());
```

--------------------------------

### Registering a service in a named scope

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

Use this to register a service that will only be resolved when a scope with the same name initiates the request. The example shows registering IJob in 'DbScope' and resolving it within that scope.

```cs
container.Register<IJob, DbBackup>(options => options
    .InNamedScope("DbScope"));

using var scope = container.BeginScope("DbScope");
IJob job = scope.Resolve<IJob>();
```

--------------------------------

### Resolve Unknown Types With Registration Configuration

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/special-resolution-cases.md

With a registration configuration for unknown type resolution, you can control how individual registrations behave and react to resolution requests. This example maps an unregistered 'IDependency' to 'Dependency' with a singleton lifetime.

```cs
interface IDependency { }

class Dependency : IDependency { }

class Service 
{
    public Service(IDependency dependency)
    {
    }
}

var container = new StashboxContainer(config => config
    .WithUnknownTypeResolution(options => 
    {
        if(options.ServiceType == typeof(IDependency))
        {
            options.SetImplementationType(typeof(Dependency))
                .WithLifetime(Lifetimes.Singleton);
        }
    }));

container.Register<Service>();

var service = container.Resolve<Service>();
```

--------------------------------

### Combine Auto Member Injection Rules

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/container-configuration.md

Combine multiple auto-injection rules using bitwise logical operators to create a custom ruleset. This example enables injection for both private fields and properties with public setters.

```cs
new StashboxContainer(options => options
    .WithAutoMemberInjection(Rules.AutoMemberInjectionRules.PrivateFields | 
        Rules.AutoMemberInjectionRules.PropertiesWithPublicSetter));
```

--------------------------------

### Registering an instance with options

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Register an existing instance of a service using the `WithInstance` option. This allows you to pre-instantiate services and manage their lifecycle.

```csharp
container.Register<IJob, DbBackup>(options => options
    .WithInstance(new DbBackup()));
```

--------------------------------

### Resolve Service with Metadata using Metadata, ValueTuple, and Tuple

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/wrappers-resolvers.md

Demonstrates how to register a service with metadata and then resolve it using Metadata<,>, ValueTuple<,>, or Tuple<,>. Use ValueTuple or Tuple to avoid direct Stashbox referencing.

```cs
container.Register<IJob, DbBackup>(options => options
    .WithMetadata("connection-string-to-db"));

var jobWithConnectionString = container.Resolve<Metadata<IJob, string>>();
// prints: "connection-string-to-db"
Console.WriteLine(jobWithConnectionString.Data);

var alsoJobWithConnectionString = container.Resolve<ValueTuple<IJob, string>>();
// prints: "connection-string-to-db"
Console.WriteLine(alsoJobWithConnectionString.Item2);

var stillJobWithConnectionString = container.Resolve<Tuple<IJob, string>>();
// prints: "connection-string-to-db"
Console.WriteLine(stillJobWithConnectionString.Item2);
```

--------------------------------

### Create a Scoped Service Instance

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Demonstrates how to register a scoped service and resolve it within a scope. Instances resolved within the same scope are guaranteed to be the same.

```cs
container.RegisterScoped<IJob, DbBackup>();

// create the scope with using so it'll be auto disposed.
using (var scope = container.BeginScope())
{
    IJob job = scope.Resolve<IJob>();
    IJob jobAgain = scope.Resolve<IJob>();
    // job and jobAgain are created in the 
    // same scope, so they are the same instance.
}
```

--------------------------------

### Get formatted registration diagnostics

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/diagnostics/utilities.md

Use GetRegistrationDiagnostics() to obtain a human-readable representation of all service registrations in the container. The output is formatted by the RegistrationDiagnosticsInfo.ToString() method.

```cs
container.Register<IJob, DbBackup>("DbBackupJob");
container.Register(typeof(IEventHandler<>), typeof(EventHandler<>));

IEnumerable<RegistrationDiagnosticsInfo> diagnostics = 
    container.GetRegistrationDiagnostics();

diagnostics.ForEach(Console.WriteLine);
// output:
// IJob => DbBackup, name: DbBackupJob
// IEventHandler<> => EventHandler<>, name: null
```

--------------------------------

### ResolutionFailedException: Missing Dependency in Property/Field

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/diagnostics/validation.md

Occurs when a dependency required by a property or field is not found. This example registers a Service and configures a dependency binding for its 'Dep' property.

```csharp
class Service
{
    public Dependency Dep { get; set; }
}

container.Register<Service>(options => options.WithDependencyBinding(s => s.Dep));
var service = container.Resolve<Service>();
```

```csharp
Could not resolve type Namespace.Service.
Unresolvable property: (Namespace.Dependency)Dep.
```

--------------------------------

### Register Logger with Console Attribute

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/service-resolution.md

Register an ILogger implementation to be resolved only when the injected parameter, property, or field has the 'Console' attribute. This example demonstrates attribute-based conditional resolution.

```cs
class ConsoleAttribute : Attribute { }

class DbBackup : IJob
{
    public DbBackup([Console]ILogger logger)
    {
    }
}

container.Register<ILogger, ConsoleLogger>(options => options
    // resolve only when the injected parameter, 
    // property or field has the 'Console' attribute
    .WhenHas<ConsoleAttribute>());

container.Register<IJob, DbBackup>();

// the container will resolve DbBackup with ConsoleLogger.
IJob job = container.Resolve<IJob>();
```

--------------------------------

### Chaining registration options

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Demonstrates the fluent nature of the registration configuration API by chaining multiple options together. This allows for concise and readable configuration of complex registrations.

```csharp
container.Register<IJob, DbBackup>(options => options
    .WithName("DbBackup")
    .WithLifetime(Lifetimes.Singleton)
    .WithoutDisposalTracking());
```

--------------------------------

### Async Disposal of Service within Scope (Explicit DisposeAsync)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Asynchronously dispose a scope to trigger the asynchronous disposal of tracked instances. This example uses explicit scope.DisposeAsync().

```cs
var scope = container.BeginScope();
var disposable = scope.Resolve<DisposableService>();

// 'disposable' will be disposed asynchronously with the scope.
await scope.DisposeAsync();
```

--------------------------------

### Parameterized Factory Registration (1-5 Parameters)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Register a service using a factory delegate that accepts a specific number of pre-resolved dependencies as parameters. This allows for complex object creation logic.

```csharp
// 1 parameter factory
container.Register<IUserRepository, UserRepository>(options => options
    .WithFactory<ILogger>(logger => new UserRepository(logger));

// 2 parameters factory
container.Register<IUserRepository, UserRepository>(options => options
    .WithFactory<ILogger, IDbContext>((logger, context) => new UserRepository(logger, context));

// 3 parameters factory
container.Register<IUserRepository, UserRepository>(options => options
    .WithFactory<ILogger, IDbContext, IOptions>((logger, context, options) => 
        new UserRepository(logger, context, options));

// 4 parameters factory
container.Register<IUserRepository, UserRepository>(options => options
    .WithFactory<ILogger, IDbConnection, IOptions, IUserValidator>((logger, connection, options, validator) => 
        new UserRepository(logger, connection, options, validator));

// 5 parameters factory
container.Register<IUserRepository, UserRepository>(options => options
    .WithFactory<ILogger, IDbConnection, IOptions, IUserValidator, IPermissionManage>(
        (logger, connection, options, validator, permissionManager) => 
            new UserRepository(logger, connection, options, validator, permissionManager));

```

--------------------------------

### Dispose Service within Scope (Explicit Dispose)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Manually dispose a scope to trigger the disposal of tracked disposable instances. This example uses explicit scope disposal.

```cs
var scope = container.BeginScope();
var disposable = scope.Resolve<DisposableService>();

// 'disposable' will be disposed with the scope.
scope.Dispose();
```

--------------------------------

### Post-Processing Instances with BuildUp

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/service-resolution.md

Employ the `BuildUp()` method to perform post-processing, such as property/field/method injection, on already constructed instances. Note that `BuildUp()` does not register the instance into the container.

```cs
class DbBackup : IJob
{
    public ILogger Logger { get; set; }
}

DbBackup backup = new DbBackup();
// the container fills the Logger property.
container.BuildUp(backup);
```

--------------------------------

### Registering a service for dynamic resolution

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Configure a service for dynamic resolution using `WithDynamicResolution`. This tells the container to use a `Resolve()` call during resolution instead of a pre-built expression.

```csharp
container.Register<IJob, DbBackup>();
container.Register<ILogger, ConsoleLogger>(options => options
    .WithDynamicResolution());

// new DbBackup(currentScope.Resolve<ILogger>());
var job = container.Resolve<IJob>();
```

--------------------------------

### ResolutionFailedException: Missing Dependency in Constructor

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/diagnostics/validation.md

Occurs when a dependency required by a constructor is not found in the resolution tree. This example shows a Service with two constructors, each requiring a different dependency.

```csharp
class Service
{
    public Service(Dependency dep) { }

    public Service(Dependency2 dep2) { }
}

container.Register<Service>();
var service = container.Resolve<Service>();
```

```csharp
Could not resolve type Namespace.Service.
Constructor Void .ctor(Dependency) found with unresolvable parameter: (Namespace.Dependency)dep.
Constructor Void .ctor(Dependency2) found with unresolvable parameter: (Namespace.Dependency2)dep2.
```

--------------------------------

### Registering a service instance with wire-up enabled

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Register an existing instance of a service using `WithInstance` and enable member/method injection by setting `wireUp` to `true`. This allows the container to inject dependencies into the provided instance.

```csharp
container.Register<ILogger>(options => options
    .WithInstance(new ConsoleLogger(), wireUp: true));
```

--------------------------------

### On-the-Fly Instance Activation

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/service-resolution.md

Use the `Activate()` method to create and dependency-inject instances of types without prior registration in the container. It supports dependency overriding and performs property/field/method injection.

```cs
// use dependency injected by container.
DbBackup backup = container.Activate<DbBackup>();

// override the injected dependency.
DbBackup backup = container.Activate<DbBackup>(new ConsoleLogger());
```

```cs
// use dependency injected by container.
object backup = container.Activate(typeof(DbBackup));

// override the injected dependency.
object backup = container.Activate(typeof(DbBackup), new ConsoleLogger());
```

--------------------------------

### Dispose Service within Scope (Using Statement)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Services implementing IDisposable or IAsyncDisposable are tracked and disposed when the scope is disposed. This example shows disposal using a 'using' statement.

```cs
using (var scope = container.BeginScope())
{
    var disposable = scope.Resolve<DisposableService>();
} // 'disposable' will be disposed when 
  // the using statement ends.
```

--------------------------------

### Apply Member Selection Filter for Auto Injection

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/container-configuration.md

Provide a custom member selection logic to control which members are auto-injected. This example excludes members of type ILogger from being auto-injected.

```cs
new StashboxContainer(options => options
    .WithAutoMemberInjection(
        filter: member => member.Type != typeof(ILogger)));
```

--------------------------------

### Register Service with Singleton Lifetime (Shorter Form)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

Registers a service with the Singleton lifetime using the RegisterSingleton shortcut. A single instance will be reused for all requests.

```cs
container.RegisterSingleton<IJob, DbBackup>();
```

--------------------------------

### InjectionMethod Attribute for Initialization

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/service-resolution.md

Use the InjectionMethod attribute to mark a method that Stashbox should call after the service has been instantiated. This method can be used for setup or initialization logic, potentially injecting dependencies.

```cs
class DbBackup : IJob
{
    [InjectionMethod]
    public void Initialize([Dependency("Console")]ILogger logger)
    {
        this.logger.Log("Initializing.");
    }
}

container.Register<ILogger, ConsoleLogger>("Console");
container.Register<ILogger, FileLogger>("File");

container.Register<IJob, DbBackup>();

// the container will call DbBackup's Initialize method.
IJob job = container.Resolve<IJob>();
```

--------------------------------

### Register Transient Service with Shortcut

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/basics.md

Use this shortcut to register a service with the default transient lifetime. The service will be instantiated every time it is resolved.

```csharp
container.Register<IJob, DbBackup>();
IJob job = container.Resolve<IJob>();
```

--------------------------------

### Wire Up Instance with Generic API

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/basics.md

Register an instance and allow Stashbox to perform property/field injection upon resolution. This is similar to instance registration but enables dependency injection.

```cs
container.WireUp<IJob>(new DbBackup());
IJob job = container.Resolve<IJob>();
```

--------------------------------

### Named Service Registration and Resolution

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/glossary.md

Demonstrates how to register a service with a specific name and then resolve it using that name. This is useful for differentiating between multiple registrations of the same service type.

```cs
container.Register<IService, Implementation>("Example");
// the named request.
var service = container.Resolve<IService>("Example");
```

--------------------------------

### Registering a service that defines its own named scope

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

This registers a service that defines its own scope, allowing other services to be registered within that defined scope. The example shows DbJobExecutor defining a scope and IJob being registered within it.

```cs
container.Register<DbJobExecutor>(options => options
    .DefinesScope());

ontainer.Register<IJob, DbBackup>(options => options
    .InScopeDefinedBy<DbJobExecutor>());

// the executor will begin a new scope within itself
// when it gets resolved and DbBackup will be selected
// and attached to that scope instead.
using var scope = container.BeginScope();
DbJobExecutor executor = scope.Resolve<DbJobExecutor>();
```

--------------------------------

### Conditional registration based on service type

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Use `HasServiceType` within a batch registration configuration to apply specific registration options based on the service type. This example applies `WithScopedLifetime` if the service type is `IService2`.

```csharp
container.RegisterAssemblyContaining<IService1>(configurator: options =>
    {
        if (options.HasServiceType<IService2>())
            options.WithScopedLifetime();
    });
```

--------------------------------

### Registering and Resolving with Child Containers

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/child-containers.md

Demonstrates how services are resolved from parent and child containers, highlighting how child registrations override parent ones for the same service type. Use this to manage distinct dependency sets within an application hierarchy.

```csharp
interface IDependency {}

class B : IDependency {}
class C : IDependency {}

class A 
{
    public A(IDependency dependency)
    { }
}

using (var container = new StashboxContainer())
{
    // register 'A' into the parent container.
    container.Register<A>();

    // register 'B' as a dependency into the parent container.
    container.Register<IDependency, B>();

    var child = container.CreateChildContainer()
    
    // register 'C' as a dependency into the child container.
    child.Register<IDependency, C>();
    
    // 'A' is resolved from the parent and gets
    // 'C' as IDependency because the resolution
    // request was initiated on the child.
    A fromChild = child.Resolve<A>();

    // 'A' gets 'B' as IDependency because the 
    // resolution request was initiated on the parent.
    A fromParent = container.Resolve<A>();
} // using will dispose the parent along with the child.
```

--------------------------------

### Register Service with Injection Parameters

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Registers a service and specifies injection parameters for its constructor or properties. Use this to provide pre-evaluated dependencies during resolution.

```cs
container.Register<IJob, DbBackup>(options => options
    .WithInjectionParameter("logger", new ConsoleLogger())
    .WithInjectionParameter("eventBroadcaster", new MessageBus());

// the injection parameters will be passed to DbBackup's constructor.
IJob backup = container.Resolve<IJob>();
```

--------------------------------

### Register Service with Initializer and Finalizer

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Register a service and specify delegates to be called after instantiation (initializer) and before disposal (finalizer).

```csharp
container.Register<ILogger, FileLogger>(options => options
    // delegate that called right after instantiation.
    .WithInitializer((logger, resolver) => logger.OpenFile())
    // delegate that called right before the instance's disposal.
    .WithFinalizer(logger => logger.CloseFile()));
```

--------------------------------

### Registering a service in a named scope defined by another service

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

This registers a service to be used within a named scope that is defined by another service. The example shows DbJobExecutor defining a scope named 'DbScope' and IJob being registered within that same named scope.

```cs
container.Register<DbJobExecutor>(options => options
    .DefinesScope("DbScope"));

ontainer.Register<IJob, DbBackup>(options => options
    .InNamedScope("DbScope"));

// the executor will begin a new scope within itself
// when it gets resolved and DbBackup will be selected
// and attached to that scope instead.
using var scope = container.BeginScope();
DbJobExecutor executor = scope.Resolve<DbJobExecutor>();
```

--------------------------------

### Compose All Composition Roots in an Assembly

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Automatically finds and executes all available `ICompositionRoot` implementations within a specified assembly. This is useful for discovering and wiring up multiple entry points.

```cs
// compose every root in the given assembly.
container.ComposeAssembly(typeof(IServiceA).Assembly);
```

--------------------------------

### Resolve Unknown Types Without Registration Configuration

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/special-resolution-cases.md

When unknown type resolution is enabled without a specific registration configuration, the container can resolve non-interface and non-abstract unknown types by creating implicit registrations. This example shows implicit registration for 'Dependency' and its injection into 'Service'.

```cs
class Dependency { }

class Service 
{
    public Service(Dependency dependency)
    { }
    
}

var container = new StashboxContainer(config => config
    .WithUnknownTypeResolution());

container.Register<Service>();

var service = container.Resolve<Service>();
```

--------------------------------

### Resolving Services from Named Scopes

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Demonstrates how to resolve services registered within named scopes. It shows creating parent and sub-scopes, including named sub-scopes, and resolving services accordingly. Also covers resolving from unnamed scopes and the expected outcomes.

```cs
using (var dbScope = container.BeginScope("DbScope"))
{
    // DbBackup and DbCleanup will be returned.
    IEnumerable<IJob> jobs = dbScope.ResolveAll<IJob>();

    // create a sub-scope of dbScope.
    using var sub = dbScope.BeginScope();

    // DbBackup and DbCleanup will be returned from the named parent scope.
    IEnumerable<IJob> jobs = sub.ResolveAll<IJob>();

    // create a named sub-scope.
    using var namedSub = dbScope.BeginScope("DbSubScope");
    // DbIndexRebuild will be returned from the named sub-scope.
    IEnumerable<IJob> jobs = namedSub.ResolveAll<IJob>();
}

using (var storageScope = container.BeginScope("StorageScope"))
{
    // StorageCleanup will be returned.
    IJob job = storageScope.Resolve<IJob>();
}

// create a common scope without a name.
using (var unNamed = container.BeginScope())
{
    // empty result as there's no service registered without named scope.
    IEnumerable<IJob> jobs = unNamed.ResolveAll<IJob>();

    // throws an exception because there's no unnamed service registered.
    IJob job = unNamed.Resolve<IJob>();
}
```

--------------------------------

### Factory Instantiation with Constructor Selection

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

When a service has multiple constructors, the container selects the one with matching parameters passed to the factory, respecting constructor selection rules.

```cs
class Service
{
    public Service(int number) { }
    public Service(string text) { }
}

container.Register<Service>();

// create the factory with an int input parameter.
var func = constainer.Resolve<Func<int, Service>>();

// the constructor with the int param 
// is used for instantiation.
var service = func(2);
```

--------------------------------

### Registering Open-Generic Decorators

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

Demonstrates how to register an open-generic decorator to extend open-generic services. This allows for conditional logic or additional processing before or after the decorated service's execution.

```csharp
interface IEventProcessor<TEvent>
{
    void ProcessEvent(TEvent @event);
}

class GeneralEventProcessor<TEvent> : IEventProcessor<TEvent>
{
    public void ProcessEvent(TEvent @event) { /* suppose this method is processing the given event.*/ }
}

class ValidatorProcessor<TEvent> : IEventProcessor<TEvent>
{
    private readonly IEventProcessor<TEvent> nextProcessor;

    public ValidatorProcessor(IEventProcessor<TEvent> eventProcessor)
    {
        this.nextProcessor = eventProcessor;
    }

    public void ProcessEvent(TEvent @event)
    {
        // validate the event first.
        if (!this.IsValid(@event))
            throw new InvalidEventException();

        // if everything is ok, call the next processor.
        this.nextProcessor.ProcessEvent(@event);
    }
}

using var container = new StashboxContainer();
container.Register(typeof(IEventProcessor<>), typeof(GeneralEventProcessor<>));
container.RegisterDecorator(typeof(IEventProcessor<>), typeof(ValidatorProcessor<>));

// new ValidatorProcessor<UpdateEvent>(new GeneralEventProcessor<UpdateEvent>())
var eventProcessor = container.Resolve<IEventProcessor<UpdateEvent>>();

// process the event.
eventProcessor.ProcessEvent(new UpdateEvent());
```

--------------------------------

### Re-building Singletons in Child Containers

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/child-containers.md

Shows how to enable singleton re-instantiation in child containers using container options. This allows re-built singletons to utilize overridden dependencies specific to the child container.

```csharp
interface IDependency {}

class B : IDependency {}
class C : IDependency {}

class A 
{
    public A(IDependency dependency)
    { }
}

using (var container = new StashboxContainer(options => options.WithReBuildSingletonsInChildContainer()))
{
    // register 'A' as a singleton into the parent container.
    container.RegisterSingleton<A>();

    // register 'B' as a dependency into the parent container.
    container.Register<IDependency, B>();

    // 'A' gets 'B' as IDependency and will be stored
    // in the parent container as a singleton.
    A fromParent = container.Resolve<A>();

    var child = container.CreateChildContainer();
    
    // register 'C' as a dependency into the child container.
    child.Register<IDependency, C>();

    // a new 'A' singleton will be created in
    // the child container with 'C' as IDependency.
    A fromChild = child.Resolve<A>();
} // using will dispose the parent along with the child.
```

--------------------------------

### Resolve Service with Identifier using KeyValuePair and ReadOnlyKeyValue

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/wrappers-resolvers.md

Demonstrates registering services with unique identifiers (names) and resolving them using KeyValuePair<object, TService> or ReadOnlyKeyValue<object, TService>. Use KeyValuePair to avoid direct Stashbox referencing.

```cs
container.Register<IService, Service1>("FirstServiceId");
container.Register<IService, Service2>("SecondServiceId");
container.Register<IService, Service3>();

var serviceKeyValue1 = container
    .Resolve<KeyValuePair<object, IService>>("FirstServiceId");
// prints: "FirstServiceId"
Console.WriteLine(serviceKeyValue1.Key);

var serviceKeyValue2 = container
    .Resolve<ReadOnlyKeyValue<object, IService>>("SecondServiceId");
// prints: "SecondServiceId"
Console.WriteLine(serviceKeyValue2.Key);
```

--------------------------------

### Factory Registration with Dependency Resolver (1 Parameter)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Register a service using a factory delegate that accepts the IDependencyResolver as a parameter to resolve other dependencies.

```csharp
container.Register<IUserRepository, UserRepository>(options => options
    .WithFactory<ILogger, IDependencyResolver>((logger, resolver) => 
        new UserRepository(logger, resolver.Resolve<IDbConnection>())));

```

--------------------------------

### Wire Up Instance with Runtime Type API

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/basics.md

Register an instance using its runtime type and enable dependency injection. Stashbox will perform property/field injection on the instance during resolution.

```cs
container.WireUp(new DbBackup(), typeof(IJob));
object job = container.Resolve(typeof(IJob));
```

--------------------------------

### Register Self-Implementation

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/glossary.md

Register a service where the service and implementation types are the same. This is a shorthand for container.Register<Implementation, Implementation>().

```csharp
container.Register<Implementation>();
```

--------------------------------

### Define and Compose a Single Composition Root

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Defines a custom composition root implementation and registers it with the container. Use this to explicitly wire up dependencies for a specific component or entry point.

```cs
class ExampleRoot : ICompositionRoot
{
    public ExampleRoot(IDependency rootDependency)
    {
    }

    public void Compose(IStashboxContainer container)
    {
       container.Register<IServiceA, ServiceA>();
       container.Register<IServiceB, ServiceB>();
    }
}
```

```cs
// compose a single root.
container.ComposeBy<ExampleRoot>();
```

--------------------------------

### Creating and Retrieving Child Containers by Identifier

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/child-containers.md

Shows how to create a child container with a specific identifier and later retrieve it using the parent container. This is useful for managing and accessing specific child container instances by name.

```csharp
using var container = new StashboxContainer();
container.CreateChildContainer("child");
// ...

var child = container.GetChildContainer("child");
```

--------------------------------

### Implementing Composite Pattern with Decorators

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

Shows how to use decorators to implement the Composite pattern, enabling multiple instances of a service to be treated as a single unit. This is achieved by registering a decorator that depends on a collection of the same service.

```csharp
public class CompositeValidator<TEvent> : IEventValidator<TEvent>
{
    private readonly IEnumerable<IEventValidator<TEvent>> validators;

    public CompositeValidator(IEnumerable<IEventValidator<TEvent>> validators)
    {
        this.validators = validators;
    }

    public bool IsValid(TEvent @event)
    {
        return this.validators.All(validator => validator.IsValid(@event));
    }
}

container.Register(typeof(IEventValidator<>), typeof(EventValidator<>));
container.Register(typeof(IEventValidator<>), typeof(AnotherEventValidator<>));
container.RegisterDecorator(typeof(IEventValidator<>), typeof(CompositeValidator<>));
```

--------------------------------

### Resolve All Services with Identifiers using KeyValuePair Array

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/wrappers-resolvers.md

Illustrates how to resolve all registered services of a given type along with their identifiers by requesting an array of KeyValuePair<object, TService>. Services without an identifier will have a null key.

```cs
// ["FirstServiceId": Service1, "SecondServiceId": Service2, null: Service3 ]
var servicesWithKeys = container.Resolve<KeyValuePair<object, IService>[]>();
```

--------------------------------

### Implementing a custom lifetime using FactoryLifetimeDescriptor

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

This demonstrates how to create a custom lifetime by inheriting from FactoryLifetimeDescriptor. The ApplyLifetime method is overridden to manage lifetime based on a pre-compiled factory delegate for service creation.

```cs
class CustomLifetime : FactoryLifetimeDescriptor
{
    protected override Expression ApplyLifetime(
        Func<IResolutionScope, object> factory, // The factory used for service creation
        ServiceRegistration serviceRegistration, 
        ResolutionContext resolutionContext, 
        Type requestedType)
    {
        // Lifetime managing functionality
    }
}
```

--------------------------------

### Select Constructor by Arguments

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Use WithConstructorByArguments to select a constructor and provide specific argument instances to invoke it. This allows for direct control over constructor invocation during resolution.

```csharp
container.Register<IUserRepository, UserRepository>(options => options
    .WithConstructorByArguments(new ConsoleLogger()));
```

--------------------------------

### Filter Services by Metadata using ValueTuple

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/wrappers-resolvers.md

Shows how to register multiple services with different metadata and then filter them by requesting an array of ValueTuple<IService, TMetadata>. This allows for selective resolution based on metadata type.

```cs
container.Register<IService, Service1>(options => options
    .WithMetadata("meta-1"));
container.Register<IService, Service2>(options => options
    .WithMetadata("meta-2"));
container.Register<IService, Service3>(options => options
    .WithMetadata(5));

// the result is: [Service1, Service2]
var servicesWithStringMetadata = container.Resolve<ValueTuple<IService, string>[]>();

// the result is: [Service3]
var servicesWithIntMetadata = container.Resolve<ValueTuple<IService, int>[]>();
```

--------------------------------

### Add Instance to Scope

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Add an already instantiated service to a scope. The instance's lifetime will be tracked by the given scope.

```cs
using var scope = container.BeginScope();
scope.PutInstanceInScope<IJob>(new DbBackup());
```

--------------------------------

### Registering a Singleton Decorator

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

Demonstrates how to register a decorator with a Singleton lifetime, which overrides the decorated service's lifetime. The decorator's lifetime is applied to the wrapped service.

```cs
container.Register<IEventProcessor, GeneralEventProcessor>();
// singleton decorator will change the transient 
// decorated service's lifetime to singleton.
container.RegisterDecorator<IEventProcessor, ValidatorProcessor>(options => 
    options.WithLifetime(Lifetimes.Singleton));
// Singleton[new ValidatorProcessor()](Transien[new GeneralEventProcessor()]) 
var processor = container.Resolve<IEventProcessor>(); 

```

--------------------------------

### Creating Nested Child Containers

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/child-containers.md

Demonstrates the creation of a hierarchical tree of containers by chaining the `.CreateChildContainer()` method. This allows for complex nested dependency injection structures.

```csharp
using var container = new StashboxContainer();

var child1 = container.CreateChildContainer();
var child2 = child1.CreateChildContainer();
```

--------------------------------

### Service Interfaces and Implementations

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/introduction.md

Defines interfaces for logging, event broadcasting, and job execution, along with their concrete implementations. This showcases dependency on interfaces for better decoupling.

```csharp
public interface IJob { void DoTheJob(); }

public interface ILogger { void Log(string message); }

public interface IEventBroadcaster { void Broadcast(IEvent @event); }


public class ConsoleLogger : ILogger
{
    public void Log(string message) => Console.WriteLine(message);
}

public class MessageBus : IEventBroadcaster
{
    private readonly ILogger logger;

    public MessageBus(ILogger logger)
    {
        this.logger = logger;
    }

    void Broadcast(IEvent @event) 
    {
        this.logger.Log($"Sending event to bus: {@event.Name}");
        // Do the actual event broadcast.
    }
}

public class DbBackup : IJob
{
    private readonly ILogger logger;
    private readonly IEventBroadcaster eventBroadcaster;

    public DbBackup(ILogger logger, IEventBroadcaster eventBroadcaster)
    {
        this.logger = logger;
        this.eventBroadcaster = eventBroadcaster;
    }

    public void DoTheJob() 
    {
        this.logger.Log("Backing up!");
        // Do the actual backup.
        this.eventBroadcaster.Broadcast(new DbBackupCompleted());
    } 
}
```

--------------------------------

### Registering a service with metadata

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Attach custom metadata to a service registration using the `WithMetadata` option. The metadata can be accessed upon resolution of the service.

```csharp
container.Register<IJob, DbBackup>(options => options
    .WithMetadata(connectionString));

var jobWithConnectionString = container.Resolve<ValueTuple<IJob, string>>();
Console.WriteLine(jobWithConnectionString.Item2); // prints the connection string.
```

--------------------------------

### Set Multiple Injection Parameters

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Configure multiple injection parameters for a service registration using a collection of key-value pairs.

```csharp
container.Register<IUserRepository, UserRepository>(options => options
    .WithInjectionParameters(new KeyValuePair<string, object>("logger", new ConsoleLogger()));

```

--------------------------------

### Batch Register Instances

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/basics.md

Register multiple instances for the same service type in a single operation. All registered instances can be resolved using `ResolveAll`.

```cs
container.RegisterInstances<IJob>(new DbBackup(), new StorageCleanup());
IEnumerable<IJob> jobs = container.ResolveAll<IJob>();
```

--------------------------------

### Registering a Decorator with Wrappers

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

Shows how to register a decorator that also utilizes wrappers. This allows for additional functionality to be applied to the decorated service, such as creating a Func<T>.

```cs
container.Register<IEventProcessor, GeneralEventProcessor>();
container.RegisterDecorator<IEventProcessor, ValidatorProcessor>();
// () => new ValidatorProcessor(new GeneralEventProcessor())
var processor = container.Resolve<Func<IEventProcessor>>();

```

--------------------------------

### Add Stashbox via PackageReference

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/getting-started/introduction.md

Include this XML snippet in your .csproj file's package references to add Stashbox.

```xml
<PackageReference Include="Stashbox" Version="5.20.0" />
```

--------------------------------

### Register Instance Without Disposal Tracking

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/basics.md

Register an external instance without Stashbox tracking its disposal. Use the `withoutDisposalTracking` parameter for this.

```cs
var job = new DbBackup();
container.RegisterInstance<IJob>(job, withoutDisposalTracking: true);

// resolvedJob and job are the same.
IJob resolvedJob = container.Resolve<IJob>();
```

--------------------------------

### Nested Scopes and Instance Isolation

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/scopes.md

Illustrates the creation of nested scopes and how service instances are isolated between parent and child scopes. Instances resolved in a sub-scope are distinct from those in the parent scope.

```cs
container.RegisterScoped<IJob, DbBackup>();

using (var parent = container.BeginScope())
{
    IJob job = parent.Resolve<IJob>();
    IJob jobAgain = parent.Resolve<IJob>();
    // job and jobAgain are created in the 
    // same scope, so they are the same instance.

    // create a sub-scope.
    using var sub = parent.BeginScope();

    IJob subJob = sub.Resolve<IJob>();
    // subJob is a new instance created in the sub-scope, 
    // differs from either job and jobAgain.
}
```

--------------------------------

### Select Constructor by Argument Types

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Use WithConstructorByArgumentTypes to specify which constructor to use based on the types of its arguments. This is helpful when a service has multiple constructors with different parameter types.

```csharp
container.Register<IUserRepository, UserRepository>(options => options
    .WithConstructorByArgumentTypes(typeof(ILogger)));
```

--------------------------------

### Bind Implementation to All Implemented Types

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Register a DbBackup class to be resolvable by all interfaces it implements (IJob, IScheduledJob) as well as its own type.

```cs
container.Register<DbBackup>(options => options
    .AsImplementedTypes());

IJob job = container.Resolve<IJob>(); // DbBackup
IScheduledJob job = container.Resolve<IScheduledJob>(); // DbBackup
DbBackup job = container.Resolve<DbBackup>(); // DbBackup
```

--------------------------------

### Set Constructor Selection Rule to Prefer Most Parameters

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/container-configuration.md

Configure the container to prefer the constructor with the most parameters when resolving dependencies. This is the default behavior.

```cs
new StashboxContainer(options => options
    .WithConstructorSelectionRule(
        Rules.ConstructorSelection.PreferMostParameters));
```

--------------------------------

### Register Parameter-less Factory Delegate

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Bind a parameter-less factory delegate to a registration. The container invokes this delegate to instantiate the service.

```cs
container.Register<ILogger, ConsoleLogger>(options => options
    .WithFactory(() => new ConsoleLogger()));

// the container uses the factory for instantiation.
IJob job = container.Resolve<ILogger>();
```

--------------------------------

### Custom Constructor Selection Logic

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Provide custom logic to the WithConstructorSelectionRule to define your own constructor ordering strategy. This allows for highly specific constructor selection based on application needs.

```csharp
options.WithConstructorSelectionRule(
    constructors => { /* custom constructor sorting logic */ })
```

--------------------------------

### Register Factory with External Dependency

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Delegate factories are useful when service instantiation depends on runtime values like connection strings, which are not available at resolution time.

```cs
container.Register<IJob, DbBackup>(options => options
    .WithFactory<ILogger>(logger => 
        new DbBackup(Configuration["DbConnectionString"], logger)));
```

--------------------------------

### Registering a service with a custom finalizer

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/configuration/registration-configuration.md

Set a custom cleanup delegate for a service registration using `WithFinalizer`. This delegate will be invoked when the scope or container holding the instance is disposed.

```csharp
container.Register<ILogger, FileLogger>(options => options
    .WithFinalizer(logger => logger
        .CloseFile()));
```

--------------------------------

### Controlling Service Resolution with ResolutionBehavior

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/child-containers.md

Demonstrates how to use ResolutionBehavior to specify which containers (current, parent, or both) can participate in service resolution. Useful for fine-grained control over dependency injection scope.

```csharp
interface IService {}

class A : IService {}
class B : IService {}

using (var container = new StashboxContainer())
{
    // register 'A' into the parent container.
    container.Register<IService, A>();

    var child = container.CreateChildContainer()
    
    // register 'B' into the child container.
    child.Register<IService, B>();
    
    // 'A' is resolved because only parent
    // can participate in the resolution request.
    IService withParent = child.Resolve<IService>(ResolutionBehavior.Parent);

    // Only 'B' is in the collection because
    // only the caller container can take part
    // in the resolution request.
    IEnumerable<IService> allWithCurrent = child.Resolve<IEnumerable<IService>>(ResolutionBehavior.Current);
    
    // Both 'A' and 'B' is in the collection
    // because both the parent and the caller container
    // participates in the resolution request.
    IEnumerable<IService> all = child.Resolve<IEnumerable<IService>>(ResolutionBehavior.Current | ResolutionBehavior.Parent);
} // using will dispose the parent along with the child.
```

--------------------------------

### Decorating Multiple Services with One Decorator Class

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/advanced/decorators.md

Illustrates how a single decorator class can be used to add functionality to multiple interfaces. This is useful for applying common logic, like validation, before operations on different but related services.

```csharp
public class EventValidator<TEvent> : IEventProcessor<T>, IEventPublisher<TEvent>
{
    private readonly IEventProcessor<TEvent> processor;
    private readonly IEventPublisher<TEvent> publisher;
    private readonly IEventValidator<TEvent> validator;

    public CompositeValidator(IEventProcessor<TEvent> processor, 
        IEventPublisher<TEvent> publisher, 
        IEventValidator<TEvent> validator)
    {
        this.processor = processor;
        this.publisher = publisher;
        this.validator = validator;
    }

    public void ProcessEvent(TEvent @event)
    {
        // validate the event first.
        if (!this.validator.IsValid(@event))
            throw new InvalidEventException();

        // if everything is ok, call the processor.
        this.processor.ProcessEvent(@event);
    }

    public void PublishEvent(TEvent @event)
    {
        // validate the event first.
        if (!this.validator.IsValid(@event))
            throw new InvalidEventException();

        // if everything is ok, call the publisher.
        this.publisher.PublishEvent(@event);
    }
}

container.Register(typeof(IEventProcessor<>), typeof(EventProcessor<>));
container.Register(typeof(IEventPublisher<>), typeof(EventPublisher<>));
container.Register(typeof(IEventValidator<>), typeof(EventValidator<>));

// without specifying the interface type, the container binds this registration to all of its implemented types
container.RegisterDecorator(typeof(EventValidator<>));
```

--------------------------------

### Register Service with Scoped Lifetime (Shorter Form)

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/lifetimes.md

Registers a service with the Scoped lifetime using the RegisterScoped shortcut. A new instance is created per scope.

```cs
container.RegisterScoped<IJob, DbBackup>();

using var scope = container.BeginScope();
IJob job = scope.Resolve<IJob>();
```

--------------------------------

### Resolve Multiple Jobs and Loggers

Source: https://github.com/z4kn4fein/stashbox/blob/master/docs/docs/guides/advanced-registration.md

Demonstrates resolving all instances of a specific interface (IJob) and attempting to resolve a logger. Note that some resolutions might result in errors if the dependency is not registered.

```csharp
IEnumerable<IJob> jobs = container.ResolveAll<IJob>(); // 2 items
ILogger logger = container.Resolve<ILogger>(); // error, not found
IJob job = container.Resolve<IJob>(); // StorageCleanup
DbBackup backup = container.Resolve<DbBackup>(); // error, not found
```
Tokens:
Raw