Composition Root and DI Containers

Before, read my other post explaining why this subject is so important.

The idea around the Composition Root pattern is to create an assembly exclusively to register all the dependencies, the architecture will look like this:

Some references were omitted for didactic purposes

The CompositionRoot.dll references all the other projects, except the View (see the red arrow). Note that the View.dll (which is the startup point of our system) is the only one who references the CompositionRoot.dll.

To register the dependencies, the View.dll should call a method form the the CompositionRoot.dll. When the View.dll need to resolve a dependency, it calls the CompositionRoot.dll again.

The CompositionRoot.dll is the only one responsible of register and resolve dependencies. So, here are the examples:

Then, the clients of this CompositionRoot will need to call the RegisterDependencies() method.

Note the line 12: To register the dependencies of the View.dll I provided some public convenient methods in the CompositionRoot class to do so. In that way, the container is created and managed by the Composition Root only. The View.dll does not even need to reference the DI Container Library. If you curious, the register method of the Composition Root is really simple:

You can add more “convenience” methods if you want, I developed some in my testing project.


  • Dependencies are managed in just only one place.
  • The dependency graph becomes simpler and flatter.
  • Avoid the use of the Service Locator anti-pattern because none of the projects, except the View.dll, can ask the CompositionRoot.dll to resolve a dependency (otherwise it will cause a circular dependency).


  • To integrate with Asp.Net the CompositionRoot.dll needs to reference some infrastructure dlls to be able to offer methods that provide that integration. See the public static void ConfigureServices(IServiceCollection services)  method in here

This is not even a so negative point because you can still do this integration in the ASP.NET project (View.dll), however, for the sake of separation of responsibilities, I prefer to do this in CompositionRoot.dll

Texto normal texto texto n

Check my Github for a complete project that shows the technique explained above.