Tutorial

Goal: In this exercise, the participants will be asked to build the backend of a TodoReact App. The user will be exploring the functionality of FeatherHttp, a server-side framework.

What is FeatherHttp: FeatherHttp makes it easy to write web applications.

Why FeatherHttp: FeatherHttp is lightweight server-side framework designed to scale-up as your application grows in complexity.

Prerequisites

1. Install .NET Core 5.0
2. Install Node.js

Setup

1. Install the FeatherHttp template using the dotnet CLI. Copy the command below into a terminal or command prompt to install the template.

   dotnet new -i FeatherHttp.Templates::0.1.67-alpha.g69b43bed72 --nuget-source https://f.feedz.io/featherhttp/framework/nuget/index.json
   

   This will make the FeatherHttp templates available in the dotnet new command (more below).

2. Download this repository. Unzip it, and navigate to the Tutorial folder, this consists of the frontend application TodoReact app.

   If using Visual Studio Code, install the C# extension for C# support.

Task: Build the backend portion using FeatherHttp

Tasks

Please Note: The completed exercise is available in the samples folder. Feel free to reference it at any point during the tutorial.

Run the frontend application

1. Once you clone the Todo repo, navigate to the TodoReact folder inside of the Tutorial folder and run the following commands

TodoReact> npm i 
TodoReact> npm start

• The commands above
  • Restores packages npm i
  • Starts the react app npm start

1. The app will load but have no functionality

   Keep this React app running as we'll need it once we build the back-end in the upcoming steps

Build backend - FeatherHttp

Create a new project

1. Create a new FeatherHttp application and add the necessary packages in the TodoApi folder

Tutorial>dotnet new feather -n TodoApi
Tutorial> cd TodoApi
TodoApi> dotnet add package Microsoft.EntityFrameworkCore.InMemory

• The commands above
  • create a new FeatherHttp application dotnet new feather -n TodoApi
  • Adds the NuGet packages required in the next section dotnet add package Microsoft.EntityFrameworkCore.InMemory --version 5.0.0-preview.7.20365.15

2. Open the TodoApi Folder in editor of your choice.

Create the database model

1. Create a file called TodoItem.cs in the TodoApi folder. Add the content below:

   using System.Text.Json.Serialization;
   
    public class TodoItem
    {
        [JsonPropertyName("id")]
        public int Id { get; set; }
   
        [JsonPropertyName("name")]
        public string Name { get; set; }
   
        [JsonPropertyName("isComplete")]
        public bool IsComplete { get; set; }
    }
   

   The above model will be used for reading in JSON and storing todo items into the database.

2. Create a file called TodoDbContext.cs with the following contents:

   using Microsoft.EntityFrameworkCore;
   
   public class TodoDbContext : DbContext
   {
       public DbSet<TodoItem> Todos { get; set; }
       
       protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
       {
           optionsBuilder.UseInMemoryDatabase("Todos");
       }
   }
   

   This code does 2 things:

   • It exposes a Todos property which represents the list of todo items in the database.
   • The call to UseInMemoryDatabase wires up the in memory database storage. Data will only be persisted as long as the application is running.

3. Now we're going to use dotnet watch to run the server side application:

   dotnet watch run
   

   This will watch our application for source code changes and will restart the process as a result.

Expose the list of todo items

1. Add the appropriate usings to the top of the Program.cs file.

   using System.Threading.Tasks;
   using Microsoft.AspNetCore.Builder;
   using Microsoft.AspNetCore.Http;
   using Microsoft.EntityFrameworkCore;
   

   This will import the required namespaces so that the application compiles successfully.

2. In Program.cs, create a method called GetTodos inside of the Program class:

   static async Task GetTodos(HttpContext http)
   {
       using var db = new TodoDbContext();
       var todos = await db.Todos.ToListAsync();
   
       await http.Response.WriteJsonAsync(todos);
   }
   

   This method gets the list of todo items from the database and writes a JSON representation to the HTTP response.

3. Wire up GetTodos to the api/todos route by modifying the code in Main to the following:

   static async Task Main(string[] args)
   {
       var app = WebApplication.Create(args);
   
       app.MapGet("/api/todos", GetTodos);
   
       await app.RunAsync();
   }
   

4. Navigate to the URL http://localhost:5000/api/todos in the browser. It should return an empty JSON array.

   

Adding a new todo item

1. In Program.cs, create another method called CreateTodo inside of the Program class:

   static async Task CreateTodo(HttpContext http)
   {
       var todo = await http.Request.ReadJsonAsync<TodoItem>();
   
       using var db = new TodoDbContext();
       await db.Todos.AddAsync(todo);
       await db.SaveChangesAsync();
   
       http.Response.StatusCode = 204;
   }
   

   The above method reads the TodoItem from the incoming HTTP request and as a JSON payload and adds it to the database.

2. Wire up CreateTodo to the api/todos route by modifying the code in Main to the following:

   static async Task Main(string[] args)
   {
       var app = WebApplication.Create(args);
   
       app.MapGet("/api/todos", GetTodos);
       app.MapPost("/api/todos", CreateTodo);
   
       await app.RunAsync();
   }
   

3. Navigate to the TodoReact application which should be running on http://localhost:3000. The application should be able to add new todo items. Also, refreshing the page should show the stored todo items.

Changing the state of todo items

1. In Program.cs, create another method called UpdateCompleted inside of the Program class:

   static async Task UpdateCompleted(HttpContext http)
   {
       if (!http.Request.RouteValues.TryGet("id", out int id))
       {
           http.Response.StatusCode = 400;
           return;
       }
   
       using var db = new TodoDbContext();
       var todo = await db.Todos.FindAsync(id);
   
       if (todo == null)
       {
           http.Response.StatusCode = 404;
           return;
       }
   
       var inputTodo = await http.Request.ReadJsonAsync<TodoItem>();
       todo.IsComplete = inputTodo.IsComplete;
   
       await db.SaveChangesAsync();
   
       http.Response.StatusCode = 204;
   }
   

   The above logic retrieves the id from the route parameter "id" and uses it to find the todo item in the database. It then reads the JSON payload from the incoming request, sets the IsComplete property and updates the todo item in the database.

2. Wire up UpdateCompleted to the api/todos/{id} route by modifying the code in Main to the following:

   static async Task Main(string[] args)
   {
       var app = WebApplication.Create(args);
   
       app.MapGet("/api/todos", GetTodos);
       app.MapPost("/api/todos", CreateTodo);
       app.MapPost("/api/todos/{id}", UpdateCompleted);
   
       await app.RunAsync();
   }
   

Deleting a todo item

1. In Program.cs create another method called DeleteTodo inside of the Program class:

   static async Task DeleteTodo(HttpContext http)
   {
       if (!http.Request.RouteValues.TryGet("id", out int id))
       {
           http.Response.StatusCode = 400;
           return;
       }
   
       using var db = new TodoDbContext();
       var todo = await db.Todos.FindAsync(id);
       if (todo == null)
       {
           http.Response.StatusCode = 404;
           return;
       }
   
       db.Todos.Remove(todo);
       await db.SaveChangesAsync();
   
       http.Response.StatusCode = 204;
   }
   

   The above logic is very similar to UpdateCompleted but instead. it removes the todo item from the database after finding it.

2. Wire up DeleteTodo to the api/todos/{id} route by modifying the code in Main to the following:

   static async Task Main(string[] args)
   {
       var app = WebApplication.Create(args);
   
       app.MapGet("/api/todos", GetTodos);
       app.MapPost("/api/todos", CreateTodo);
       app.MapPost("/api/todos/{id}", UpdateCompleted);
       app.MapDelete("/api/todos/{id}", DeleteTodo);
   
       await app.RunAsync();
   }
   

Test the application

The application should now be fully functional.