This codebase was created because the other ASP.Net Core example API uses hard and verbose patterns (looking at you CQRS). And I couldn't get it working on a proper SQL database.
I haven't gone to great lengths to adhere to any kind of guideline other than not having grey text or squiggly lines in Visual Studio.
For more info head over to the RealWorld repo.
This is a basic ASP.Net core Api created by selecting File -> New Project and selecting all the obvious choices.
- For database we use Entity Framework Core with SQL Server.
- If you want it to work with something else it will probably take some work, but in the "real world" EF and SQL Server go together like PB and Jam.
- The models used are plain POCO models with code first and migrations. The models are only used for the database (not for API models) in order to avoid serialization gymnastics.
- For Authentication we rolled our own very simple yet probably solid authentication middleware. It doesn't use JWT because it's one more moving part and we're not using OAuth and OpenID Conenct anyway.
- The API uses the built in dependency injection instead of using something from the olden days when dinosaurs still roamed the earth.
- For serialization we made some custom converters because the RealWorld API spec wraps everything in an envelope.
- If you're using Windows, install Visual Studio.
- If you're using Linux or Mac, do Linux or Mac things until it works.
- Install the .NET Core SDK version at least 2.2.
- Load the file into VS and click run. Everything should go smoothly. It uses SQL LocalDb which is installed with VS by default.
No docker atm. Log a PR if you're feeling frisky.