Kijana Woodard

Software Minimalism

Introducing Nimbus

Thursday, October 24, 2013

Once I started questioning IoC containers, a variety of problems presented themselves.

Near the end of questioning IoC, I posited an escape hatch:

    new Mediator(new DoThis(), new DoThat(), new DoTheOther());

Working to achieve this api, I came up with Nimbus. To see how it works, I incorporated nimbus into this blog.

Here is the controller that displays a blog post before:

public class PostGetController : Controller
    private readonly IPostVault _vault;
    private readonly IContentStorage _storage;

    public PostGetController(IPostVault vault, IContentStorage storage)
        _vault = vault;
        _storage = storage;

    public ActionResult Execute(string slug)
        var posts = _vault.ActivePosts; 
        var post = posts.FirstOrDefault();
        if (slug != null) post = _vault.AllPosts.FirstOrDefault(x => x.Slug.ToLower() == slug.ToLower());
        if (post == null) return HttpNotFound();

        var content = _storage.GetContent(post.FileName);
        var previous = posts.OrderBy(x => x.PublishedAtCst).FirstOrDefault(x => x.PublishedAtCst > post.PublishedAtCst);
        var next = posts.FirstOrDefault(x => x.PublishedAtCst < post.PublishedAtCst);

        var model = new PostGetViewModel(post, content, previous, next, _vault.ActivePosts, _vault.FuturePosts);
        return View(model);

Here is the same controller after:

public class PostGetController : Controller
    private readonly IMediator _mediator;

    public PostGetController(IMediator mediator)
        _mediator = mediator;

    public ActionResult Execute(PostRequest request)
        var model = _mediator.Send<PostRequest, PostGetViewModel>(request);
        if (model.Post == null) return HttpNotFound();
        return View(model);

I'll stipulate that the net effect is that I've simply shifted the code around. My assertion is that I have shifted it to a better place. The implementation gets to decide precisely how to fulfill the message contract and it can optimize aggressively.

Notice that the controller no longer is dependent upon IPostVault and IContentStorage. That isn't superficial. Those interfaces are gone.

I remember struggling with those interfaces. What is a Post Vault anyway? Post Repository? Post Service? Post....Locker? Blech!!! That pain was a sign that it was a superfluous interface created by my desire to "inject an interface" into the controller.

I also kept trying to balance how to leak data from the classes. Should I present the posts as one big list and let the controller figure active vs future? Should I have two lists? Three? Should they be IEnumerable or IReadOnlyCollections?

How about we make them private. Ahhhhh. Debate over. Much better. :-]

Here's the mediator configuration:

var mediator = new Mediator();

mediator.Subscribe<PostRequest, PostGetViewModel>(() => 
    new ISubscribeFor<PostRequest>[] { 
        new FilteredPostVault(), 
        new MarkdownContentStorage(root) });

This configuration becomes a Rosetta stone for understanding how the application is wired together. If we want to make a change to a particular request, we know exactly what pieces are involved. Even better, if we decide to, say, change persistence technology, we have a project plan laid before us of what pieces need to be implemented with the new technology. It's already separated into pieces to dole out to the team.

I'm passing IMediator into the controller via autofac. See, containers are ok. I also got to drop some esoteric autofac configuration for which I had links to documentation. My abstraction surface is being streamlined. Classes will depend on the messages, IMediator, or some other singleton or derivative such as IDocumentSession.

What does zero or one dependencies get us?

Easy testing for one. We might actually end up with some units to test.

We also get the flexibility we were looking for with the "endless interfaces" approach. Right now, it so happens that view model for displaying posts is created through the cooperation of two classes. If that should need to be one class or seven classes, we can make the change without modifying the controller dependency list. If we decide to keep posts in a database or convert the text to sphinx or razor, the controller doesn't notice: OCP, SRP, ISP, DIP. Can I just throw Liskov in?

The source file, at 135 LoC, is meant for copy/paste inclusion and modification. For instance, say you want to decorate each handler instance with logging/timing/etc. Salt to taste.

Coding nimbus was an interesting journey that led to other realizations. I noticed how tempting it is to add features.

What kept me in check was ISP. I thought SRP was a stronger check against sloppy design, but I kept being able to justify responsibility. Yeah, that feature is close enough. We don't need an entirely different class for just this.

It turned out the ISP kept me on the straight and narrow. After ranting about violating isp, I could hardly force clients to take dependencies they weren't going to use. That led me to write a bunch of code to cover the signature permutations. The resulting bloat drove me to cut features that weren't truly pertinent.

I really enjoyed this exercise and I'm much happier with the structure of my blog code.

But I think we can do better.

If you see a mistake in the post *or* you want to make a comment, please submit an edit.

You can also contact me and I'll post the comment.

Mike Pennington
Mike Pennington • 4 years ago

I'm somewhat conflicted about this blog post. I like what you're doing, and the code is very clean and concise. And ISP is followed such that, as you mention, units of work are separate and can be tested as actual units. Although, on the other hand, it feels a little bit like magic. The old way, although messier, was at-a-glance readable. I feel like there's a middle ground somewhere.

Been enjoying your blog. :)

Kijana Woodard
Kijana Woodard • 4 years ago

Wait till next time. :-]

Joey Guerra
Joey Guerra • 4 years ago

I want to see how this looks when you apply similar principles in JavaScript.

Kijana Woodard
Kijana Woodard • 4 years ago

Ummmm. Me too. Rob Ashton is laying it down: