Are you an LLM? You can read better optimized documentation at /before-delete/add-ons/related-query.md for this page in Markdown format
BeforeDelete.RelatedQuery
Query children, siblings or other records once per handler per run, and read them per record with record.getRelated(name).
Signature
apex
public interface RelatedQuery {
Map<String, BeforeDelete.RecordsProvider> queryRelatedOnBeforeDelete();
}queryRelatedOnBeforeDelete(): called at most once per handler per run, at this handler’s firstgetRelated. Returns provider name →RecordsProvider.
Example
apex
public with sharing class ContactValidator implements BeforeDelete.Validator, BeforeDelete.RelatedQuery {
public Map<String, BeforeDelete.RecordsProvider> queryRelatedOnBeforeDelete() {
return new Map<String, BeforeDelete.RecordsProvider>{ 'accountContacts' => new AccountContactsProvider() };
}
public Boolean addErrorOnBeforeDeleteWhen(TriggerTypes.DeleteRecord record) {
Id accountId = ((Contact) record.getOldSObject()).AccountId;
return accountId != null && record.getRelated('accountContacts').getAllWhereKeyEquals(accountId).size() == 1;
}
public void addErrorOnBeforeDelete(TriggerTypes.RejectableDeleteRecord record) {
record.addError('The last contact of an account cannot be deleted.');
}
private with sharing class AccountContactsProvider implements BeforeDelete.RecordsProvider {
public List<SObject> query(TriggerTypes.DeleteRecords records) {
return [SELECT Id, AccountId FROM Contact WHERE AccountId IN :records.getIdsOf(Contact.AccountId)];
}
public String keyOf(SObject row) {
return ((Contact) row).AccountId;
}
}
}RecordsProvider
Signature
apex
public interface RecordsProvider {
List<SObject> query(TriggerTypes.DeleteRecords records);
String keyOf(SObject row);
}query(records): called once per provider, at the handler’s firstgetRelatedwith its name, with every record in the chunk. Returns the rows to index by key;nullcounts as no rows.keyOf(row): called once per row thatqueryreturned. Returns the key thatgetFirstWhereKeyEqualsandgetAllWhereKeyEqualsmatch;nullleaves the row out of the index.
Rules
- An unknown name throws.
getRelatedthrowsTriggerTypes.TriggerLibExceptionwhen no provider has that name. - Counts include the records being deleted. A query here still returns them. To count what will remain, add
Id NOT IN :records.getIds(). - Last chance for cascade children. Children removed by a cascade delete run no delete triggers of their own. Read them here.
- Runs on the first read. A provider queries when the handler first calls
getRelatedwith its name. A read in a predicate queries even when nothing qualifies, so return an empty list fromquerywhen no record can qualify.
WARNING
Sharing can hide rows. A with sharing provider misses rows the user cannot see, so a guard can let a delete through. Use without sharing when it must see every row.
