自舉與框架初始化

MVC的初始化方式

在傳統的ASP.NET Core MVC中，應用程序的初始化通常通過Startup類完成。然而，ASP.NET Core 6.0引入了頂級語句的支持，簡化了初始化過程。現在，所有的引導代碼都集中在一個Program.cs文件中：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.MapControllers();
app.Run();

上述代碼中，AddControllers()方法用于注冊MVC框架的依賴項，而MapControllers()則負責注冊控制器的路由和中間件。

Minimal APIs的初始化方式

Minimal APIs通過更簡潔的方式實現了類似的功能。以下是一個典型的Minimal APIs初始化示例：

var app = WebApplication.CreateBuilder(args).Build();
app.MapGet("/", () => "Hello World!");
app.Run();

可以看到，Minimal APIs的初始化代碼更加簡潔，適合構建輕量級的HTTP服務。

路由定義與處理程序

MVC中的路由定義

在MVC中，路由可以通過兩種方式定義：基于約定的路由和基于屬性的路由。

1. 基于約定的路由：通常用于網站開發，路由規則在Program.cs中定義，例如：

   app.UseRouting();
   app.UseEndpoints(endpoints =>
   {
      endpoints.MapControllerRoute(
          name: "default",
          pattern: "{controller=Home}/{action=Index}/{id?}");
   });

2. 基于屬性的路由：更適合API開發，通過在控制器或操作方法上添加路由屬性實現，例如：

   [Route("api/[controller]")]
   [ApiController]
   public class WeatherForecastController : ControllerBase
   {
      [HttpGet]
      public IEnumerable Get() { ... }
   }

Minimal APIs中的路由定義

Minimal APIs通過MapGet、MapPost等方法定義路由。例如：

app.MapGet("/weatherforecast", () => new[] { "Sunny", "Rainy" });

此外，Minimal APIs還支持通過MapMethods定義自定義HTTP動詞的路由。

模型綁定

模型綁定是從HTTP請求中提取數據并將其轉換為.NET類型的過程。

MVC中的模型綁定

在MVC中，可以通過以下方式實現模型綁定：

1. 從請求體綁定JSON數據：

   [HttpPost]
   public IActionResult Create([FromBody] WeatherForecast forecast) { ... }

2. 從查詢字符串綁定復雜類型：

   [HttpGet]
   public IActionResult Search([FromQuery] SearchParameters parameters) { ... }

3. 綁定簡單類型：簡單類型會自動從路由或查詢字符串中綁定。

Minimal APIs中的模型綁定

Minimal APIs的模型綁定與MVC類似，但更為簡潔。例如：

app.MapPost("/create", (WeatherForecast forecast) => { ... });

需要注意的是，Minimal APIs目前不支持通過[FromQuery]綁定復雜類型。

HTTP響應

無論是MVC還是Minimal APIs，都支持將返回類型自動序列化為HTTP響應。

MVC中的HTTP響應

在MVC中，可以通過返回IActionResult來生成響應，例如：

public IActionResult Get()
{
    return Ok(new { Message = "Success" });
}

Minimal APIs中的HTTP響應

Minimal APIs通過IResult實現類似功能。例如：

app.MapGet("/success", () => Results.Ok(new { Message = "Success" }));

依賴注入

依賴注入（DI）是ASP.NET Core的重要特性，MVC和Minimal APIs均支持DI。

MVC中的依賴注入

在MVC中，依賴項通常通過構造函數注入：

public class WeatherForecastController : ControllerBase
{
    private readonly IWeatherService _service;

    public WeatherForecastController(IWeatherService service)
    {
        _service = service;
    }
}

Minimal APIs中的依賴注入

Minimal APIs則通過將依賴項作為參數傳遞給處理程序實現：

app.MapGet("/forecast", (IWeatherService service) => service.GetForecast());

授權與安全

ASP.NET Core的授權機制同樣適用于MVC和Minimal APIs。

MVC中的授權

在MVC中，可以通過[Authorize]屬性聲明授權需求，例如：

[Authorize(Roles = "Admin")]
public IActionResult AdminOnly() { ... }

Minimal APIs中的授權

Minimal APIs通過在路由定義中附加元數據實現授權，例如：

app.MapGet("/admin", [Authorize] () => "Admin Area");

總結

Minimal APIs為開發者提供了一種輕量級的替代方案，適用于構建簡單、高效的HTTP服務。與MVC相比，Minimal APIs的主要優勢在于其簡潔性和靈活性，開發者可以根據需求選擇所需的功能組件，而無需引入不必要的復雜性。在實際開發中，可以根據項目的規模和需求，靈活選擇MVC或Minimal APIs作為技術棧的一部分。

原文鏈接: https://benfoster.io/blog/mvc-to-minimal-apis-aspnet-6/