TriggerExceptionHandler 3.0.0

TriggerExceptionHandler

Super easy ASP.NET Core Exception Handler + ModelState validator for Web API services.

• ASP.NET Core 3.0 ready
• Easy to use (just few rows)
• Standard models
  • https://tools.ietf.org/html/rfc7807
  • ValidationProblemDetails model
• Based on System.Text.Json
• ModelState.IsValid to attribute: [ValidateModelStateAttribute]
• Thanks to StrathWeb for the base pattern

Nuget package installation

Install-Package TriggerExceptionHandler

dotnet add package TriggerExceptionHandler

Some exceptions returns different HttpStatusCode:

• UnauthorizedAccessException: Unauthorized (401)
• KeyNotFoundException: NotFound (404)

Default is 500.

Startup.cs

public void ConfigureServices(IServiceCollection services)
{
    // services.AddMvc(); (you can still use AddMvc)
    // Please see: https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-core-3-0-preview-4/
    services.AddControllers();

    services.TriggerInvalidModelStateResponse();
}

What's in AddControllers()

AddControllers() includes support for:

• Controllers
• Model Binding
• API Explorer (OpenAPI integration)
• Authorization [Authorize]
• CORS [EnableCors]
• Data Annotations validation [Required]
• Formatter Mappings (translate a file-extension to a content-type)

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // custom http status codes
    // app.UseTriggerExceptionHandler(env.ApplicationName, exceptionsCode: new Ext2HttpCode { { typeof(ArgumentException), HttpStatusCode.Ambiguous } });

    app.UseTriggerExceptionHandler(env.ApplicationName);

    app.UseRouting();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

Example responses

Exception Model

{
  "type": "ExpectedException",
  "title": "Youre exception message",
  "status": 500,
  "detail": "...stack trace (if debugger is attached)",
  "instance": "urn:YourApplicationName:1299978476"
}

ValidateModelStateAttribute model

{
  "errors": {
    "Name": ["The Name field is required."]
  },
  "type": "ValidationProblemDetails",
  "title": "Request Validation Error",
  "status": 400,
  "detail": "One or more validation errors occurred",
  "instance": "urn:YourApplicationName:759630415"
}