Updated first-web-api tutorial

aspnetcore/tutorials/first-web-api/samples/9.0/TodoApi/Controllers/TodoItemsController.cs

@@ -1,12 +1,19 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.EntityFrameworkCore;
 using TodoApi.Models;
 
 namespace TodoApi.Controllers
 {
+    // <snippet_Route>
     [Route("api/[controller]")]
     [ApiController]
     public class TodoItemsController : ControllerBase
+    // </snippet_Route>
     {
         private readonly TodoContext _context;
 
@@ -40,7 +47,7 @@ public async Task<ActionResult<TodoItem>> GetTodoItem(long id)
 
         // PUT: api/TodoItems/5
         // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754
-        // <snippet_Update>
+        // <snippet_PutTodoItem>
         [HttpPut("{id}")]
         public async Task<IActionResult> PutTodoItem(long id, TodoItem todoItem)
         {
@@ -69,7 +76,7 @@ public async Task<IActionResult> PutTodoItem(long id, TodoItem todoItem)
 
             return NoContent();
         }
-        // </snippet_Update>
+        // </snippet_PutTodoItem>
 
         // POST: api/TodoItems
         // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754
@@ -86,6 +93,7 @@ public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem todoItem)
         // </snippet_Create>
 
         // DELETE: api/TodoItems/5
+        // <snippet_Delete>
         [HttpDelete("{id}")]
         public async Task<IActionResult> DeleteTodoItem(long id)
         {
@@ -100,6 +108,7 @@ public async Task<IActionResult> DeleteTodoItem(long id)
 
             return NoContent();
         }
+        // </snippet_Delete>
 
         private bool TodoItemExists(long id)
         {

aspnetcore/tutorials/first-web-api/samples/9.0/TodoApi/Models/TodoContext.cs

@@ -1,4 +1,4 @@
-using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore;
 
 namespace TodoApi.Models;
 
@@ -10,4 +10,4 @@ public TodoContext(DbContextOptions<TodoContext> options)
     }
 
     public DbSet<TodoItem> TodoItems { get; set; } = null!;
-}
+}

aspnetcore/tutorials/first-web-api/samples/9.0/TodoApi/Models/TodoItem.cs

@@ -1,8 +1,8 @@
-namespace TodoApi.Models;
+namespace TodoApi.Models;
 
 public class TodoItem
 {
     public long Id { get; set; }
     public string? Name { get; set; }
     public bool IsComplete { get; set; }
-}
+}

aspnetcore/tutorials/first-web-api/samples/9.0/TodoApi/Program.cs

@@ -1,20 +1,64 @@
+#define Final_Add_DBContext // First_Add_SwaggerUI
+#if First_Add_SwaggerUI
+// <snippet_First_Add_SwaggerUI>
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+
+builder.Services.AddControllers();
+// Learn more about configuring OpenAPI at https://aka.ms/aspnet/openapi
+builder.Services.AddOpenApi();
+
+var app = builder.Build();
+
+// Configure the HTTP request pipeline.
+if (app.Environment.IsDevelopment())
+{
+    app.MapOpenApi();
+
+    app.UseSwaggerUI(options =>
+    {
+        options.SwaggerEndpoint("/openapi/v1.json", "v1");
+    });
+}
+
+app.UseHttpsRedirection();
+
+app.UseAuthorization();
+
+app.MapControllers();
+
+app.Run();
+// </snippet_First_Add_SwaggerUI>
+#endif
+
+#if Final_Add_DBContext
+// <snippet_Final_Add_DBContext>
 using Microsoft.EntityFrameworkCore;
 using TodoApi.Models;
 
 var builder = WebApplication.CreateBuilder(args);
 
+// Add services to the container.
+
 builder.Services.AddControllers();
 builder.Services.AddDbContext<TodoContext>(opt =>
     opt.UseInMemoryDatabase("TodoList"));
-builder.Services.AddEndpointsApiExplorer();
-builder.Services.AddSwaggerGen();
+
+// Learn more about configuring OpenAPI at https://aka.ms/aspnet/openapi
+builder.Services.AddOpenApi();
 
 var app = builder.Build();
 
+// Configure the HTTP request pipeline.
 if (app.Environment.IsDevelopment())
 {
-    app.UseSwagger();
-    app.UseSwaggerUI();
+    app.MapOpenApi();
+
+    app.UseSwaggerUI(options =>
+    {
+        options.SwaggerEndpoint("/openapi/v1.json", "v1");
+    });
 }
 
 app.UseHttpsRedirection();
@@ -24,3 +68,5 @@
 app.MapControllers();
 
 app.Run();
+// </snippet_Final_Add_DBContext>
+#endif

aspnetcore/tutorials/first-web-api/samples/9.0/TodoApi/TodoApi.csproj

@@ -1,22 +1,20 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>net7.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>
 
   <ItemGroup>
-
-    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="7.0.0-rc.2.22476.2" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="7.0.0-rc.2.22472.11" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="7.0.0-rc.2.22472.11" />
-    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="7.0.0-rc.2.22472.11">
+    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.1" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.InMemory" Version="9.0.2" />
+    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="9.0.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="7.0.0-rc.2.22510.1" />
-    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />
+    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="9.0.0" />
+    <PackageReference Include="Swashbuckle.AspNetCore.SwaggerUI" Version="7.2.0" />
   </ItemGroup>
 
 </Project>

aspnetcore/tutorials/first-web-api/samples/9.0/TodoApi/WeatherForecast.cs

@@ -10,4 +10,4 @@ public class WeatherForecast
 
         public string? Summary { get; set; }
     }
-}
+}