AutoWrapper is a simple, yet customizable global HTTP exception handler and response wrapper for ASP.NET Core APIs. It uses an ASP.NET Core middleware to intercept incoming HTTP requests and automatically wraps the responses for you by providing a consistent response format for both successful and error results. The goal is to let you focus on your business code specific requirements and let the wrapper automatically handle the HTTP response. This can speedup the development time when building your APIs while enforcing own standards for your HTTP responses.
Main features:
Exception handling.
A configurable middleware options to configure the wrapper.
ModelState validation error handling (support both Data Annotation and FluentValidation).
A configurable API exception.
A consistent response format for Result and Errors.
A detailed Result response.
A detailed Error response.
A configurable HTTPStatusCodes and messages.
Add Logging support for Request, Response and Exceptions.
Add support for Problem Details exception format.
Add support for ignoring action methods that don't need to be wrapped using [AutoWrapIgnore] filter attribute.
Breaking changes
This release supports .NET 5 and .NET 6
Middleware has been renamed from UseApiResponseAndExceptionWrapper to UseAutoWrapper. Make sure to update your to use the new name.
Startup.cs
ProblemDetails is now the default exception format
UseApiProblemDetailsException has been renamed to DisableProblemDetailsException
Removed Newtonsoft.Json dependency and replaced it with System.Text.Json
Use the interface IApiResponse model instead of the concrete ApiResponse model for returning responses using the default format. This allows you to add your own properties that will wrapped within the Result property.
AutoWrapIgnore and RequestDataLogIgnore attributes now leaves under AutoWrapper.Attributes namespace. The implementation was changed from using IActionFilter to use Attribute, eliminating all the request header logic.
The following options has been removed:
ApiVersion
ReferenceLoopHandling
UseCustomSchema
ReferenceLoopHandling and DefaultContractResolver aren't still supported in .NET 5 that's why handling reference loop and ApiResponse property mappings will not be supported when targetting .NET 5.
.NET Core 3.1 will still use Newtonsoft.Json and it's only supported by AutoWrapper <= v4.5.1
Installation
Download and Install the latest AutoWrapper.Core from NuGet or via CLI:
For ASP.NET Core 3.x versions, see the documentation here: AutoWrapper v4.x
Unwrapping the Result from .NET Client
AutoWrapper.Server is simple library that enables you unwrap the Result property of the AutoWrapper's ApiResponse object in your C# .NET Client code. The goal is to deserialize the Result object directly to your matching Model without having you to create the ApiResponse schema.
For example:
[HttpGet]
public async Task<IEnumerable<PersonDTO>> Get()
{
var client = HttpClientFactory.Create();
var httpResponse = await client.GetAsync("https://localhost:5001/api/v1/people");
IEnumerable<PersonDTO> people = null;
if (httpResponse.IsSuccessStatusCode)
{
var jsonString = await httpResponse.Content.ReadAsStringAsync();
people = Unwrapper.Unwrap<IEnumerable<PersonDTO>>(jsonString);
}
return people;
}
I’m pretty sure there are still lots of things to improve in this project. Try it out and let me know your thoughts.
Feel free to submit a ticket if you find bugs or request a new feature. Your valuable feedback is much appreciated to better improve this project. If you find this useful, please give it a star to show your support for this project.
