モックテストの偽陽性を検知する: SELECT 漏れの安全網

SELECT Id, StageName FROM Opportunity WHERE Id = :oppId

public with sharing class GetOppNameUsecase {
    private final Id oppId;
    private final IEloquent eloquent;
 
    public GetOppNameUsecase(Id oppId, IEloquent eloquent) {
        this.oppId = oppId;
        this.eloquent = eloquent ?? new Eloquent();
    }
 
    public String invoke() {
        // ❌ Name を SELECT し忘れた
        Scribe oppScribe = Scribe.of(Opportunity.class)
            .field('Id')
            .whereEqual('Id', this.oppId);
 
        IEntry oppEntry = this.eloquent.first(oppScribe);
 
        // この行で例外が出る (Name は SELECT されていない)
        return oppEntry.getName();
    }
}

@isTest
static void testInvoke_WhenOppExists_ThenReturnsName() {
    Trace t = Trace.of('正常系: Opportunity の Name が取得できること');
    t.start();
 
    // Arrange
    MockEntry oppEntry = MockEntry.of(Opportunity.class)
        .alias('opp')
        .autoId(1)
        .set('Name', 'Acme Opportunity');
    IEloquent mockEloquent = new MockEloquent(oppEntry);
    GetOppNameUsecase usecase = new GetOppNameUsecase(oppEntry.getAliasId('opp'), mockEloquent);
 
    // Act
    // ※ Scribe で Name を SELECT 漏れしているため、invoke 内部で
    //   ApexEloquentException が投げられ、以降の Assert には到達しない
    String name = usecase.invoke();
 
    // Assert
    Assert.areEqual('Acme Opportunity', name);
 
    t.finish();
}

====== APEX ELOQUENT EXCEPTION ======
Location: MockEntry
Error   : The `fieldName` argument is Invalid.
Reason  : The specified field is not selected in Scribe
Action  : Add the field to the Scribe definition (e.g. `.field('Name')`) or call .withoutFieldValidation() when intentional
Provided: [fieldName => 'Name'][objectName => 'Opportunity']

public String invoke() {
    // ❌ Account.Name を parentField の SELECT 句に追加し忘れた
    Scribe oppScribe = Scribe.of(Opportunity.class)
        .field('Id')
        .parentField(
            Scribe.asParent('AccountId').field('Id')  // Name が抜けている
        )
        .whereEqual('Id', this.oppId);
 
    IEntry oppEntry = this.eloquent.first(oppScribe);
    IEntry accountEntry = oppEntry.getParent('AccountId');
 
    // この行で例外 (Account.Name は SELECT されていない)
    return accountEntry.getName();
}

@isTest
static void testInvoke_WhenOppExists_ThenReturnsParentAccountName() {
    Trace t = Trace.of('正常系: Opportunity の親 Account の Name が取得できること');
    t.start();
 
    // Arrange: モック側には Account.Name の値をセットしておく
    //          (Scribe の SELECT に Name が含まれていなくても、モックには値がある状態)
    MockEntry oppEntry = MockEntry.of(Opportunity.class)
        .alias('opp')
        .autoId(1)
        .setParent('AccountId',
            MockEntry.of(Account.class)
                .autoId(1)
                .set('Name', 'Acme Corporation')
        );
    IEloquent mockEloquent = new MockEloquent(oppEntry);
    GetParentAccountNameUsecase usecase =
        new GetParentAccountNameUsecase(oppEntry.getAliasId('opp'), mockEloquent);
 
    // Act
    // ※ Scribe の parentField で Account.Name を SELECT 漏れしているため、
    //   invoke 内部で ApexEloquentException が投げられ、以降の Assert には到達しない
    String accountName = usecase.invoke();
 
    // Assert
    Assert.areEqual('Acme Corporation', accountName);
 
    t.finish();
}

====== APEX ELOQUENT EXCEPTION ======
Location: MockEntry
Error   : The `fieldName` argument is Invalid.
Reason  : The specified field is not selected in Scribe
Action  : Add the field to the Scribe definition (e.g. `.field('Name')`) or call .withoutFieldValidation() when intentional
Provided: [fieldName => 'Name'][objectName => 'Account']

====== APEX ELOQUENT EXCEPTION ======
Location: MockEntry.getParent(String parentIdFieldName)
Error   : The `parentIdFieldName` argument is Invalid.
Reason  : The specified parentIdFieldName is not defined as a relationship in Scribe. SObject: Opportunity
Action  : Ensure that the parentIdFieldName 'AccountId' is included as a relationship in the Scribe definition for this object.
Provided: [parentIdFieldName => 'AccountId']

public List<String> invoke() {
    Scribe accountScribe = Scribe.of(Account.class)
        .field('Id')
        .withChildren(
            Scribe.asChild(Contract.class).field('Id')  // ❌ Name が抜けている
        )
        .whereEqual('Id', this.accountId);
 
    IEntry accountEntry = this.eloquent.first(accountScribe);
    List<IEntry> contracts = accountEntry.getChildren('Contracts');
 
    List<String> contractNames = new List<String>();
    for(IEntry contract : contracts) {
        // この行で例外 (Contract.Name は SELECT されていない)
        contractNames.add((String) contract.get('Name'));
    }
    return contractNames;
}

@isTest
static void testInvoke_WhenAccountHasContracts_ThenReturnsContractNames() {
    Trace t = Trace.of('正常系: Account 配下の Contract の Name 一覧が取得できること');
    t.start();
 
    // Arrange: モック側には Contract.Name の値をセットしておく
    MockEntry accountEntry = MockEntry.of(Account.class)
        .alias('acc')
        .autoId(1)
        .setChildren('Contracts', new List<MockEntry>{
            MockEntry.of(Contract.class)
                .autoId(1)
                .set('Name', 'Contract 1'),
            MockEntry.of(Contract.class)
                .autoId(2)
                .set('Name', 'Contract 2')
        });
    IEloquent mockEloquent = new MockEloquent(accountEntry);
    GetAccountContractNamesUsecase usecase =
        new GetAccountContractNamesUsecase(accountEntry.getAliasId('acc'), mockEloquent);
 
    // Act
    // ※ Scribe の withChildren で Contract.Name を SELECT 漏れしているため、
    //   invoke 内部で ApexEloquentException が投げられ、以降の Assert には到達しない
    List<String> names = usecase.invoke();
 
    // Assert
    Assert.areEqual(2, names.size());
    Assert.areEqual('Contract 1', names[0]);
    Assert.areEqual('Contract 2', names[1]);
 
    t.finish();
}

====== APEX ELOQUENT EXCEPTION ======
Location: MockEntry
Error   : The `fieldName` argument is Invalid.
Reason  : The specified field is not selected in Scribe
Action  : Add the field to the Scribe definition (e.g. `.field('Name')`) or call .withoutFieldValidation() when intentional
Provided: [fieldName => 'Name'][objectName => 'Contract']

public with sharing class AggregateOppByStageUsecase {
    private final IEloquent eloquent;
 
    public AggregateOppByStageUsecase(IEloquent eloquent) {
        this.eloquent = eloquent ?? new Eloquent();
    }
 
    public Map<String, Decimal> invoke() {
        Scribe analyticsScribe = Scribe.of(Opportunity.class)
            .field('StageName')
            .average('Amount', 'avgAmount')    // ❌ 本当は sum を totalAmount で取りたいのに、average しか書いていない
            .groupByField('StageName');
 
        List<IEntry> results = this.eloquent.get(analyticsScribe);
 
        Map<String, Decimal> stageToTotal = new Map<String, Decimal>();
        for(IEntry result : results) {
            String stage = (String) result.get('StageName');
            // この行で例外 (Scribe では totalAmount を SELECT していない)
            Decimal total = (Decimal) result.get('totalAmount');
            stageToTotal.put(stage, total);
        }
        return stageToTotal;
    }
}

@isTest
static void testInvoke_WhenOppsExist_ThenReturnsStageToTotal() {
    Trace t = Trace.of('正常系: Stage ごとの合計金額が Map で返ること');
    t.start();
 
    // Arrange: モック側には totalAmount をセット (Scribe の SELECT には含まれていない)
    IEloquent mockEloquent = new MockEloquent(
        MockEntry.asAggregateResult()
            .set('StageName', 'Prospecting')
            .set('totalAmount', 10000)
    );
    AggregateOppByStageUsecase usecase = new AggregateOppByStageUsecase(mockEloquent);
 
    // Act
    // ※ Scribe で totalAmount エイリアスを SELECT していないため、
    //   invoke 内部で ApexEloquentException が投げられ、以降の Assert には到達しない
    Map<String, Decimal> stageToTotal = usecase.invoke();
 
    // Assert
    Assert.areEqual(10000, stageToTotal.get('Prospecting'));
 
    t.finish();
}

====== APEX ELOQUENT EXCEPTION ======
Location: MockEntry.get(String fieldName)
Error   : The `fieldName` argument is Invalid.
Reason  : The specified field or alias is not exist in Scribe.
Action  : Add the field or alias to the Scribe definition for this AggregateResult
Provided: [fieldName => 'totalAmount']

MockEloquent mock = (new MockEloquent())
  .attach(MyUsecase.LBL_FETCH, new List<IEntry>());

MockEntry card = MockEntry.of(BusinessCard__c.class)
  .autoId(1)
  .set('CompanyName__c', 'Acme')
  .fetchedBy(RematchCompanyCardsHandler.scope());