RESTworld.Business
3.1.0
See the version list below for details.
dotnet add package RESTworld.Business --version 3.1.0
NuGet\Install-Package RESTworld.Business -Version 3.1.0
<PackageReference Include="RESTworld.Business" Version="3.1.0" />
paket add RESTworld.Business --version 3.1.0
#r "nuget: RESTworld.Business, 3.1.0"
// Install RESTworld.Business as a Cake Addin #addin nuget:?package=RESTworld.Business&version=3.1.0 // Install RESTworld.Business as a Cake Tool #tool nuget:?package=RESTworld.Business&version=3.1.0
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:
- Request
- Controller selection through ASP.Net Core (optionally with versioning)
- Query parsing through OData
- Controller method calls business service method
- Authorization validates and modifies the request (both optional)
- Service validates that all migrations have been applied to the database, to protect from locks during migration.
- Service gets the data through Entity Framework Core
- Entity Framework Core translates the query into SQL and gets the data from the database
- Business service translates Entities into DTOs through Automapper
- Authorization validates and modifies the response (both optional)
- Controller wraps the result in a HAL response
- 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 | Versions 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. |
-
net5.0
- AutoMapper (>= 10.1.1)
- EntityFrameworkCore.Parallel (>= 1.0.0)
- RESTworld.EntityFrameworkCore (>= 1.1.0)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on RESTworld.Business:
Package | Downloads |
---|---|
RESTworld.AspNetCore
Package Description |
|
RESTworld.Testing
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
17.0.0 | 65 | 9/20/2024 |
16.0.1 | 319 | 7/10/2024 |
16.0.0 | 88 | 7/3/2024 |
15.0.0 | 133 | 6/4/2024 |
14.1.1 | 679 | 1/9/2024 |
14.1.0 | 150 | 12/22/2023 |
14.0.0 | 389 | 11/15/2023 |
13.1.0 | 326 | 10/23/2023 |
13.0.0 | 307 | 9/27/2023 |
12.2.2 | 176 | 9/11/2023 |
12.2.1 | 432 | 7/17/2023 |
12.2.0 | 256 | 7/3/2023 |
12.1.3 | 198 | 6/28/2023 |
12.1.2 | 415 | 6/14/2023 |
12.1.1 | 380 | 5/25/2023 |
12.1.0 | 385 | 4/30/2023 |
12.0.1 | 248 | 4/19/2023 |
12.0.0 | 303 | 3/12/2023 |
11.1.1 | 615 | 2/22/2023 |
11.1.0 | 320 | 2/9/2023 |
11.0.0 | 518 | 1/24/2023 |
10.1.0 | 349 | 1/24/2023 |
10.0.1 | 664 | 12/21/2022 |
10.0.0 | 559 | 11/9/2022 |
9.1.0 | 812 | 10/20/2022 |
9.0.0 | 731 | 10/20/2022 |
8.7.0 | 872 | 9/27/2022 |
8.6.0 | 1,096 | 6/28/2022 |
8.5.0 | 1,220 | 6/23/2022 |
8.4.2 | 928 | 6/8/2022 |
8.4.1 | 1,254 | 5/13/2022 |
8.4.0 | 1,134 | 4/1/2022 |
8.3.0 | 848 | 3/30/2022 |
8.2.2 | 1,617 | 3/13/2022 |
8.2.1 | 1,195 | 3/9/2022 |
8.2.0 | 906 | 3/8/2022 |
8.1.1 | 1,737 | 2/22/2022 |
8.1.0 | 912 | 2/22/2022 |
8.0.0 | 879 | 2/21/2022 |
7.0.0 | 716 | 1/14/2022 |
6.0.1 | 413 | 1/6/2022 |
6.0.0 | 826 | 12/3/2021 |
5.1.0 | 3,053 | 11/25/2021 |
5.0.2 | 689 | 11/4/2021 |
5.0.1 | 652 | 11/4/2021 |
5.0.0 | 1,177 | 10/6/2021 |
4.2.0 | 537 | 9/29/2021 |
4.1.0 | 503 | 9/27/2021 |
4.0.1 | 589 | 9/8/2021 |
4.0.0 | 468 | 9/7/2021 |
3.1.0 | 421 | 8/18/2021 |
3.0.0 | 467 | 7/7/2021 |
2.0.0 | 594 | 6/29/2021 |
1.2.0 | 493 | 5/11/2021 |
1.1.0 | 518 | 4/22/2021 |
1.0.0 | 819 | 3/31/2021 |