Persilsoft.Exceptions 1.0.11

Persilsoft.Exceptions

It contains custom exceptions with their respective handlers. These handlers implement the new AspNet Core 8.0 interface IExceptionHandler, formatting the output into a ProblemDetails object serialized to Json.

The package contains the following exceptions:

• ForbiddenAccessException
• NotFoundException
• UpdateException
• ValidationException

The respective handlers for each of the exceptions are registered as follows:

builder.Services
    .AddNotFoundExceptionHandler()
    .AddValidationExceptionHandler()
    .AddUpdateExceptionHandler()
    .AddUnhandledExceptionHandler();

The title of the ProblemDetails can be displayed in either English or Spanish. To achieve this, you need to configure localization middleware in your AspNet Core application:

builder.Services.Configure<RequestLocalizationOptions>(options =>
{
    var supportedCultures = new[] { "en-US", "es-PE" };
    var neutralCulture = supportedCultures[0];

    options.SetDefaultCulture(neutralCulture)
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);
});

Finally, we add the localization and exception handling middlewares to the AspNet Core pipeline

app.UseRequestLocalization();
app.UseExceptionHandler(e => { });

Note:
It's important that the localization middleware is added before the exception handling middleware; otherwise, you won't see the messages in the appropriate language.

Example

app.MapGet("/admin/dashboard", () =>
{
    throw new ForbiddenAccessException();
})
.WithName("Admin");

app.MapGet("/product/{id:int}", async (int id, MyContext context) =>
{
    var Product = await context.Products.SingleOrDefaultAsync(p => p.Id == id);
    if (Product is null)
    {
        throw new NotFoundException();
    }

    return Results.Ok(Product);
})
.WithTags("Product");

app.MapPost("/Product/register", async (MyContext context) =>
{
    context.Add(new Product
    {
        Id = 7,
        Name = "Chai",
        UnitPrice = 59.99M,
        UnitsInStock = 80
    });

    try
    {
        await context.SaveChangesAsync();
    }
    catch (DbUpdateException ex)
    {
        throw new UpdateException(ex, ex.Entries.Select(e => e.Entity.GetType().Name));
    }

    return Results.Ok("Product registered.");
})
.WithTags("Product");

You can see an example of ValidationException in the package documentation Persilsoft.Validation