elukaweski / fflib-apex-mocks

FinancialForce.com ApexMocks Framework

FinancialForce ApexMocks Framework

ApexMocks is a mocking framework for the Force.com Apex language.

It derives it's inspiration from the well known Java mocking framework Mockito

Using ApexMocks on Force.com

ApexMocks allows you to write tests to both verify behaviour and stub dependencies.

An assumption is made that you are using some form of Dependency Injection - for example passing dependencies via a constructor:

public MyClass(ClassA.IClassA dependencyA, ClassB.IClassB depdenceyB)

This allows you to pass mock implementations of dependencies A and B when you want to unit test MyClass.

Lets assume we've written our own list interface MyList.IList that we want to either verify or stub:

public class fflib_MyList implements IList
{
	public interface IList
	{
		void add(String value);
		String get(Integer index);
		void clear();
		Boolean isEmpty();
	}
}

verify() behaviour verification

	// Given
	fflib_ApexMocks mocks = new fflib_ApexMocks();
	fflib_MyList.IList mockList = new MockMyList(mocks);

	// When
	mockList.add('bob');

	// Then
	((fflib_MyList.IList) mocks.verify(mockList)).add('bob');
	((fflib_MyList.IList) mocks.verify(mockList, fflib_ApexMocks.NEVER)).clear();

when() dependency stubbing

	fflib_ApexMocks mocks = new fflib_ApexMocks();
	fflib_MyList.IList mockList = new MockMyList(mocks);

	mocks.startStubbing();
	mocks.when(mockList.get(0)).thenReturn('bob');
	mocks.when(mockList.get(1)).thenReturn('fred');
	mocks.stopStubbing();

Documentation

Full documentation for ApexMocks can be found at Code4Clode:

• ApexMocks Framework Tutorial
• Simple Dependency Injection
• ApexMocks Generator
• Behaviour Verification
• Stubbing Dependencies
• Supported Features
• New Improved apex-mocks-generator
• ApexMocks Improvements - exception stubbing, base classes and more

Documentation from Jesse Altman

• ApexMock blogs from Jesse Altman