Class Libraries With Microservices

Back in the olden days, everyone went nuts for Service Oriented Architecture.  Many consultant dollars were made.  Everyone temporarily forgot who Fred Brooks was (No Silver Bullet). Time moved on, the hype died down.  But just like a Jeffrey – IT COMES BACK.  Yes, I’m talking about micro-services.

Martin Fowler has a really nice piece on this topic: where he talks about the advantages of being at least familiar with the approach – especially when designing for cloud-based applications.

With that in mind, having a decentralised, distributed design was important to me as I map out the design for Argomi on the back of whatever receipts and envelopes I can get my hands on (I look forward to the day when tablets provide me the functionality of pencil and paper).  However, I have now stumbled across a question I have previously agonised over: the shared class library.

If we are splitting up a design into pieces, then it seems obvious to want to have a class library shared amongst all services with business logic encapsulated and lots of nice code-reuse. The issue comes from the implicit coupling.

One of the ‘points’ of microservices is that each service is independent of the others, and can have its own release cycle – or be completely replaced with an improved version, and the other services don’t necessarily need to even know.  This leads to articles like: which suggest not sharing anything – even class libraries – since changes may require all services to be upgraded at the same time. It also pretty much forces you to use the same technology for all services so that the class library can be shared.

My feeling right now is that avoiding a potential coupling is normally not worth the cost of reimplementing complicated business logic and that one should:

  • Strive to design fixed interfaces and classes so basic interactions with the class don’t change over time.
  • Make changes backwards compatible between versions (e.g. providing a default implementation for a new field) so that the library doesn’t have to be updated in all services exactly simultaneously, however;
  • Don’t allow multiple versions of the library to run for longer than absolutely necessary.  This is just a modern version of dll-hell, and leads to unnecessary mental load for all developers who need to remember which versions are out in the wild.
  • For the same reason, unless absolutely necessary never create two interface points to the same function, with one simply acting as a pointer to the other so that original callers don’t need to be updated to consume a new interface signature.

Does anyone have any alternative experience they would like to share?  Perhaps a shared class library that got out of control?

No discussion of microservices would be complete without linking to the fallacies of distributed computing.



I quit my job a few months ago and returned to Asia to start on the next chapter of my life: Argomi.

Argomi is a personal finance manager for people comfortable with interacting with online services for money management.  We aim to give our users advice about their investments, easy access to financial services which are otherwise perhaps a little intimidating and – over time – reducing their costs through aggregating volume.

I am the CTO, and will be writing a little about my experiences.  It has already been a very exciting transition from technical manager at a huge financial institution to a hands-on startup founder, with exposure to all sorts of business activities that were previously handled by someone else.

I will also write about the decisions that I am making and why – both technical and organisational.  Hopefully they will be of value to people going down a similar path.

In the words of the great King Theoden:

AngularFire 2.x.x

I recently struggled a little to find good documentation on AngularFire 2.x.x – basically the version post when Google bought out FireBase.  If you search for Firebase and AngularJS, or even if you go to, it all goes to the older version.

However, there is some fairly good documentation on the GitHub repo ( – but best of all, one of the examples on the repo has been migrated to the latest version:

I found this example to be fantastic, not only of AngularFire but also AngularJS in general.  If you are looking for easy to understand examples of great architecture, I think you could do a lot worse.

The architecture is modelled after this excellent style guide: