RESTworld.AspNetCore 5.0.2

.NET 5.0 This package targets .NET 5.0. The package is compatible with this framework or higher.
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
27.0.0 32 11/20/2024
26.3.3 86 11/7/2024
26.3.2 45 11/6/2024
26.3.1 72 10/30/2024
26.3.0 52 10/30/2024
26.2.0 262 10/11/2024
26.1.2 129 10/1/2024
26.1.1 67 10/1/2024
26.1.0 80 9/27/2024
26.0.0 73 9/20/2024
25.2.0 264 7/30/2024
25.1.2 100 7/18/2024
25.1.1 61 7/12/2024
25.1.0 223 7/10/2024
25.0.0 76 7/3/2024
24.1.0 110 6/10/2024
24.0.0 96 6/4/2024
23.0.0 64 6/4/2024
22.2.0 666 1/9/2024
22.0.0 149 12/22/2023
21.1.0 338 11/27/2023
21.0.1 128 11/27/2023
21.0.0 184 11/15/2023
20.1.0 310 10/23/2023
20.0.0 309 9/27/2023
19.2.2 203 9/11/2023
19.2.1 413 7/17/2023
19.2.0 246 7/3/2023
19.1.0 163 6/29/2023
19.0.0 189 6/28/2023
18.1.0 435 6/14/2023
18.0.2 377 5/25/2023
18.0.1 233 5/16/2023
18.0.0 273 5/10/2023
17.1.1 213 5/2/2023
17.1.0 227 4/30/2023
17.0.0 237 4/19/2023
16.0.0 278 3/12/2023
15.1.1 583 2/22/2023
15.1.0 304 2/9/2023
15.0.0 459 1/24/2023
14.1.0 357 1/24/2023
14.0.2 494 1/5/2023
14.0.1 308 1/5/2023
14.0.0 411 12/21/2022
13.0.0 537 11/9/2022
12.1.0 637 10/20/2022
12.0.0 526 10/20/2022
11.10.0 641 9/27/2022
11.9.0 825 6/28/2022
11.8.0 683 6/27/2022
11.7.0 636 6/23/2022
11.6.1 663 6/8/2022
11.6.0 634 6/7/2022
11.5.1 725 5/13/2022
11.5.0 982 4/1/2022
11.4.0 708 3/30/2022
11.3.1 831 3/16/2022
11.3.0 762 3/15/2022
11.2.4 774 3/13/2022
11.2.3 733 3/10/2022
11.2.2 749 3/9/2022
11.2.1 740 3/8/2022
11.1.3 914 3/7/2022
11.1.2 776 2/24/2022
11.1.1 745 2/22/2022
11.1.0 732 2/22/2022
11.0.0 755 2/21/2022
10.0.0 633 1/14/2022
9.0.4 400 1/6/2022
9.0.3 445 12/16/2021
9.0.2 425 12/9/2021
9.0.1 461 12/9/2021
9.0.0 329 12/3/2021
8.2.0 3,011 11/25/2021
8.1.1 573 11/4/2021
8.1.0 589 11/4/2021
8.0.0 642 10/28/2021
7.0.1 424 10/12/2021
7.0.0 447 10/6/2021
6.0.1 478 10/6/2021
6.0.0 432 10/6/2021
5.2.0 471 9/29/2021
5.1.0 420 9/27/2021
5.0.2 424 9/13/2021
5.0.1 405 9/8/2021
5.0.0 452 9/7/2021
4.1.0 393 8/18/2021
4.0.0 430 7/7/2021
3.0.0 445 7/5/2021
2.0.0 460 6/29/2021
1.2.0 422 5/11/2021
1.1.0 447 4/22/2021
1.0.3 415 4/1/2021
1.0.2 425 4/1/2021
1.0.1 385 4/1/2021
1.0.0 374 3/31/2021