Verifying registerNew and registerRelationship (fflib_ISObjectUnitOfWork) with Apex Mocks

Question

Given the following method, I would like to verify the registerNew/registerRelationship using Apex Mocks on my unit tests, basically to know if the record is going to be created as expected.

public Opportunity createOpportunity(fflib_ISObjectUnitOfWork uow, Contact c, Id userId){

Opportunity opp = new Opportunity(
        name                        = 'First Opp',
        StageName                   = 'First step',
        CloseDate                   =  Date.today(),
        OwnerId                     =  userId
);

uow.registerNew(opp,Opportunity.ContactId, c);
uow.registerRelationship(opp,Opportunity.Contacto__c, c);

return opp;

}

I am not able to find any documentation where I can understand how to do it, only found some articles registering sObjects without any relation like uow.registerNew(contacts) and therefore verifying later, for example, using the following piece of code:

((fflib_ISObjectUnitOfWork) mocks.verify(unitOfWorkMock)).registerNew(fflib_Match.sObjectWith(
            new Map<SObjectField, Object>{
                    Contact.FirstName => requestDTO.consumer.consumerName}
));

Answer 1

So, to verify your calls to uow your test class needs to do these things:

// Given an instance of ApexMocks
fflib_ApexMocks mocks = new fflib_ApexMocks();

// Given an instance of a mock UnitOfWork class
fflib_SObjectUnitOfWork mockUow = (fflib_SObjectUnitOfWork) mocks.mock(fflib_SObjectUnitOfWork.class);

// Given mock instance injected into the fflib factories
Application.UnitOfWork.setMock(mockUow);

// Given mock data
Contact mockContact = new Contact(Id = fflib_IDGenerator.generate(Contact.SObjectType));

// when execute your code under test
new MyClass().createOpportunity(mockUow,mockContact,UserInfo.getUserId()); 
             

// then verify unitOfWork method calls
((fflib_ISObjectUnitOfWork) mocks.verify(unitOfWorkMock))
   .registerNew(
     fflib_Match.sObjectWith(
        new Map<SObjectField, Object>{
                Opportunity.Name => 'First Opp',
                Opportunity.StageName => 'First step',
                Opportunity.CloseDate => Date.today(),
                Opportunity.OwnerId => UserInfo.getUserId()}),
      fflib_Match.eqSObjectField(Opportunity.ContactId),
      fflib_Match.sObjectWith(
        new Map<SObjectField, Object>{
                Contact.Id => mockContact.Id})
));

Note that the verify matches all three arguments of your

uow.registerNew(opp,Opportunity.ContactId, c);

Here is the second verify for uow.registerRelationship(opp,Opportunity.Contacto__c, c);

((fflib_ISObjectUnitOfWork) mocks.verify(unitOfWorkMock))
   .registerRelationship(
     fflib_Match.sObjectWith(
        new Map<SObjectField, Object>{
                Opportunity.Name => 'First Opp',
                Opportunity.StageName => 'First step',
                Opportunity.CloseDate => Date.today(),
                Opportunity.OwnerId => UserInfo.getUserId()}),
      fflib_Match.eqSObjectField(Opportunity.Contacto__c),
      fflib_Match.sObjectWith(
        new Map<SObjectField, Object>{
                Contact.Id => mockContact.Id})
));