When Endpoint Instance Starts and Stops

Classes that plug into the startup/shutdown sequence are invoked just after the endpoint instance has been started and just before it is stopped. Use this approach for any tasks that need to execute with the same life-cycle as the endpoint instance.

Instances are:

• Located by assembly scanning and automatically registered into the configured dependency injection during endpoint creation. These are registered as Instance Per Call.
• Created and started as the last step when the endpoint is started.
• Started after the Transport and any Satellites have started. While all instances of IWantToRunWhenBusStartsAndStops are being started, no message will be processed.
• Created on the same thread that is starting the endpoint.
• Created by dependency injection which means they:
• Will have dependencies injected.
• Do not require a default constructor.

Once created Start is called on each instance in parallel. Each Start call is made on a different background thread. Instances of IWantToRunWhenBusStartsAndStops are kept internally to be stopped when the endpoint is disposed.

When the endpoint is disposed, all instances of IWantToRunWhenBusStartsAndStops are stopped by calling their Stop method. Each call to Stop happens on parallel background threads but the call to Dispose() will block until they have all completed.

Exceptions

Exceptions thrown in the constructors of instances of the start and stop interfaces are unhandled by NServiceBus. These will bubble up to the code that starts the the endpoint.

Exceptions raised from the Start method will cause a Critical Error. As they are run on separate threads, an exception on one Start call will not interfere with any others.

Exceptions raised from the Stop method will not halt shutdown and will be logged at the Fatal level.

Code

class RunWhenTheEndpointStartsAndStops :
    IWantToRunWhenBusStartsAndStops
{
    public void Start()
    {
        // perform startup logic
    }

    public void Stop()
    {
        // perform shutdown logic
    }
}