Contents


MVO Architecture

This little library helps you implement an architecture we call MVO (Model View Observer). (If you know your MV*s then you’ll notice MVO has some similarity with both MVI and MVVM).

mvo anotated

That block diagram above is what MVO looks like (it’s simplified of course, further details below).

By Model we mean the standard definition of a software model, there are no particular restrictions we will put on this model other than it needs to be somehow observable (when it changes, it needs to tell everyone observing it that it’s changed) and it needs to expose its state via quick returning getter methods. The model can have application level scope, or it can be a View-Model - it makes no difference from an MVO perspective. (But mostly with MVO we are talking about application level things like AccountModel, MessageInbox, TodoList, Favourites etc).

By Observer we mean the standard definition of the Observable pattern. In MVO, the Views observe the Models for any changes. (This has nothing specifically to do with rxJava by the way, though you could implement an MVO architecture using rxJava if you wanted to).

By View we mean the thinest possible UI layer that holds buttons, text fields, list adapters etc and whose main job is to observe one or more observable models and sync its UI with whatever state the models hold. If you’re going to implement MVO on android you might choose to use an Activity or Fragment class for this purpose. Most of the examples here however use custom view classes which ultimately extend from android.view.View.

We mentioned State. The fore philosophy is to take state away from the UI layer, leaving the UI layer as thin as possible. fore puts state in the models where it can be comprehensively unit tested. For example, if you want to display a game’s score, the place to manage that state is in a GameModel. The view is just synced, whenever the (Observable) GameModel changes:


public void syncView() {
  pointsView.text = gameModel.getScore();
}


fun syncView() {
  pointsView.text = gameModel.score
}

Notice the syncView() method does not take a parameter. It gets all it needs from the models that the view is observing. The use of an immutable view-state here is a key driver of complexity in architectures like MvRx and MVI - supporting the android lifecycle during rotations becomes very complex for instance. Dispensing entirely with this style of view-state binding is one of the reasons that fore is so tiny and the library so easy to understand - by all means make full use of immutable state within the models though.

For the avoidance of doubt, most non-trivial apps will of course have more layers beneath the model layer, typically you’ll have some kind of repository, a networking abstraction, usecases etc. There are two slightly larger, more commercial style app examples to check out: one in Kotlin and another in Java (which has a tutorial to go along with it).

In a nutshell this is what we have with MVO:

“Observable Models; Views doing the observing; and some Reactive UI tricks to tie it all together”

Another way to look at it is in crap diagram mode. So here’s a crap diagram showing the flow of a button click from step 1 to 3 with a single observable model and a view that observes it:

data binding

Importantly, during the syncView() stage, the view syncs all the view states, it’s a fundamental part of why fore code is so robust, but at the same time looks so sparse.

That diagram matches what is happening in sample app 1. Here are the relevant bits of code: the observable model code and the view code that does the observing.

One great thing about MVO is that the view layer and the rest of the app are so loosely coupled, that supporting rotation already works out of the box. In the code examples above, the code just works if you rotate the screen simply because of how it’s structured - you don’t need to do a single thing.

“the code works if you rotate the screen - without you needing to do a single thing”

The code looks extremely simple and it is, but surprisingly the technique works the same if you’re using adapters [screen shot], or if you’re doing asynchronous work in your model, or fetching data from a network. It even works when you have a heavily animated view like we do in sample app 5.

Handling State

In MVO, the state is kept inside in the models, typically accessible via getter methods. You’ll notice that’s not particularly functional in style, but it’s one of the reasons that MVO has such shockingly low boiler plate compared with other data-binding techniques. And this shouldn’t worry you by the way (dependency injection is not a functional pattern either - as developers we simply always look for the best tool for the job). Whatever drives the state of your models and the rest of your app can be as functional as you want of course. (This means that you can have a Redux style reducer and immutable state for your models internally - as long as that state is accessed by the UI layer using getters, you’ll still be able to take full advantage of MVO architecture).

There is further discussion of state versus events here

From MV* to MVO

MVO is like a radically reduced version of MVVM, with the addition of a render() style function similar to the one you will find in MVI.

Discussions of MVC, MVP, MVVM and MVI can get quite abstract, and specific implementations often differ considerably. (If you want to continue learning about MVO, you might want to head over to the discussion on Views at this point).

Anyway for the purposes of our MV* discussion, the following flow diagrams will do:

simple basket

This is quite a common representation of MVC, however I don’t think it’s a particularly useful diagram - it depends entirely on the specifics of your controller which often isn’t mentioned at all. If you are considering your Android Activity class to be the controller, then implementing something like this on Android can get a little messy. (In the 8 years or so I’ve been a contract Android developer, I’ve learnt the hard way that it’s usually best to remove as much code from activity/fragment classes as possible). If you are considering your controllers to be your click listeners then it’s basically a nothing diagram that shows a View interacting with a Model. (See below for a discussion of Controllers).

There is one important thing to note about about this diagram however. If we focus on the Model, all the arrows (dependencies) point towards the Model. This tells us that while the View and Controller know about each other and the Model, the Model knows nothing about the View or the Controller. That’s exactly the way we want it. This way a Model can be tested independently, and needs to know nothing about the view layer. It can support any number of different Views which can come and go as they please (when an Android device is rotated for example, the Model is not affected - or even aware of it).

(It’s worth mentioning that many early Android apps had no discernible domain model at all, some still don’t, essentially writing the entire app in the UI layer - so if you can’t find it in the app you are working on, it might not exist).

Anyway I did say that I thought the typical MVC diagram is not particularly useful, I think it’s main purpose is just to be shown before the MVP diagram is - so that we can see a particular difference. So here is a typical MVP diagram:

simple basket

It’s basically the same thing except here the View doesn’t know about the Model. All interactions with the Model go via a Presenter class. The Presenter class usually does two main things: it sets UI states on the View (so it needs to know about the View) and it forwards commands from click listeners and the like, to the underlying Model / Models (so it needs to know about those Models too).

In a typical MVP Android app, quite a bit of boiler plate is required to let the Presenter do its job, typical implementations also create the Presenter from scratch each time the view is constructed, and that can make handling rotations difficult.

Note that as with MVC, the Model is not aware of the higher level View related classes - which is a good thing. Moving code from the View to a Presenter class also means that we can now unit test it, which is great. (The Presenter is aware of the View but this is usually via an injected interface, so for a unit test you don’t need to set up an actual View, just its interface)

The main issue with both of these approaches on Android though, is the arrow pointing to the View

simple basket

Android has a particular problem with this as the Views are destroyed and created even due to a simple screen rotation and each time that happens, all the references need to be recreated.

Here’s the MVVM equivalent diagram:

simple basket

Again there are different ways of doing MVVM, even on Android, but the main difference here is that the View-Model is not aware of the View like the Presenter is. All the arrows go from the edge of the system where the UI is, towards the centre where things like business logic reside, down in the model layer.

In MVVM you typically have a View-Model for each View, so even though there are no dependencies on the View from the View-Model (no arrow pointing from View-Model to View), it’s still a specific implementation for that View, you usually can’t use one View-Model for different Views. A slightly more realistic situation for a whole app with different views looks like this:

simple basket

You can implement this using something like LiveData on Android, but the lack of a syncView convention (or render() in MVI), results in increasingly complex view code once you start tackling non trivial UIs - it’s a considerable step forward none the less, and it may work for you. Importantly, all the arrows are pointing the right way! (which, no surprise, happens to match the direction of the arrows in clean architecture)

Finally MVO

As we mentioned, here is what MVO looks like in a real app:

simple basket

Well how does that work? you can’t just remove boxes and call it better! (I hear you say).

“Observable Models; Views doing the observing; and some Reactive UI tricks to tie it all together”

As with all the architectures discussed so far, here the Model knows nothing about the View. In MVO, when the view is destroyed and recreated, the view re-attaches itself to the model using the observer pattern. Any click listeners or method calls as a result of user interaction are sent directly to the relevant model (no benefit here in sending them via a Presenter). With this architecture you remove a lot of problems around lifecycle management and handling rotations, it also turns out that the code to implement this is a lot less verbose (and it’s also very testable and scalable).

There are a few important things in MVO that allow you an architecture this simple:

If you totally grok those 4 things, that’s pretty much all you need to use MVO successfully, the code review guide should also come in handy as you get up to speed, or you bring your team up to speed.

Comparison with MVI

The two architectures are very similar in that they both have a single method that updates the UI according to state.

MVO has syncView() which takes no parameters. The method sets the UI according to whatever models it has, eg:


loggedInStatus.setText(accountModel.isLoggedIn() ? "IN" : "OUT")
 

loggedInStatus.text = if (accountModel.isLoggedIn) "IN" else "OUT"
 

MVI has render() which takes a ViewState parameter containing all the required state for the UI, eg:


loggedInStatus.setText(viewState.isLoggedIn ? "IN" : "OUT")
 

loggedInStatus.text = if (viewState.isLoggedIn) "IN" else "OUT"
 

Most testing takes place just below the UI layer for both architectures:

testing with MVI and MO

In MVI a typical test would be to make sure that an Intention/Intent made by a user results in the correct ViewState being returned to the UI layer. For example, test that the LOGIN_INTENTION is processed correctly (i.e. gets converted to a LOGIN_ACTION, is processed via an interactor to create a LOGIN_RESULT, which is then reduced and combined with previous view states to produce a ViewState object (including a field like ViewState.isLoggedIn = true), for passing back to the UI). The reason for the complication with MVI is that the whole thing is functionally written so that the resulting ViewState returned via the render() method is immutable. Luckily the tests don’t need to know much about this and mostly just compare the INTENTION with an expected STATE.

MVO simply tests that when you call accountModel.login(): a) if you are observing that model and it changes, you receive a notification, and b) the accountModel.isLoggedIn() method subsequently returns the expected value.

Both architectures mock out dependencies and have strategies for dealing with asynchronous code which makes the tests small.

There is a thin part of the app that can only be tested with the help of android itself (and is therefore sometimes skipped). For MVI: testing that when you click on the login button it actually emits a LOGIN_INTENTION for processing. For MVO: testing that when you click on the login button, it actually calls accountModel.login().

On the return trip to the UI: For MVI: testing that when render() is called with the appropriate ViewState, the login text does actually read “Logged in”. For MVO: testing that when syncView() is called with an appropriately mocked accountModel object, the login text does actually read “Logged in”.

Both architectures support rotation on Android although it’s not quite so trivial in MVI, mostly due to its functional/immutable nature.

It goes without saying that the amount of code that needs to be written to implement MVI is considerably more than with MVO (this is the price you pay for writing UI data-binding code in a functional style). The difference becomes more significant with views that depend on a number of different data sources, each of which may need reacting to (such as an AccountModel, EmailInbox and NetworkStatus). Most of this additional code will be written in the Interactor class, so at least it remains testable - but sheer amount of code can become a significant break on development speed and robustness for many teams, especially when code needs to be changed.

BTW, What’s a Controller

It helps to remember that MVC is at least 3 decades old, I think it was Microsoft who invented it [I saw a Microsoft white paper written about it once, but I can’t find it anywhere now]. A controller means different things on different platforms.

Originally a controller might have been a class that accepts mouse clicks at specific pixel co-ordinate, did some collision detection to find out which UI component was clicked, then sent that information on to the appropriate UI classes for further processing. (A controller in a web app however, might be a main entry point URL that forwards on requests to different parts of the system.)

In modern app frameworks most of the controller work is implemented for you by the UI framework itself - these are the button click listeners that simply catch user input and send it on to the right place. As we need to worry less about controllers now a days, we talk more about more “modern” things like MVVM - which is only about 10(!) years old.

(Android also lets you use Activities as kind of “Controllers” by letting you specify callback methods right in the XML for buttons which will end up getting called on whatever activity is hosting that particular view. The idea is to not have to write click listeners - unfortunately this encourages (forces) you to get the activity involved in something that it doesn’t need to be involved in, which usually doesn’t end well. If you leave everything out of the Activity then you can often re-use your custom view in any activity or fragment you like, without needing to re-implement all those button call backs each time.)