This template contains:
- An attempt to write a clean and maintainable RESTful API.
- Microsoft SQL Server database provider for Entity Framework Core (feel free to change provider as needed).
- AutoMapper as a library to map our domain classes to the presentation layer.
- Swagger to design and document your API.
- A RabbitMQ optional implementation
- The options are commented in 'Startup.cs', feel free to uncomment if you need it (or remove it in another way).
- Visit RabbitMQ for more information.
- Some little things that help me and my colleagues on a daily basis.
Suggestions for improvements are always welcome!
For now, to install these templates you will need to do the following:
git clone https://github.com/maxicandelero/webapi-m-sqlserver.git {LocalTempPath}
dotnet new -i {LocalTempPath}
To confirm the templates are installed correctly, type dotnet new -l
, you should see it in the list of available projects.
You can use the following command to create a new project with the name My.API
in it's own directory.
dotnet new webapi-m-sqlserver --ProjectName My.API
The --ProjectName
argument is required.
To continue you must execute dotnet restore
and configure your ConnectionStrings
, set the Default
property in the appsettings.json
file.
Then you will need to generate the database (or not), remember your database must be SQL Server, but you can change the provider if you want.
Because you installed the template by using a file path, you must uninstall it with the absolute file path. You can see a list of templates installed by running the dotnet new -u
command. Your template should be listed last. Use the path listed to uninstall your template with the dotnet new -u <ABSOLUTE PATH TO TEMPLATE DIRECTORY>
command.