AddXMapEndpoints 1.1.0

XMaps Enpoints

This extension allows you to auto-generate Minimal API into your WebApplication.

To use this �magic� feature just follow those siple steps:

1. Add the extension method inside your Program.cs class:

   app.AddXMapEndpoints(); // It's a kind of magic...

2. Decorate desired DTO�s with the �AddXMapEndpoints� attribute

   [AddXMapEndpoints]

   public class MyDto

How it works:

Decorating a DTO with the �AddXMapEndpoints� attribute will create those API:

• GET ⇒ IEnumerable<DTO>
• GET ⇒ DTO (searching by key)
• POST ⇒ DTO
• PUT ⇒ DTO
• DELETE ⇒ DTO (using POST verb)

The api, and relative routes, will be created in this way:

• MapGet ⇒ "/X" + typeof(�YourDto�).Name
• MapGet ⇒ "/X" + typeof(�YourDto�).Name + "/{key}"
• MapPost ⇒ "/X" + typeof(�YourDto�).Name , myDto
• MapPut ⇒ "/X" + typeof(�YourDto�).Name , myDto
• MapPost ⇒ "/XDelete" + typeof(�YourDto�).Name , myDto

NB: Navigation properties (FK) are automatically loaded.

To load also �collection� navigations you must explicitly declare it within the attribute:

[AddXMapEndpoints(includeChildren: true)]

Examples:

// Get a LIST of DTO

var many = await httpClient.GetFromJsonAsync<List<MyDto>>(baseUri + "X" + nameof(MyDto));

// Get a SINGLE DTO (with key = 1)

var one = await httpClient.GetFromJsonAsync<MyDto>(baseUri + "X" + nameof(MyDto) +"/1");

// Create a new entity (mapped from myDto)

var newDto = await httpClient.PostAsJsonAsync<MyDto>(baseUri + "X" + nameof(MyDto), myDto);

// Update an existing entity (mapped from myDto)

var updDto = await httpClient.PutAsJsonAsync<MyDto>(baseUri + "X" + nameof(MyDto), myDto);

// Delete an existing entity (mapped from myDto) NB: POST verb is used (to pass dto as body)

var res = await httpClient.PostAsJsonAsync<MyDto>(baseUri + "XDelete" + nameof(MyDto), myDto);