Merge pull request #3 from csharpfritz/feature_Update31

Feature update31

Author: csharpfritz

docs/1. Create BackEnd API project.md

@@ -8,9 +8,9 @@
    > ***Note:* If not using Visual Studio, create the project using `dotnet new webapi` at the cmd line, details as follows:**
    > 1. Create folder ConferencePlanner and call `dotnet new sln` at the cmd line to create a solution
    > 2. Create sub-folder BackEnd and create a project using `dotnet new webapi` at the cmd line inside the folder BackEnd
-   > 3. Add the project to the solution using `dotnet sln add BackEnd/BackEnd.csproj`
-1. Add a new `Models` folder to the root of the application.
-1. Add a new `Speaker` class using the following code:
+   > 3. From the ConferencePlanner folder, add the project to the solution using `dotnet sln add BackEnd/BackEnd.csproj`
+1. Add a new `Models` folder to the BackEnd project.
+1. Add a new `Speaker` class inside the Models folder using the following code:
     ```csharp
     using System;
     using System.Collections.Generic;
@@ -36,10 +36,10 @@
         }
     }
     ```
-1. Add a reference to the NuGet package `Microsoft.EntityFrameworkCore.SqlServer` version `3.0.0`.
-    > This can be done from the command line using `dotnet add package Microsoft.EntityFrameworkCore.SqlServer --version 3.0.0`
-1. Add a reference to the NuGet package `Microsoft.EntityFrameworkCore.Sqlite` version `3.0.0`.
-    > This can be done from the command line using `dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 3.0.0`
+1. Add a reference in the BackEnd project to the NuGet package `Microsoft.EntityFrameworkCore.SqlServer` version `3.1.3`.
+    > This can be done from the command line in the `BackEnd` folder using `dotnet add package Microsoft.EntityFrameworkCore.SqlServer --version 3.1.3`
+1. Add a reference in the BackEnd project to the NuGet package `Microsoft.EntityFrameworkCore.Sqlite` version `3.1.3`.
+    > This can be done from the command line in the `BackEnd` folder using `dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 3.1.3`
 1. Next we'll create a new Entity Framework DbContext. Create a new `ApplicationDbContext` class in the `Models` folder using the following code:
     ```csharp
     using Microsoft.EntityFrameworkCore;
@@ -59,7 +59,7 @@
     }
 
     ```
-1. Add a connection string to the appsettings.json file for this database:
+1. Add a connection string to the `appsettings.json` file for this database:
 
     ```json
    {
@@ -93,11 +93,17 @@
     });
     ```
     > This code registers the `ApplicationDbContext` service so it can be injected into controllers. Additionally, it configures operating system specific database technologies and connection strings
+1. Ensure the following 'using' statements are at the top of the `Startup.cs` file to allow the references in our code to work:
+    ```csharp
+    using BackEnd.Models;
+    using System.Runtime.InteropServices;
+    using Microsoft.EntityFrameworkCore;
+    ``` 
 
 ## Configuring EF Migrations
 
-1. Add a reference to the NuGet package `Microsoft.EntityFrameworkCore.Tools` version `3.0.0`.
-    > **If you're not using Visual Studio** install the package from the command line with `dotnet add package Microsoft.EntityFrameworkCore.Tools --version 3.0.0`
+1. Add a reference to the NuGet package `Microsoft.EntityFrameworkCore.Tools` version `3.1.3`.
+    > **If you're not using Visual Studio** install the package from the command line in the `BackEnd` folder with `dotnet add package Microsoft.EntityFrameworkCore.Tools --version 3.1.3`
 
 ### Visual Studio: Package Manager Console 
 
@@ -111,9 +117,9 @@
 
 ### Command line
 
-1. Install the EntityFramework global tool `dotnet-ef` using the following command:
+1. Install the EntityFramework global tool `dotnet-ef` using the following command in the `BackEnd` folder:
    ```console
-   dotnet tool install -g dotnet-ef --version 3.0.0
+   dotnet tool install -g dotnet-ef --version 3.1.3
    ```
 
 1. Open a command prompt and navigate to the project directory. (The directory containing the `Startup.cs` file).
@@ -147,12 +153,12 @@ First, open the `Controllers` folder and take a quick look at the `WeatherForeca
 ### Using the cmd line
 1. Install the "Microsoft.VisualStudio.Web.CodeGeneration.Design" package
     ```console
-    dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.0.0
+    dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.1.2
     ```
 
 1. Install the `aspnet-codegenerator` global tool by running the following command:
     ```console
-    dotnet tool install -g dotnet-aspnet-codegenerator --version 3.0.0
+    dotnet tool install -g dotnet-aspnet-codegenerator --version 3.1.2
     ```
 
 > Note: You will need to close and reopen the console window to be able to use this tool.
@@ -171,8 +177,8 @@ In this section, we'll be adding documentation to our API using the Swashbuckle
 
 Additional information on using Swashbuckle in ASP.NET Core is available in this tutorial: [ASP.NET Web API Help Pages using Swagger](https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger)
 
-1. Add a reference to the NuGet package `Swashbuckle.AspNetCore` version `5.0.0-rc4`.
-    > This can be done from the command line using `dotnet add package Swashbuckle.AspNetCore --version 5.0.0-rc4`
+1. Add a reference to the NuGet package `Swashbuckle.AspNetCore` version `5.3.0`.
+    > This can be done from the command line using `dotnet add package Swashbuckle.AspNetCore --version 5.3.0`
 
 1. Add the Swashbuckle services in your `ConfigureServices` method:
     ```csharp
@@ -182,6 +188,14 @@ Additional information on using Swashbuckle in ASP.NET Core is available in this
         options.SwaggerDoc("v1", new OpenApiInfo { Title = "Conference Planner API", Version = "v1" })
     );
     ```
+
+1. Ensure your Startup.cs file contains the following 'using' statements:
+    ```csharp
+    using Microsoft.OpenApi.Models;
+    using System.Threading.Tasks;
+    ```
+
+
 1. Configure Swashbuckle by adding the following lines just before `UseRouting` in the `Configure` method in `Startup.cs`:
     ```csharp
     app.UseSwagger();
@@ -190,17 +204,18 @@ Additional information on using Swashbuckle in ASP.NET Core is available in this
         options.SwaggerEndpoint("/swagger/v1/swagger.json", "Conference Planner API v1")
     );
     ```
-    > ***Note:* Due to how the middleware and pipeline are structured, you'll want to place this before the `app.UseEndpoints()` statement.**
-1. Add a redirect to the end of the pipeline that redirects to the swagger end point. 
+1. Add a MapGet to the beginning of the `UseEndpoints` statement in the pipeline that redirects requests from the root of our application to the swagger end point. 
    ```csharp
-   app.Run(context =>
-   {
-       context.Response.Redirect("/swagger");
-       return Task.CompletedTask;
-   });
-   ```
-   
-   > ***Note:* You'll need to place this after the `app.UseMvc()` statement.**
+    app.UseEndpoints(endpoints =>
+    {
+        endpoints.MapGet("/", context => { 
+            context.Response.Redirect("/swagger/");
+            return Task.CompletedTask;
+        });
+        endpoints.MapControllers();
+    });
+    ```
+
 1. Run the application (F5 in Visual Studio or `dotnet run` from console).
 1. Browse to the Swagger UI at `http://localhost:<random_port>/swagger`.
     ![](images/swagger-speakers.png)
@@ -210,9 +225,9 @@ Additional information on using Swashbuckle in ASP.NET Core is available in this
     ![](images/swagger-create-speaker.png)
     ```json
     {
-      "name": "Tyrion Lannister",
-      "bio": "Drinks and knows things",
-      "webSite": "http://giphy.com/search/tyrion-lannister"
+      "name": "Dorothy Gale",
+      "bio": "Amateur meteorologist, Oz aficionado, and lead guide for Whirlwind Tours of Kansas",
+      "webSite": "https://en.wikipedia.org/wiki/Dorothy_Gale"
     }
     ```
 1. When you click the *Try it out!* button, you should see a success response from the server. Now, clicking the *GET* button above should show your newly added speaker.

docs/2. Build out BackEnd and Refactor.md

@@ -31,8 +31,8 @@ In this session, we'll add the rest of our models and controllers that expose th
 ## Refactoring the Speaker model into the ConferenceDTO project
 1. Copy the `Speaker.cs` class from the *BackEnd* application into the root of the new ConferenceDTO project, and change the namespace to `ConferenceDTO`.
 1. The data annotations references should be broken at this point, to resovle it, we need to add a nuget the missing NuGet package into the `ConferenceDTO` project.
-1. Add a reference to the NuGet package `System.ComponentModel.Annotations` version `4.6.0`.
-    > This can be done from the command line using `dotnet add package System.ComponentModel.Annotations --version 4.6.0`
+1. Add a reference to the NuGet package `System.ComponentModel.Annotations` version `4.7.0`.
+    > This can be done from the command line using `dotnet add package System.ComponentModel.Annotations --version 4.7.0`
 
 1. When the package restore completes, you should see that your data annotations are now resolved.
 1. Go back to the *BackEnd* application and modify the code in `Speaker.cs` as shown:

docs/4. Add auth features.md

@@ -18,9 +18,9 @@ In this module we're going to add the capability for users to register and sign-
    ```
    dotnet tool install -g dotnet-aspnet-codegenerator
    ```
-1. Add the `Microsoft.VisualStudio.Web.CodeGeneration.Design` version `3.0.0` package to the project.
+1. Add the `Microsoft.VisualStudio.Web.CodeGeneration.Design` version `3.1.2` package to the project.
    ```
-   dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.0.0
+   dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.1.2
    ```
 1. Run this command to generate the code to use Identity.
    ```

docs/6. Production Readiness and Deployment.md

@@ -1,8 +1,8 @@
 # Production Readiness and Deployment
 
 ## Adding EF Healthchecks to the BackEnd
-1. Add a reference to the NuGet package `Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore` version `3.0.0`.
-    > This can be done from the command line using `dotnet add package Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore --version 3.0.0`
+1. Add a reference to the NuGet package `Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore` version `3.1.3`.
+    > This can be done from the command line using `dotnet add package Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore --version 3.1.3`
 1. Add a DbContext health check in `Startup.cs` by adding the following code to `ConfigureServices`:
    ```csharp
    services.AddHealthChecks()
@@ -13,7 +13,7 @@
 
 ## Adding EF Healthchecks to the FrontEnd
 1. Add a reference to the NuGet package `Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore` version `3.0.0`.
-    > This can be done from the command line using `dotnet add package Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore --version 3.0.0`
+    > This can be done from the command line using `dotnet add package Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore --version 3.1.3`
 
     > Note: The `FrontEnd` and `BackEnd` projects have different versions of this package because they reference different versions of EntityFrameworkCore.
 1. Add a DbContext health check in `Startup.cs` by adding the following code to `ConfigureServices`:

save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/BackEnd.csproj

@@ -1,21 +1,19 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.0.0" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="3.0.0" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.0.0">
-      <PrivateAssets>all</PrivateAssets>
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="3.1.3" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.1.3" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.1.3">
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
-    </PackageReference>
-    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="3.0.0">
       <PrivateAssets>all</PrivateAssets>
-      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Swashbuckle.AspNetCore" Version="5.0.0-rc4" />
+    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="3.1.2" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="5.3.0" />
   </ItemGroup>
 
+
 </Project>

save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Controllers/SpeakersController.cs

@@ -1,4 +1,4 @@
-using System.Collections.Generic;
+using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;
 using Microsoft.AspNetCore.Mvc;
@@ -7,7 +7,7 @@
 
 namespace BackEnd.Controllers
 {
-    [Route("api/[controller]")]
+  [Route("api/[controller]")]
     [ApiController]
     public class SpeakersController : ControllerBase
     {
@@ -40,6 +40,8 @@ public async Task<ActionResult<Speaker>> GetSpeaker(int id)
         }
 
         // PUT: api/Speakers/5
+        // To protect from overposting attacks, please enable the specific properties you want to bind to, for
+        // more details see https://aka.ms/RazorPagesCRUD.
         [HttpPut("{id}")]
         public async Task<IActionResult> PutSpeaker(int id, Speaker speaker)
         {
@@ -70,6 +72,8 @@ public async Task<IActionResult> PutSpeaker(int id, Speaker speaker)
         }
 
         // POST: api/Speakers
+        // To protect from overposting attacks, please enable the specific properties you want to bind to, for
+        // more details see https://aka.ms/RazorPagesCRUD.
         [HttpPost]
         public async Task<ActionResult<Speaker>> PostSpeaker(Speaker speaker)
         {

save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Controllers/WeatherForecastController.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Logging;
+
+namespace BackEnd.Controllers
+{
+    [ApiController]
+    [Route("[controller]")]
+    public class WeatherForecastController : ControllerBase
+    {
+        private static readonly string[] Summaries = new[]
+        {
+            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
+        };
+
+        private readonly ILogger<WeatherForecastController> _logger;
+
+        public WeatherForecastController(ILogger<WeatherForecastController> logger)
+        {
+            _logger = logger;
+        }
+
+        [HttpGet]
+        public IEnumerable<WeatherForecast> Get()
+        {
+            var rng = new Random();
+            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
+            {
+                Date = DateTime.Now.AddDays(index),
+                TemperatureC = rng.Next(-20, 55),
+                Summary = Summaries[rng.Next(Summaries.Length)]
+            })
+            .ToArray();
+        }
+    }
+}

save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Migrations/20190614215301_Initial.Designer.cs renamed to save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Migrations/20191230162921_Initial.Designer.cs

@@ -1,5 +1,4 @@
-using Microsoft.EntityFrameworkCore.Metadata;
-using Microsoft.EntityFrameworkCore.Migrations;
+using Microsoft.EntityFrameworkCore.Migrations;
 
 namespace BackEnd.Migrations
 {
@@ -12,7 +11,7 @@ protected override void Up(MigrationBuilder migrationBuilder)
                 columns: table => new
                 {
                     Id = table.Column<int>(nullable: false)
-                        .Annotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn),
+                        .Annotation("SqlServer:Identity", "1, 1"),
                     Name = table.Column<string>(maxLength: 200, nullable: false),
                     Bio = table.Column<string>(maxLength: 4000, nullable: true),
                     WebSite = table.Column<string>(maxLength: 1000, nullable: true)

save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Migrations/20190614215301_Initial.cs renamed to save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Migrations/20191230162921_Initial.cs

@@ -14,24 +14,28 @@ protected override void BuildModel(ModelBuilder modelBuilder)
         {
 #pragma warning disable 612, 618
             modelBuilder
-                .HasAnnotation("ProductVersion", "3.0.0")
+                .HasAnnotation("ProductVersion", "3.1.0")
                 .HasAnnotation("Relational:MaxIdentifierLength", 128)
                 .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
 
             modelBuilder.Entity("BackEnd.Models.Speaker", b =>
                 {
                     b.Property<int>("Id")
                         .ValueGeneratedOnAdd()
+                        .HasColumnType("int")
                         .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);
 
                     b.Property<string>("Bio")
+                        .HasColumnType("nvarchar(4000)")
                         .HasMaxLength(4000);
 
                     b.Property<string>("Name")
                         .IsRequired()
+                        .HasColumnType("nvarchar(200)")
                         .HasMaxLength(200);
 
                     b.Property<string>("WebSite")
+                        .HasColumnType("nvarchar(1000)")
                         .HasMaxLength(1000);
 
                     b.HasKey("Id");

save-points/1-Create-API-and-EF-Model/ConferencePlanner/BackEnd/Migrations/ApplicationDbContextModelSnapshot.cs

@@ -1,4 +1,4 @@
-using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore;
 
 namespace BackEnd.Models
 {