DotNetBrightener.WebApi.GenericCRUD.Generator 2024.0.1-alpha-1

This is a prerelease version of DotNetBrightener.WebApi.GenericCRUD.Generator.
There is a newer version of this package available.
See the version list below for details.
dotnet add package DotNetBrightener.WebApi.GenericCRUD.Generator --version 2024.0.1-alpha-1
                    
NuGet\Install-Package DotNetBrightener.WebApi.GenericCRUD.Generator -Version 2024.0.1-alpha-1
                    
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="DotNetBrightener.WebApi.GenericCRUD.Generator" Version="2024.0.1-alpha-1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="DotNetBrightener.WebApi.GenericCRUD.Generator" Version="2024.0.1-alpha-1" />
                    
Directory.Packages.props
<PackageReference Include="DotNetBrightener.WebApi.GenericCRUD.Generator" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add DotNetBrightener.WebApi.GenericCRUD.Generator --version 2024.0.1-alpha-1
                    
#r "nuget: DotNetBrightener.WebApi.GenericCRUD.Generator, 2024.0.1-alpha-1"
                    
#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.
#:package DotNetBrightener.WebApi.GenericCRUD.Generator@2024.0.1-alpha-1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=DotNetBrightener.WebApi.GenericCRUD.Generator&version=2024.0.1-alpha-1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=DotNetBrightener.WebApi.GenericCRUD.Generator&version=2024.0.1-alpha-1&prerelease
                    
Install as a Cake Tool

Code Generator for Centralized CRUD WebAPI in ASP.NET Core Applications

© 2024 DotNet Brightener

Getting Started

Create new project

You can create the project in Visual Studio for your convenience. You can put everything into one single WebAPI project, but it's recommended not to do that, instead, you should separate the project into different libraries. The suggestion is as the following table

Project Name Project Type Purpose
{YourProject}.WebAPI WebAPI The entry point of the application
{YourProject}.Core or {YourProject}.Entities Class Library The library that contains only the entities needed for your application
{YourProject}.Services Class Library The library that contains business logics and CRUD auto generated classes
{YourProject}.Database Class Library The library that holds the database context to communicate with the database

If you like CLI, you can follow the instruction below.

  1. Create a new .NET 8 WebAPI project:
dotnet new webapi -n {your-project-name} -f net8.0
dotnet new classlib -n {your-project-name}.Database -f net8.0
dotnet new sln --name {your-project-name}
dotnet sln {your-project-name}.sln add {your-project-name}\\{your-project-name}.csproj
dotnet sln {your-project-name}.sln add {your-project-name}.Database\\{your-project-name}.Database.csproj
  1. If needed to separate the entity definitions to a different library, create new class library project
dotnet new classlib -n {your-project-name}.Core -f net8.0
dotnet sln {your-project-name}.sln add {your-project-name}.Core\\{your-project-name}.Core.csproj
  1. If needed to separate the service layer, create new class library project
dotnet new classlib -n {your-project-name}.Services -f net8.0
dotnet sln {your-project-name}.sln add {your-project-name}.Services\\{your-project-name}.Services.csproj

Now you can open the solution in Visual Studio.

Add Generic CRUD and its Generator Library

1. Add CRUD libraries

Add the following packages to the projects, following the instruction below

| Package Name | Project | | -- | -- | | DotNetBrightener.WebApi.GenericCRUD | Web API | | DotNetBrightener.WebApi.GenericCRUD.Generator | Web API, Service |
| DotNetBrightener.DataAccess.Abstractions | Core (Entity) | | DotNetBrightener.DataAccess.EF | Database |

2. Update the settings to enable code generator

Open the csproj files and update the <PackageReference> of the Generator library with the following

<ItemGroup>
	<PackageReference Include="DotNetBrightener.WebApi.GenericCRUD.Generator"
					  Version="{current-version-of-the-library}"
					  OutputItemType="Analyzer"
					  ReferenceOutputAssembly="false" />
</ItemGroup>

The change is to add

	OutputItemType="Analyzer"
	ReferenceOutputAssembly="false"

to the XML tag, that enables the auto generate code for the projects.

Create first entity

The entities must inherit from BaseEntity or BaseEntityWithAuditInfo from the DotNetBrightener.DataAccess.Abstractions library. Create any entity into the Core or Entity project.

Example:

using DotNetBrightener.DataAccess.Models;
 
namespace CRUDWebApiWithGeneratorDemo.Core.Entities;

public class Product: BaseEntity
{
	[MaxLength(255)]
    public string Name { get; set; }

	// omitted code
}

The Entity/Core project should only contain the entities without any other logics

Configure Code Generator for Service Project

At the root of Service project, create a class CRUDDataServiceGeneratorRegistration.cs with the following content

using CRUDWebApiWithGeneratorDemo.Core.Entities;
 
namespace CRUDWebApiWithGeneratorDemo.Services;
 
public class CRUDDataServiceGeneratorRegistration
{
    public List<Type> Entities =
    [
		// provide all entities that need to generate CRUD data service for
        typeof(Product),
        typeof(ProductCategory)
    ];
}

The name CRUDDataServiceGeneratorRegistration is strictly required as the generator library will look for that file in order to understand what to generate.

In the Entities list in the class, provide all the entities that needed to generate the CRUD data service interfaces and classes.

Configure Code Generator for WebAPI Project

At the root of WebAPI project, create a class CRUDWebApiGeneratorRegistration.cs with the following content

public class CRUDWebApiGeneratorRegistration
{
	// reference the CRUDDataServiceGeneratorRegistration from Service project
    Type DataServiceRegistrationType = typeof(CRUDDataServiceGeneratorRegistration);
 
    public List<Type> Entities =
    [
		// provide all entities that need to generate CRUD API Controllers for
		// Some entities related to Authorization / Authentication / Security should be ignored
        typeof(Product),
        typeof(ProductCategory)
    ];
}

The name CRUDWebApiGeneratorRegistration is strictly required as the generator library will look for that file in order to understand what to generate.

In the Entities list in the class, provide all the entities that needed to generate the CRUD Web API Controllers for.

Build and Run Project

As you followed the instruction so far, upon building and running the project, the needed classes will be automatically generated. By default, .NET WebAPI project includes the OpenAPI library, which will detect the available APIs and you can see the following when the project is launch:

![[swagger_screenshot.png]]

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  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.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2025.0.6-preview-406 53 9/2/2025
2025.0.6-preview-401 47 9/2/2025
2025.0.6-preview-400 49 9/2/2025
2025.0.6-preview-369 178 8/27/2025
2025.0.6-preview-368 171 8/27/2025
2025.0.6-preview-334 156 8/18/2025
2025.0.6-preview-333 113 7/27/2025
2025.0.6-preview-332 445 7/24/2025
2025.0.6-preview-331 447 7/24/2025
2025.0.6-preview-328 447 7/24/2025
2025.0.6-preview-327 281 7/21/2025
2025.0.6-preview-326 280 7/21/2025
2025.0.6-preview-325 193 7/20/2025
2025.0.6-preview-324 190 7/20/2025
2025.0.6-preview-322 189 7/20/2025
2025.0.6-preview-321 189 7/19/2025
2025.0.6-preview-320 200 7/19/2025
2025.0.6-preview-319 119 7/17/2025
2025.0.6-preview-317 113 7/17/2025
2025.0.6-preview-316 115 7/17/2025
2025.0.6-preview-315 116 7/17/2025
2025.0.6-preview-314 129 7/17/2025
2025.0.6-preview-313 137 7/17/2025
2025.0.6-preview-312 143 7/16/2025
2025.0.5 150 7/10/2025
2025.0.5-preview-307 75 7/5/2025
2025.0.4 76 7/5/2025
2025.0.4-preview-305 85 7/4/2025
2025.0.4-preview-304 136 7/1/2025
2025.0.4-preview-299 119 5/31/2025
2025.0.4-preview-298 96 5/30/2025
2025.0.4-preview-296 142 5/30/2025
2025.0.4-preview-295 151 5/29/2025
2025.0.4-preview-293 145 5/26/2025
2025.0.4-preview-292 145 5/26/2025
2025.0.3 125 2/10/2025
2025.0.3-preview-288 116 2/10/2025
2025.0.2 117 1/21/2025
2025.0.2-preview-278 97 1/21/2025
2025.0.2-preview-277 114 12/16/2024
2025.0.1-rc-243301701 378 11/25/2024
2024.0.14.6 122 11/25/2024
2024.0.14.6-rc-243031001 194 10/29/2024
2024.0.14.6-rc-243030701 101 10/29/2024
2024.0.14.6-rc-242840501 111 10/10/2024
2024.0.14.6-rc-242820305 94 10/8/2024
2024.0.14.6-rc-242771401 192 10/3/2024
2024.0.14.6-rc-242770501 98 10/3/2024
2024.0.14.6-rc-242770201 111 10/3/2024
2024.0.14.6-rc-242761801 105 10/2/2024
2024.0.14.6-rc-242761601 112 10/2/2024
2024.0.14.6-rc-242761501 107 10/2/2024
2024.0.14.6-rc-242761401 108 10/2/2024
2024.0.14.6-rc-242760701 116 10/2/2024
2024.0.14.6-rc-242751002 103 10/1/2024
2024.0.14.6-rc-242750901 121 10/1/2024
2024.0.14.6-rc-242750502 102 10/1/2024
2024.0.14.6-rc-242750201 112 10/1/2024
2024.0.14.6-rc-242741501 94 9/30/2024
2024.0.14.6-rc-242730701 123 9/29/2024
2024.0.14.6-preview-2730501 110 9/29/2024
2024.0.14.6-preview-2701501 141 9/26/2024
2024.0.14.6-preview-2620901 144 9/18/2024
2024.0.14.6-preview-2570701 107 9/13/2024
2024.0.14.6-preview-2510703 170 9/7/2024
2024.0.14.6-preview-2480501 111 9/4/2024
2024.0.14.6-preview-2430401 149 8/30/2024
2024.0.14.6-preview-242730701 95 9/29/2024
2024.0.14.6-preview-2421703 116 8/29/2024
2024.0.14.6-preview-2421701 100 8/29/2024
2024.0.14.6-preview-2420901 104 8/29/2024
2024.0.14.6-preview-2390101 125 8/26/2024
2024.0.14.6-preview-2381603 132 8/25/2024
2024.0.14.6-preview-2341601 146 8/21/2024
2024.0.14.6-preview-2321602 135 8/20/2024
2024.0.14.6-preview-2190801 146 8/6/2024
2024.0.14.6-preview-2041501 92 7/22/2024
2024.0.14.6-preview-1920603 169 7/10/2024
2024.0.14.6-preview-1920301 123 7/10/2024
2024.0.14.6-preview-1911302 88 7/9/2024
2024.0.14.6-preview-1901001 136 7/8/2024
2024.0.14.6-preview-1900901 104 7/8/2024
2024.0.14.6-preview-1900801 124 7/8/2024
2024.0.14.6-preview-1860304 109 7/4/2024
2024.0.14.5 166 7/1/2024
2024.0.14.5-preview-1811601 125 6/29/2024
2024.0.14.5-preview-1810501 137 6/29/2024
2024.0.14.5-preview-180132 124 6/28/2024
2024.0.14.5-preview-180131 126 6/28/2024
2024.0.14.5-preview-180121 116 6/28/2024
2024.0.14.4 152 6/27/2024
2024.0.14.4-preview-7 119 6/27/2024
2024.0.14.3 119 6/21/2024
2024.0.14.1 137 6/6/2024
2024.0.14.1-preview 102 6/6/2024
2024.0.13.8-preview 119 6/6/2024
2024.0.13.1-preview-0146 113 6/6/2024
2024.0.12.15803-preview-03 124 6/6/2024
2024.0.12.15608 142 6/4/2024
2024.0.12.15515 184 6/3/2024
2024.0.12.15220 134 5/31/2024
2024.0.12.15220-alpha31-240... 106 5/31/2024
2024.0.12.14911 141 5/28/2024
2024.0.12.14910-alpha28-240... 116 5/28/2024
2024.0.12.14823 138 5/27/2024
2024.0.12.14522-alpha7-2405... 122 5/24/2024
2024.0.12.14514-alpha6-2405... 122 5/24/2024
2024.0.12.14511 149 5/24/2024
2024.0.12.14314 171 5/22/2024
2024.0.12.14114 173 5/20/2024
2024.0.12.12815 149 5/7/2024
2024.0.12.12814 155 5/7/2024
2024.0.12.12721 147 5/6/2024
2024.0.12.12702 148 5/5/2024
2024.0.12.12622 156 5/5/2024
2024.0.12.12514 159 5/4/2024
2024.0.12.12512 150 5/4/2024
2024.0.12.12510 161 5/4/2024
2024.0.12.12420 111 5/3/2024
2024.0.12.12319 105 5/2/2024
2024.0.12.12319-rc-2405021801 85 5/2/2024
2024.0.12.12318 102 5/2/2024
2024.0.12.12215 127 5/1/2024
2024.0.12.12011 139 4/29/2024
2024.0.12.11720 148 4/26/2024
2024.0.12.11719 146 4/26/2024
2024.0.12.11621 145 4/25/2024
2024.0.12.11523 151 4/24/2024
2024.0.12.11522 133 4/24/2024
2024.0.12.11417 149 4/23/2024
2024.0.12.11400 140 4/22/2024
2024.0.12.11316 140 4/22/2024
2024.0.11.10220 134 4/11/2024
2024.0.11.10120 130 4/10/2024
2024.0.11.10119 129 4/10/2024
2024.0.11.10115 125 4/10/2024
2024.0.11.9914 141 4/8/2024
2024.0.11.9901 145 4/7/2024
2024.0.11.9823 146 4/7/2024
2024.0.11.9401 136 4/2/2024
2024.0.11.9301 148 4/1/2024
2024.0.11.9206 131 3/31/2024
2024.0.11.9205 136 3/31/2024
2024.0.11.8200 155 3/21/2024
2024.0.11.8122 131 3/21/2024
2024.0.11.8120 154 3/21/2024
2024.0.11.7320 151 3/13/2024
2024.0.11.7316 150 3/13/2024
2024.0.11.7310 132 3/13/2024
2024.0.11 151 3/13/2024
2024.0.10 145 3/3/2024
2024.0.9 138 2/27/2024
2024.0.8 151 2/1/2024
2024.0.7 137 1/26/2024
2024.0.6 134 1/25/2024
2024.0.5 133 1/24/2024
2024.0.4 134 1/24/2024
2024.0.3 137 1/22/2024
2024.0.2 150 1/10/2024
2024.0.1 150 1/9/2024
2024.0.1-alpha-3 128 1/9/2024
2024.0.1-alpha-2 122 1/9/2024
2024.0.1-alpha-1 113 1/9/2024