創建第一個 Minimal API 應用程序

要開始使用 Minimal API，可以創建一個新的 ASP.NET Core 項目，選擇“空”項目模板。創建完成后，項目中會包含一個 Program.cs 文件，代碼如下：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");app.Run();

代碼解析

1. WebApplication.CreateBuilder：該方法用于注冊 Web 應用程序主機的常用組件，例如配置、日志記錄、路由等。開發者可以在此階段通過注冊服務、讀取配置等方式增強主機功能。
2. app.MapGet：用于定義一個 GET 請求的端點。Minimal API 支持所有常見的 HTTP 方法（如 GET、POST、PUT、PATCH、DELETE 等）。
3. app.Run：啟動應用程序并開始監聽傳入的請求。

Minimal API 的核心是 RequestDelegate，它是一個簡單的委托，接受一個 HttpContext 參數并返回一個任務：

public delegate Task RequestDelegate(HttpContext context);

通過依賴注入，開發者可以將額外的參數傳遞給端點定義，從而增強其功能。

模型綁定與返回類型

Minimal API 提供了簡化的模型綁定機制。以下是一個示例，展示如何使用 POST 方法處理請求并返回結果：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapPost("/hugs", (Hug hug) =>
    Results.Ok(new Hugged(hug.Name, "Side Hug"))
);app.Run();public record Hug(string Name);
public record Hugged(string Name, string Kind);

模型綁定

Minimal API 的模型綁定機制會將請求體（假設為 JSON 格式）直接反序列化為指定的模型類型。例如，上述代碼中的 Hug 模型會自動綁定到請求體中的 JSON 數據：

POST http://localhost:5272/hugs
Content-Type: application/json

{ "Name": "Khalid Abuhakmeh" }

返回類型

Minimal API 提供了 Results 類，用于簡化常見的狀態碼和響應類型處理。開發者可以使用 Results.Ok、Results.Json 等方法快速生成響應。

依賴注入與服務

Minimal API 完全支持 ASP.NET Core 的依賴注入機制。以下示例展示了如何通過依賴注入實現服務的重構：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton(new HuggingService());
var app = builder.Build();

app.MapPost("/hugs", (Hug hug, HuggingService hugger) =>
    Results.Ok(hugger.Hug(hug))
);app.Run();public record Hug(string Name);
public record Hugged(string Name, string Kind);public class HuggingService
{
    private readonly string[] _hugKinds = { "Side Hug", "Bear Hug", "Polite Hug", "Back Hug", "Self Hug" };    public Hugged Hug(Hug hug) =>
        new(hug.Name, _hugKinds[new Random().Next(_hugKinds.Length)]);
}

在上述代碼中，HuggingService 被注冊為單例服務，并通過依賴注入傳遞給端點處理函數。

請求與響應過濾器

ASP.NET Core 7 引入了 Minimal API 過濾器，用于減少重復代碼。以下示例展示了如何添加一個時間戳過濾器：

async ValueTask