Composition

Posted with : Compose

I see a lot of people get application composition very wrong, very often. The problem isn’t so much that the subject lacks resources, on contrary, dependency injection for example is probably the most talked about and blogged pattern of all time! However, the information presented is all too often incorrect or conflicting, spawned from the enlightened minds of mid level developers keen to share their light bulb moment in which DI and some of its benefits are suddenly realised.

I’ve decided to take matters a step further than the usual drivel that is DI blogs, and provide a framework. In this article I’ll address what I consider to be some of the misconceptions surrounding composition techniques and clarify some terminology. In future articles I’ll highlight how the use of Compose can assist in rectifying these common flaws, whilst simplifying the definition of manageable service components and resulting integration within your application.

Terminology

First thing’s first, lets add my take on the terminology involved in hope of sparking some dim light into those lightbulbs, and if nothing else, to clarify the rest of this article.

Inversion of Control (IoC)

Sometimes referred to as the Hollywood Principle - “Don’t call me, I’ll call you”, IoC spans back more than 25 years. Although it made appearances in papers beforehand, it was possibly made most famous in the book; Gang of Four.

I like to think of it as the broadest description of dependency flow, to which patterns that can be used to achieve the Dependency Inversion Principle all fit within. It describes how reusable, generic components are used by applications and in which direction the flow of control should occur.

For more information on IoC, I recommend checking out Martin Fowler’s article.

Dependency Inversion Principle (DIP)

DIP is a much more targetted principle when compared to IoC, concerning the decoupling of dependencies so that high-level components can be made independent of lower-level modules. It is a combination of abstracting your concrete implementations, whilst ensuring consumers remain isolated from dependencies.

It is important to note, despite Dependency Inversion sharing an acronym with Dependency Injection, the two are not the same. Dependencies can be inverted simply by using abstractions, and in no way requires dependency injection.

This is possibly made more clear in this post by Derick Bailey which tackles differentiating the two terms.

Dependency Injection (DI)

For all the confusion DI brings about at times, I consider it one of the most valuable patterns available. It takes very little time to teach a junior developer to use dependency injection, and is a pretty easy sell if said junior follows TDD (if not, why not!?).

Dependency Injection is simply a design pattern intended to assist in achieving the Dependency Inversion Principle, which in turn can assist with inverting control (IoC). That’s it, really. I quite often see people stating it’s usefulness with TDD as it’s greatest asset, and although I believe that to be a very handy side-effect, the key benefit to me is the component isolation it affords us. Not just for the sake of testing, but for the sake of a cleaner structural design.

DI is not IoC

Notice how each of the terms listed so far have been a smaller, more direct description of something designed to assist in achieving a broader goal. It should therefore come as no surprise that simply utilising the dependency injection design pattern, does not mean you have achieved IoC.

And yet, so many, seem to misunderstand…

Dependency Injection is just a tool, the subjects of DIP and IoC are much broader. Considerations such as which projects an interface and respective implementations should exist (component cohesion) are far more crucial than DI when considering DIP. We saw above, one of the key tenants of DIP was the isolation of high level consumers from it’s lower level dependencies, and that DI wasn’t even necessary to achieve this.

Don’t get me wrong, DI is great. I just think developers need to realise there is much more to learn on the subject; don’t stop at dependency injection, read on!

Next steps

Written on April 15, 2015