Child Containers

Component: NServiceBus
NuGet NServiceBus (6.x)

Child containers are essentially a snapshot of the main container where transient instances are treated as singletons within the scope of the child container. This is useful to scope instances for the duration of a web request or the handling of a message in NServiceBus. While this was possible before, child containers bring one more important feature to the table.

As of NServiceBus.Spring Version 6.0.0 Child containers are now supported as well. Previous versions don't support Child containers, if planning to take advantage of it, use one of the other containers supported by NServiceBus.

Deterministic disposal

Instance lifetime is usually not tracked by the container (Windsor is an exception) and that means that manually dispose is required on any instance that needs deterministic disposal. Child containers solve this issue by automatically disposing all transient objects created within each specific child container.

This is useful to managing things like the database sessions.

NServiceBus creates a child container for each transport message that is received, remembering that transport messages can contain multiple "user defined messages". This means that all transient instances created during message processing are scoped as singletons within the child container. This supports easily sharing, for example, the NHibernate session between repositories, without messing around with thread static caching.

When the message finishes processing, the child container and all transient instances are disposed. So if deterministic disposal is required, implement IDisposable.

When the message is processed, the session is disposed and all resources such as database connections are released.

Child containers are a powerful feature that can simplify the code.

If configuring components using the NServiceBus configure API, it's possible to configure instance life-cycle to be per unit of work, using this:

endpointConfiguration.RegisterComponents(
    registration: components =>
    {
        components.ConfigureComponent<MyUnitOfWork>(DependencyLifecycle.InstancePerUnitOfWork);
    });

Last modified