RESTworld.AspNetCore 5.0.2

.NET 5.0
There is a newer version of this package available.
See the version list below for details. 
dotnet add package RESTworld.AspNetCore --version 5.0.2
NuGet\Install-Package RESTworld.AspNetCore -Version 5.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="RESTworld.AspNetCore" Version="5.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add RESTworld.AspNetCore --version 5.0.2
#r "nuget: RESTworld.AspNetCore, 5.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install RESTworld.AspNetCore as a Cake Addin
#addin nuget:?package=RESTworld.AspNetCore&version=5.0.2

// Install RESTworld.AspNetCore as a Cake Tool
#tool nuget:?package=RESTworld.AspNetCore&version=5.0.2

RESTworld

RESTworld is a framework which utilizes other common frameworks and patterns alltogether to enable easy and fast creation of a truly RESTful API.

Used frameworks and patterns

  • Entity Framework Core for data access
  • ASP.Net Core for hosting
  • HAL for providing hyperlinks between resources
  • OData for query support on list endpoints
  • AutoMapper for mapping between Entities and DTOs
  • Resource based authorization
  • API Versioning through media types

Pipeline

The most basic pipeline has the following data flow for a request on a list endpoint:

  1. Request
  2. Controller selection through ASP.Net Core (optionally with versioning)
  3. Query parsing through OData
  4. Controller method calls business service method
  5. Authorization validates and modifies the request (both optional)
  6. Service validates that all migrations have been applied to the database, to protect from locks during migration.
  7. Service gets the data through Entity Framework Core
  8. Entity Framework Core translates the query into SQL and gets the data from the database
  9. Business service translates Entities into DTOs through Automapper
  10. Authorization validates and modifies the response (both optional)
  11. Controller wraps the result in a HAL response
  12. Result

Usage as API developer

Example

You can find a complete example which leverages all the features offered by RESTworld at https://github.com/wertzui/RESTworld/tree/main/src/Example/ExampleBlog.

Solution structure

If your API gets the name MyApi, structure your Solution with the following Projects:

  • MyApi (ASP.Net Core Web API)
    • References RESTworld.AspNetCore, MyApi.Business
    • Contains your startup logic and your custom controllers
  • MyApi.Business
    • References RESTworld.Business, MyApi.Data
    • Contains your AutoMapperConfiguration and your custom services
  • MyApi.Data
    • References RESTworld.EntityFrameworkCore, MyApi.Common
    • Contains your Entity Framework Core Database Model including Entities and Migrations
  • MyApi.Common
    • References RESTworld.Common
    • Contains your DTOs and Enums
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on RESTworld.AspNetCore:

Package Downloads
RESTworld.Client.AspNetCore

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
22.2.0 489 1/9/2024
22.0.0 115 12/22/2023
21.1.0 302 11/27/2023
21.0.1 101 11/27/2023
21.0.0 166 11/15/2023
20.1.0 287 10/23/2023
20.0.0 279 9/27/2023
19.2.2 164 9/11/2023
19.2.1 371 7/17/2023
19.2.0 214 7/3/2023
19.1.0 134 6/29/2023
19.0.0 161 6/28/2023
18.1.0 405 6/14/2023
18.0.2 351 5/25/2023
18.0.1 170 5/16/2023
18.0.0 239 5/10/2023
17.1.1 190 5/2/2023
17.1.0 191 4/30/2023
17.0.0 202 4/19/2023
16.0.0 244 3/12/2023
15.1.1 552 2/22/2023
15.1.0 266 2/9/2023
15.0.0 422 1/24/2023
14.1.0 330 1/24/2023
14.0.2 478 1/5/2023
14.0.1 278 1/5/2023
14.0.0 375 12/21/2022
13.0.0 509 11/9/2022
12.1.0 600 10/20/2022
12.0.0 489 10/20/2022
11.10.0 608 9/27/2022
11.9.0 794 6/28/2022
11.8.0 649 6/27/2022
11.7.0 605 6/23/2022
11.6.1 633 6/8/2022
11.6.0 605 6/7/2022
11.5.1 692 5/13/2022
11.5.0 944 4/1/2022
11.4.0 673 3/30/2022
11.3.1 796 3/16/2022
11.3.0 726 3/15/2022
11.2.4 740 3/13/2022
11.2.3 695 3/10/2022
11.2.2 723 3/9/2022
11.2.1 709 3/8/2022
11.1.3 873 3/7/2022
11.1.2 739 2/24/2022
11.1.1 711 2/22/2022
11.1.0 704 2/22/2022
11.0.0 721 2/21/2022
10.0.0 598 1/14/2022
9.0.4 366 1/6/2022
9.0.3 416 12/16/2021
9.0.2 397 12/9/2021
9.0.1 428 12/9/2021
9.0.0 304 12/3/2021
8.2.0 2,965 11/25/2021
8.1.1 543 11/4/2021
8.1.0 559 11/4/2021
8.0.0 612 10/28/2021
7.0.1 394 10/12/2021
7.0.0 430 10/6/2021
6.0.1 438 10/6/2021
6.0.0 402 10/6/2021
5.2.0 439 9/29/2021
5.1.0 392 9/27/2021
5.0.2 395 9/13/2021
5.0.1 376 9/8/2021
5.0.0 422 9/7/2021
4.1.0 368 8/18/2021
4.0.0 401 7/7/2021
3.0.0 416 7/5/2021
2.0.0 427 6/29/2021
1.2.0 397 5/11/2021
1.1.0 421 4/22/2021
1.0.3 385 4/1/2021
1.0.2 391 4/1/2021
1.0.1 363 4/1/2021
1.0.0 345 3/31/2021