关于 .NET 6 Minimal API 的使用方式详解

什么是 .NET 6 Minimal API

.NET 6 Minimal API 是 .NET 6 新增的一个轻量级 Web API 框架，它旨在提供一种更简单、更轻量级的开发方式，用于快速搭建 Web API 服务。相对于传统的 ASP.NET Core Web API，它更加易于学习、更加灵活，并且具有更高的性能。

如何使用 .NET 6 Minimal API

步骤一：创建新的项目

首先，需要打开 Visual Studio 或者其他基于 .NET 6 的 IDE，创建一个新的 .NET 6 Web 应用程序。

选择 Minimal API 项目模板，它会自动为你创建一个基础的 Minimal API 清单，它包括了启动程序、路由、中间件等基本功能。

步骤二：定义路由和处理程序

在创建好项目后，你需要定义一个或多个路由（Route），并对每个路由定义对应的处理程序（Handler）。

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

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

app.Run();

以上代码定义了一个路由 /，当用户请求该路由的时候，会执行一个简单的回应，返回字符串 "Hello World!"。

步骤三：运行应用程序

完成上述代码编写后，你需要编译并启动这个应用程序。你可以通过 Visual Studio 直接点击“运行”按钮，或者使用命令行工具。

在应用程序启动完成后，你可以在浏览器中访问定义的路由地址，例如 http://localhost:5000/，你应该会看到字符串 "Hello World!" 的回应。

示例代码说明

下面，我们通过两个简单的例子来说明 .NET 6 Minimal API 的使用方法。

示例一：返回 JSON 格式数据

在该示例中，我们定义了一个新的路由 /weatherforecast，当用户请求该路由的时候，返回一些天气数据，这些数据是一个包含多个天气对象的 JSON 格式字符串。

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.MapGet("/weatherforecast", () =>
{
    var rng = new Random();
    var forecasts = 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();

    return forecasts;
});

app.Run();

public record WeatherForecast
{
    public DateTime Date { get; init; }
    public int TemperatureC { get; init; }
    public string Summary { get; init; }
}

在上述示例中，我们使用 app.MapGet() 方法来定义一个 GET 请求的路由。其中，参数 /weatherforecast 代表了路由地址，第二个参数是一个 Lambda 表达式，它返回一组天气对象。

示例二：使用数据库存储数据

在该示例中，我们将使用 EntityFramework Core 来连接数据库，并将数据存储到关系型数据库中。我们将使用 SQLite 作为我们的数据库。

首先，你需要安装 EntityFramework Core 和 SQLite 相关的 NuGet 包。然后，你需要在项目的配置文件中添加 SQLite 数据库连接字符串。

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<WeatherDbContext>(options =>
{
    options.UseSqlite("Data Source=weather.db");
});

var app = builder.Build();

app.MapGet("/weather", async (WeatherDbContext dbContext) =>
{
    return await dbContext.Weather.ToListAsync();
});

app.MapPost("/weather", async (Weather weather, WeatherDbContext dbContext) =>
{
    dbContext.Weather.Add(weather);
    await dbContext.SaveChangesAsync();
    return weather;
});

app.Run();

在上述示例代码中，我们使用 builder.Services.AddDbContext() 方法来注册一个 WeatherDbContext 上下文对象，用于处理数据库操作。我们还使用 app.MapGet() 和 app.MapPost() 方法来定义 GET 和 POST 请求处理器。

当用户请求 /weather 路由的 GET 请求时，会从数据库中读取所有的 Weather 记录，并返回一个 JSON 格式数据。当用户请求 /weather 路由的 POST 请求时，会将用户发来的数据插入到数据库中，并返回用户发来的数据。

总结

在本篇攻略中，我们详细讲解了 .NET 6 Minimal API 的使用方式，并进行了两个示例说明。/weatherforecast 示例通过返回 JSON 格式数据的方式，说明了如何进行 RESTful 风格 API 的开发；/weather 示例说明了如何使用 EntityFramework Core 来连接数据库，与数据库进行交互。

当你掌握了这些知识后，你可以开始使用 .NET 6 Minimal API 来构建你的 Web API 服务了。