Matthieu Vergne's Homepage

Last update: 14/10/2019 21:30:41

How to Resolve the God Object Issue?


Nowadays, it is common knowledge to favor modularity, with small and simple pieces of software combined to build more complex ones. History first came with methods, which are written in some packages and reused elsewhere. With Object-Oriented Programming, we can create classes based on other classes, including classes from other libraries. More recently, this trend has also been enriched with the use of micro-services with distributed deployment. But if this is what we recommend and push for, this is because practice naturally goes differently.

We often build monolithic software, putting everything together and experimenting until it works. Even expert programers, when they lack information, experiment before to care about good designs. Modularity is often of least concern until we face the difficulties of monolithic software. At that time, we can identify objects which provide several, possibly many different and loosely-related features. We call these objects God objects: they are omnipotent creatures that many parts of the software religiously depend on and which brings chaos to the whole if something goes wrong with it.

God objects are not easy to avoid in practice. When creating a POC, the effort is mainly focused on the features, while good design principles, like modularity, is delayed until the POC is accepted. Even in an exploited product, we may prefer to add a small method in an existing piece rather than create a dedicated class "just for that". This behaviour leads to iteratively inflate some classes before to figure out they are just doing too much. For example, a context object contains the data of a given scope and is passed to several methods which need this data. It eases the implementation of related methods, and the mistake is to add logics and more data directly into the context object for practical reasons, which increases its scope and progressively transforms it into a God object. Any class can easily be promoted to a God object through iterative increase of its scope.


God objects foster several issues:

Let's be honest: God objects are big bosses! Well, they are God level after all, so of course they are not for lvl. 1 players. Refactoring a God object can be a serious trap for 3 reasons:

  1. First, many pieces depend on it, so you can break many things at once if you don't pay attention, which means any single change is risky.
  2. Second, it takes ages to refactor correctly, and becoming impatient means increasing the risk to do something bad at each change.
  3. Third, it contains a lot of things, so you will need to do many changes to cut everything properly, which multiplies the risks correspondingly.

So, why would you take the risk? Well, because this risk actually is mere illusions: it comes only with bad refactoring practices. Remember, we are speaking about refactoring, not fixing. So, how do we trick the maths to make it safe? Let's go for each point again:

  1. First, no behaviour should change, only the design should evolve, so no single change should break anything at all.
  2. Second, nothing forbids you to go iteratively, so stop when you need it and come back later when you have time for it.
  3. Third, once you removed all the risks from the previous points, it is still many changes, but many times zero is still zero risk.

In summary, the secret for refactoring a God object safely is to do iso-functional changes, to do them iteratively, and at your own pace. In other words, what we need is a refactoring procedure that can be stopped at any time, without breaking anything, and continued later. This is what we will present here.


Removing the God object can be done in several phases, some longer than others. But no stress: each phase is also iterative, so you can go one change at a time. Stopping in the middle of a phase is not an issue, as long as you stop between two atomic changes.

Preliminary Phase: Identify Your Needs

We first analyse how the God object is used to identify the relevant features in which it should be split.

First Dispatch: Cut the Logics into New Features

Once we know what are the relevant features, let's start creating them with the code of the God object. We make the God object build on them to ensure its tests validate the newly created features.

Second Dispatch: Move the State to the New Features

In the previous step, we only moved the code of the methods to build the logics of the features. The various methods may, however, build on fields required by several features. In this step, we see how to dispatch this data to finalize the features.

Third Dispatch: Move the Tests to the New Features

Now the God object builds exclusively on other features, making it a mere façade that bring them together. At that point, the tests of the God object are actually tests of these features. So let's move these tests to the features themselves to ensure they stay and evolve together.

First Transformation: Give the Potential of a Façade

Depending on your needs, you may want to preserve the God object as a mere façade. In this case, let's finalize it to ensure it remains easy to maintain and evolve.

Second Transformation: Test the Façade

In the following of the previous step, if you want to keep the façade, then you may want to test it properly.

Last Marathon: Refactor the Users' Code

That's it! You now have all your new features, ready to serve. You are also ready to remove the God object or to use it as a façade. The next phase consists in going through all the code that uses the God object to replace it correspondingly.