Method FindAllAsync
- Namespace
- MailFathom.Application.Contacts
- Assembly
- MailFathom.Application.dll
FindAllAsync(IReadOnlyCollection<ContactId>, CancellationToken)
Reads several contacts by the identities the book gave them.
Task<IReadOnlyDictionary<ContactId, Contact>> FindAllAsync(IReadOnlyCollection<ContactId> contactIds, CancellationToken cancellationToken)Parameters
contactIdsIReadOnlyCollection<ContactId>The contacts to read, at most one page of the book's worth.
cancellationTokenCancellationTokenCancels the read.
Returns
- Task<IReadOnlyDictionary<ContactId, Contact>>
An entry for every identity the book holds, keyed by that identity; identities it holds none of are absent.
Remarks
One read for a whole set rather than one per identity, because a caller resolving the people an act named would otherwise make the number of queries its own input's to decide. A caller with more identities than the bound admits asks in bounded groups; the bound is the same one a page of the book is read under, so no read here is larger than one this port already answers.
Exceptions
- ArgumentNullException
Thrown when
contactIdsis null.- ArgumentOutOfRangeException
Thrown when more identities are supplied than one page of the book holds.