The Clean Code Blog

by Robert C. Martin (Uncle Bob)

The Little Mocker

14 May 2014

The following is a conversation around mocking:

What is this?:

interface Authorizer {
  public Boolean authorize(String username, String password);
} >_An interface._

So what then, is this?

public class DummyAuthorizer implements Authorizer {
  public Boolean authorize(String username, String password) {
	return null;
  	  }
} >_That's a Dummy._

And what do you do with a Dummy?

You pass it into something when you don’t care how it’s used.

Such as?

As part of a test, when you must pass an argument, but you know the argument will never be used.

Can you show an example?

Sure.

  public class System {
	public System(Authorizer authorizer) {
		this.authorizer = authorizer;
	}

	public int loginCount() {
		//returns number of logged in users.
	}
  }

  @Test
  public void newlyCreatedSystem_hasNoLoggedInUsers() {
	System system = new System(new DummyAuthorizer());
	assertThat(system.loginCount(), is(0));
  }

I see. In order to construct the System an Authorizer must be passed to the constructor; but the authorize method of that Authorizer will never be called since, in this test, no one will log in.

You got it.

And so the fact that the authorize method of the DummyAuthorizer returns a null is not an error.

Indeed not. In fact, it’s the best thing a Dummy can return.

Why is that?

Because if anybody tried to use that Dummy, they’d get a NullPointerException.

Ah, and you don’t want the Dummy to be used.

Right! It’s a dummy.

But isn’t this a mock? I thought these test objects were called mocks.

They are; but that’s slang.

Slang?

Yes, the word “mock” is sometimes used in an informal way to refer to the whole family of objects that are used in tests.

Is there a formal name for these test objects?

Yes, they are called “Test Doubles”[1].

You mean like “Stunt Doubles” in the movies?

Exactly.

So then the word “mock” is just colloquial slang?

No, it has a formal meaning too; but when we are speaking informally the word mock is a synonym for Test Double.

Why do we have two words? Why don’t we just use Test Double instead of Mock?

History.

History?

Yes, long ago some very smart people wrote a paper that introduced and defined the term Mock Object. Lots of other people read it and started using that term. Other people, who hadn’t read the paper, heard the term and started using it with a broader meaning. They even turned the word into a *verb*. They’d say, “Let’s mock that object out.”, or “We’ve got a lot of mocking to do.”

That kind of thing happens a lot with words, doesn’t it?

Yes it does. Especially when a word has just one syllable, and is easy to say.

Yeah, I guess it’s easier to say: “Let’s mock that.” instead of: “Let’s make a test double for that.”

Right. Colloquialisms are a fact of life.

OK, but when we need to speak precisely…

You should use the formal language. Yes.

So then what is a Mock?

Before we get to that, we should look at other kinds of Test Doubles.

Like what?

Let’s look at Stubs.

What’s a stub?

This, is a stub:

public class AcceptingAuthorizerStub implements Authorizer {
  public Boolean authorize(String username, String password) {
	return true;
  	  }
}

It returns true.

That’s right.

Why?

Well, suppose you want to test a part of your system that requires you to be logged in.

I’d just log in.

But you already know that login works, You’ve tested it a different way. Why test it again?

Because it’s easy?

But it takes time. And it requires setup. And if there’s a bug in login, your test will break. And, after all, it’s an unnecessary coupling.

Hmmm. Well, for the sake of argument, let’s say I agree. What then?

You simply inject the AcceptingAuthorizerStub into your system for that test.

And it will authorize the user without question.

Right.

And if I want to test the part of the system that handles unauthorized users, I could use a stub that returns false.

Right again.

OK, so what else is there?

There’s this:

public class AcceptingAuthorizerSpy implements Authorizer {
  public boolean authorizeWasCalled = false;

  public Boolean authorize(String username, String password) {
	authorizeWasCalled = true;
	return true;
  }
}

I suppose that’s called a Spy.

That’s right.

So why would I use it?

You’d use this when you wanted to be sure that the authorize method was called by your system.

Ah, I see. In my test I’d inject it like a stub, but then at the end of my test I’d check the authorizerWasCalled variable to make sure my system actually called authorize.

Absolutely.

So a Spy, spies on the caller. I suppose it could record all kinds of things.

Indeed it could. For example, it could count the number of invocations.

Yeah, or it could keep a list of the arguments passed in each time.

Yes. You can use Spies to see inside the workings of the algorithms you are testing.

That sounds like coupling.

It is! You have to be careful. The more you spy, the tighter you couple your tests to the implementation of your system. And that leads to fragile tests.

What’s a fragile test?

A test that breaks for reasons that shouldn’t break a test.

Well if you change the code in the system, some tests are going to break.

Yes, but well designed tests minimize that breakage. Spies can work against that.

OK, I get that. What other kinds of test doubles are there?

Two more. Here’s the first:

public class AcceptingAuthorizerVerificationMock implements Authorizer {
  public boolean authorizeWasCalled = false;

  public Boolean authorize(String username, String password) {
	authorizeWasCalled = true;
	return true;
  }

  public boolean verify() {
	return authorizedWasCalled;
  }
}

And, of course, this is a mock.

A True Mock. Yes.

True?

Yes, this is a formal mock object according to the original meaning of the word.

I see. And it looks like you moved the assertion from the test, into the verify method of the, uh, true mock.

Right. Mocks know what they are testing.

So that’s it? You just put the assertion into the mock?

Not quite. Yes, the assertion goes into the mock. However, what the mock is testing is behavior.

Behavior?

Yes. The mock is not so interested in the return values of functions. It’s more interested in what function were called, with what arguments, when, and how often.

So a mock is always a spy?

Yes. A mock spies on the behavior of the module being tested. And the mock knows what behavior to expect.

Hmmm. Moving the expectation into the mock feels like a coupling.

It is.

So why do it?

It makes it a lot easier to write a mocking tool.

A mocking tool?

Yes, like JMock, or EasyMock, or Mockito. These tools let you build mock objects on the fly.

That sounds complicated.

It’s not. here is a famous paper by Martin Fowler that expains it well.

And there’s a book too, isn’t there?

Yes. Growing Object Oriented Software, Guided by Tests is a great book about a popular design philosophy driven by mocks.

OK, so then are we done? You said there was still another kind of test double.

Yes, one more. Fakes.

  public class AcceptingAuthorizerFake implements Authorizer {
	  public Boolean authorize(String username, String password) {
		return username.equals("Bob");
	  }
  }

OK, that’s strange. Everybody named “Bob” will be authorized.

Right. a Fake has business behavior. You can drive a fake to behave in different ways by giving it different data.

It’s kind of like a simulator.

Yes, simulators are fakes.

Fakes aren’t stubs are they?

No, fakes have real business behavior; stubs do not. Indeed, none of the other test doubles we’ve talked about have real business behavior.

So fakes are different at a fundamental level.

Indeed they are. We can say that a Mock is a kind of spy, a spy is a kind of stub, and a stub is a kind of dummy. But a fake isn’t a kind of any of them. It’s a completely different kind of test double.

I imagine Fakes could get complicated.

They can get extremely complicated. So complicated they need unit tests of their own. At the extremes the fake becomes the real system.

Hmmm.

Yes, Hmmm. I don’t often write fakes. Indeed, I haven’t written one for over thirty years.

Wow! So what do you write? Do you use all these other test doubles?

Mostly I use stubs and spies. And I write my own, I don’t often use mocking tools.

Do you use Dummies?

Yes, but rarely.

What about mocks?

Only when I use a mocking tool.

But you said you don’t use mocking tools.

That’s right, I usually don’t.

Why not?

Because stubs and spies are very easy to write. My IDE makes it trivial. I just point at the interface and tell the IDE to implement it. Voila! It gives me a dummy. Then I just make a simple modification and turn it into a stub or a spy. So I seldom need the mocking tool.

So it’s just a matter of convenience?

Yes, and the fact that I don’t like the strange syntax of mocking tools, and the complications they add to my setups. I find writing my own test doubles to be simpler in most cases.

OK, well, thank you for the conversation.

Any time.


[1] xUnit Test Patterns