AppStd/EnvelopeGenerator
8
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Rename MediatR extensions to GetOrThrow for ISender

Browse Source 
Renamed SendOrThrowAsync and SendOrNotFoundAsync extension methods for IMediator to GetOrThrow for ISender, following MediatR best practices. Updated all usages, XML docs, and tests to use ISender and the new method names. Replaced StubMediator with StubSender in tests. Functionality remains the same, but code now aligns with modern MediatR conventions.
This commit is contained in:
tekh
2026-04-08 14:01:24 +02:00
parent ce9958a8b1
commit 993ca82596
2 changed files with 73 additions and 79 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
EnvelopeGenerator.Application/Common/Extensions/MediatorExtensions.cs
View File

@@ -15,16 +15,16 @@ public static class MediatorExtensions
/// </summary>
/// <typeparam name="TResponse">The expected response type.</typeparam>
/// <typeparam name="TException">The exception type to throw.</typeparam>
/// <param name="mediator">The mediator instance.</param>
/// <param name="sender">The mediator instance.</param>
/// <param name="request">The MediatR request whose response may be <c>null</c>.</param>
/// <param name="exceptionFactory">A factory that creates the exception to throw when the response is absent.</param>
/// <param name="cancel">Cancellation token.</param>
/// <returns>A guaranteed non-null <typeparamref name="TResponse"/>.</returns>
/// <exception cref="Exception">The exception produced by <paramref name="exceptionFactory"/>.</exception>
public static async Task<TResponse> SendOrThrowAsync<TResponse, TException>(this IMediator mediator, IRequest<TResponse?> request, Func<TException> exceptionFactory, CancellationToken cancel = default)
public static async Task<TResponse> GetOrThrow<TResponse, TException>(this ISender sender, IRequest<TResponse?> request, Func<TException> exceptionFactory, CancellationToken cancel = default)
where TException : Exception
{
if (await mediator.Send(request, cancel) is TResponse res)
if (await sender.Send(request, cancel) is TResponse res)
{
if (res is not string && res is IEnumerable enumerable && !enumerable.Cast<object>().Any())
throw exceptionFactory();
@@ -39,16 +39,16 @@ public static class MediatorExtensions
/// Sends a request via MediatR and throws <see cref="NotFoundException"/> when the response is <c>null</c> or an empty collection.
/// </summary>
/// <typeparam name="TResponse">The expected response type.</typeparam>
/// <param name="mediator">The mediator instance.</param>
/// <param name="sender">The mediator instance.</param>
/// <param name="request">The MediatR request whose response may be <c>null</c>.</param>
/// <param name="exceptionMessage">Optional message for the <see cref="NotFoundException"/>.</param>
/// <param name="cancel">Cancellation token.</param>
/// <returns>A guaranteed non-null <typeparamref name="TResponse"/>.</returns>
/// <exception cref="NotFoundException">Thrown when the response is <c>null</c> or an empty collection.</exception>
public static async Task<TResponse> SendOrNotFoundAsync<TResponse>(this IMediator mediator, IRequest<TResponse?> request, string? exceptionMessage, CancellationToken cancel = default)
=> await mediator.SendOrThrowAsync(request, () => new NotFoundException(exceptionMessage ?? $"The requested resource of type {typeof(TResponse).Name} was not found."), cancel);
public static async Task<TResponse> GetOrThrow<TResponse>(this ISender sender, IRequest<TResponse?> request, string? exceptionMessage, CancellationToken cancel = default)
=> await sender.GetOrThrow(request, () => new NotFoundException(exceptionMessage ?? $"The requested resource of type {typeof(TResponse).Name} was not found."), cancel);
/// <inheritdoc cref="SendOrNotFoundAsync{TResponse}(IMediator, IRequest{TResponse}, string, CancellationToken)"/>
public static async Task<TResponse> SendOrNotFoundAsync<TResponse>(this IMediator mediator, IRequest<TResponse?> request, CancellationToken cancel = default)
=> await mediator.SendOrNotFoundAsync(request, null, cancel);
/// <inheritdoc cref="GetOrThrow{TResponse}(ISender, IRequest{TResponse}, string, CancellationToken)"/>
public static async Task<TResponse> GetOrThrow<TResponse>(this ISender sender, IRequest<TResponse?> request, CancellationToken cancel = default)
=> await sender.GetOrThrow(request, null, cancel);
}