極簡 API，到底多神奇？

圖片

在傳統的ASP.NET Core 開發中，構建一個 API 往往需要經歷繁瑣的步驟。你得創建控制器類，定義各種方法來處理不同的 HTTP 請求，還要操心路由配置、依賴注入等一系列復雜的事情。這就好比搭建一座房子，從打地基開始，一磚一瓦地慢慢壘砌，過程復雜且耗時。

而ASP.NET Core 極簡 API 的出現，就像是給開發者們帶來了一套神奇的 “搭建工具包”。它極大地簡化了 API 的創建過程，讓開發者可以用極少的代碼實現強大的功能。簡單來說，極簡 API 允許你在一個文件中定義整個 API，通過簡潔的方法調用就能完成路由映射、請求處理等關鍵操作 。比如，你想要創建一個簡單的返回 “Hello, World!” 的 API，在極簡 API 中，可能只需要短短幾行代碼：

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

對比傳統方式，這種極簡風格的開發是不是瞬間讓你感覺輕松了許多？它就像一把鋒利的 “手術刀”，精準地切除了傳統開發中那些冗余的部分，讓開發流程變得更加流暢、高效。

傳統開發 VS 極簡 API，誰更勝一籌？

為了讓大家更直觀地感受到極簡 API 的優勢，我們不妨來一場傳統ASP.NET Core 開發方式與極簡 API 的 “對決”。

代碼量：極簡 API 的 “輕裝上陣”

在傳統開發中，創建一個簡單的 API，光是控制器類的定義就需要不少代碼。以一個獲取用戶信息的 API 為例，傳統方式可能需要這樣寫：

[ApiController][Route("[controller]")]public class UserController : ControllerBase{[HttpGet("{id}")]public IActionResult Get(int id){// 這里是獲取用戶信息的邏輯，比如從數據庫查詢var user = new { Id = id, Name = "張三", Age = 30 };return Ok(user);}}

而在極簡 API 中，同樣的功能只需幾行代碼就能實現：

var builder = WebApplication.CreateBuilder(args);var app = builder.Build();app.MapGet("/users/{id}", (int id) =>{var user = new { Id = id, Name = "張三", Age = 30 };return Results.Ok(user);});app.Run();

很明顯，極簡 API 的代碼量大幅減少，讓開發者可以更專注于業務邏輯的實現，而不是被繁瑣的代碼結構所束縛。

項目結構：極簡 API 的 “簡潔布局”

傳統ASP.NET Core 項目結構相對復雜，包含 Controllers、Models、Views（即使在純 API 項目中可能用不到）、Services 等多個文件夾和大量的配置文件。每個部分都有其特定的職責和規范，這雖然在大型項目中有助于代碼的組織和維護，但對于一些小型項目或快速迭代的項目來說，顯得過于臃腫。

而極簡 API 項目結構則極為簡潔，核心代碼可以集中在 Program.cs 文件中，所有的路由定義、服務配置、中間件使用等操作都可以在這個文件中完成。這使得項目結構一目了然，降低了開發和維護的難度 。

開發效率：極簡 API 的 “加速引擎”

從開發效率上看，極簡 API 的優勢也十分明顯。傳統開發方式中，開發者需要在不同的文件和類之間來回切換，進行各種配置和代碼編寫，這在一定程度上會打斷開發思路，降低開發效率。

而極簡 API 的簡潔語法和集中式的代碼結構，讓開發者能夠快速地完成 API 的創建和修改。比如，當需要新增一個 API 端點時，在極簡 API 中只需在 Program.cs 文件中添加一行 MapXXX 方法調用即可，而傳統方式則需要創建新的控制器方法、配置路由等多個步驟。這種高效的開發方式，能夠大大縮短項目的開發周期，讓產品更快地推向市場。

極簡 API 初體驗，三行代碼構建 Web 應用

圖片

說了這么多，相信大家已經迫不及待地想要親自體驗一下極簡 API 的魅力了。下面，就讓我們通過一個簡單的示例，來感受一下如何用極簡 API 創建一個 Web 應用。

（一）創建 Web 應用實例

首先，我們需要創建一個 Web 應用實例。在.NET 6 中，這一步變得非常簡單，只需要一行代碼：

var builder = WebApplication.CreateBuilder(args);

這行代碼使用WebApplication.CreateBuilder方法創建了一個WebApplicationBuilder實例，它負責初始化應用程序的配置、服務和中間件等。args參數是從命令行傳遞進來的參數，通常用于接收啟動應用程序時的一些配置信息 。

（二）定義路由和處理邏輯

接下來，我們要定義一個路由和對應的處理邏輯。假設我們要創建一個簡單的 API，當用戶訪問根路徑/時，返回 “Hello, World!”。在極簡 API 中，只需要這樣寫：

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

第一行代碼調用builder.Build()方法，構建并返回一個WebApplication實例，這個實例代表了我們的 Web 應用。第二行代碼使用app.MapGet方法定義了一個 GET 請求的路由，當用戶訪問根路徑/時，會執行后面的匿名函數，返回 “Hello, World!” 字符串。MapGet方法是EndpointRouteBuilderExtensions類的擴展方法，它的第一個參數是路由模板，第二個參數是請求處理委托 。

（三）運行應用

最后，我們需要運行這個應用，讓它監聽并處理來自客戶端的請求。同樣，只需要一行代碼：

app.Run();

這行代碼會啟動應用程序，并開始監聽配置中指定的 URL 地址（默認為http://localhost:5000和https://localhost:5001）。當有客戶端請求到達時，應用會根據定義的路由規則來處理請求 。

把以上代碼整合起來，完整的Program.cs文件如下：

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

就是這么簡單，一個完整的 Web 應用就創建好了。你可以將這段代碼復制到你的項目中，運行起來，然后在瀏覽器中訪問http://localhost:5000，就能看到 “Hello, World!” 的輸出了。

深度探索：極簡 API 的強大功能

圖片

前面我們已經初步領略了極簡 API 的風采，接下來，讓我們深入探索一下它的強大功能，看看它在實際開發中能為我們帶來哪些便利。

（一）靈活的路由定義

在極簡 API 中，路由定義變得非常靈活。除了前面提到的MapGet方法用于定義 GET 請求的路由外，還有MapPost、MapPut、MapDelete等方法，分別用于定義 POST、PUT、DELETE 請求的路由 。

例如，我們要創建一個新增用戶的 API，可以使用MapPost方法：

app.MapPost("/users", (User user) =>{// 這里是將用戶數據保存到數據庫的邏輯// 假設保存成功后返回一個表示成功的消息return Results.Ok("用戶添加成功");});

在這個例子中，當客戶端向/users發送 POST 請求時，請求體中的數據會自動綁定到User類型的參數上，然后執行相應的處理邏輯 。

我們還可以使用Map方法來定義更復雜的路由規則，它可以根據請求的路徑和 HTTP 方法來匹配路由 。例如：

app.Map("/custom", app =>{app.MapGet("/", () => "這是自定義路由的GET請求處理邏輯");app.MapPost("/", () => "這是自定義路由的POST請求處理邏輯");});

在這個例子中，/custom路徑下定義了 GET 和 POST 兩種請求的處理邏輯，通過這種方式，可以將相關的路由集中管理，使代碼結構更加清晰 。

（二）輕松處理請求和響應

極簡 API 在處理請求和響應方面也非常便捷。我們可以直接在路由處理委托中獲取請求數據、處理業務邏輯并生成響應 。

比如，我們要創建一個根據用戶 ID 獲取用戶信息的 API，并且在請求頭中傳遞了一個認證令牌，我們可以這樣實現：

app.MapGet("/users/{id}", (HttpContext context, int id) =>{// 從請求頭中獲取認證令牌var token = context.Request.Headers["Authorization"].FirstOrDefault();// 這里可以添加令牌驗證邏輯// 假設這里從數據庫中查詢用戶信息var user = GetUserFromDatabase(id);if (user!= null){return Results.Ok(user);}else{return Results.NotFound();}});

在這個示例中，HttpContext參數提供了對當前請求的上下文信息的訪問，我們可以從中獲取請求頭、請求體等數據。根據業務邏輯的處理結果，我們使用Results.Ok返回成功的響應，使用Results.NotFound返回未找到資源的響應 。

（三）中間件的使用

中間件在ASP.NET Core 中起著至關重要的作用，它可以對請求和響應進行攔截和處理，實現諸如日志記錄、身份驗證、錯誤處理等功能。在極簡 API 中，中間件的使用同樣簡單 。

比如，我們要添加一個日志記錄中間件，記錄每個請求的 URL 和處理時間，可以這樣實現：

app.Use(async (context, next) =>{var startTime = DateTime.Now;// 記錄請求的URLConsole.WriteLine($"請求URL: {context.Request.Path}");await next();var endTime = DateTime.Now;var elapsedTime = endTime - startTime;// 記錄請求處理時間Console.WriteLine($"請求處理時間: {elapsedTime.TotalMilliseconds} 毫秒");});

在這個例子中，Use方法用于添加中間件，它接受一個委托，委托中包含HttpContext和Func<Task>類型的參數。HttpContext表示當前請求的上下文，Func<Task>表示下一個中間件或請求處理邏輯。在委托中，我們可以在調用下一個中間件之前和之后執行自定義的邏輯 。

如果我們要創建一個自定義的中間件類，也非常簡單。首先創建一個中間件類，例如：

public class CustomMiddleware{private readonly RequestDelegate _next;public CustomMiddleware(RequestDelegate next){_next = next;}public async Task InvokeAsync(HttpContext context){// 這里可以添加自定義的請求處理邏輯Console.WriteLine("自定義中間件處理請求前");await _next(context);// 這里可以添加自定義的響應處理邏輯Console.WriteLine("自定義中間件處理響應后");}}

然后，在Program.cs文件中添加這個自定義中間件：

app.UseMiddleware<CustomMiddleware>();

通過這種方式，我們就可以將自定義的中間件添加到請求處理管道中，實現對請求和響應的個性化處理 。

應用場景大揭秘，看看它適合哪兒

圖片

（一）快速原型開發

在快速原型開發階段，時間就是一切，開發者需要快速地將想法轉化為可運行的原型。極簡 API 的簡潔特性使其成為快速原型開發的理想選擇 。

比如，一家創業公司正在開發一款新的移動應用，需要在短時間內搭建一個后端 API 來驗證業務邏輯和數據交互。使用極簡 API，開發者可以在短短幾天內就完成基礎 API 的搭建，包括用戶注冊、登錄、數據獲取等功能 。這樣，團隊可以快速地將原型展示給投資者或潛在用戶，收集反饋，進行迭代。如果使用傳統的開發方式，可能需要花費數周的時間來完成同樣的功能，這無疑會延長產品的開發周期，增加項目的風險 。

（二）微服務架構

在微服務架構中，每個微服務都應該是獨立的、可擴展的，并且能夠快速迭代。極簡 API 的輕量級特性和靈活的路由定義，使其非常適合用于構建微服務 。

以一個大型電商系統為例，它可能包含訂單服務、商品服務、用戶服務等多個微服務。每個微服務都可以使用極簡 API 來實現，這樣可以減少每個服務的代碼量和復雜度，提高系統的可維護性。當某個微服務需要擴展時，由于其代碼簡潔，更容易進行性能優化和水平擴展。如果訂單服務的流量突然增加，開發團隊可以快速地對訂單服務的極簡 API 進行優化，增加服務器實例，以應對高并發的請求 。

（三）簡單 HTTP API

對于只需要基本 CRUD 操作的 API，極簡 API 提供了一種簡潔高效的解決方案。比如，一個小型的博客系統，它只需要提供文章的創建、讀取、更新和刪除功能 。使用極簡 API，開發者可以輕松地實現這些功能，代碼量少，且易于理解和維護。

app.MapGet("/articles/{id}", (int id) =>{// 從數據庫中查詢文章var article = GetArticleFromDatabase(id);if (article!= null){return Results.Ok(article);}else{return Results.NotFound();}});app.MapPost("/articles", (Article article) =>{// 將文章保存到數據庫SaveArticleToDatabase(article);return Results.Created($"/articles/{article.Id}", article);});app.MapPut("/articles/{id}", (int id, Article updatedArticle) =>{// 更新數據庫中的文章var success = UpdateArticleInDatabase(id, updatedArticle);if (success){return Results.NoContent();}else{return Results.NotFound();}});app.MapDelete("/articles/{id}", (int id) =>{// 從數據庫中刪除文章var success = DeleteArticleFromDatabase(id);if (success){return Results.NoContent();}else{return Results.NotFound();}});

在這個例子中，通過極簡 API 的MapGet、MapPost、MapPut和MapDelete方法，清晰地定義了文章相關的 CRUD 操作，代碼簡潔明了，沒有多余的冗余代碼 。

總結與展望，極簡 API 的未來之路

圖片

ASP.NET Core 極簡 API 以其簡潔的代碼結構、高效的開發方式和靈活的功能特性，為開發者帶來了全新的開發體驗。它不僅簡化了傳統 API 開發中的繁瑣流程，還在性能和可維護性上有著出色的表現。無論是快速原型開發、微服務架構的構建，還是簡單 HTTP API 的實現，極簡 API 都展現出了強大的優勢 。

對于廣大開發者來說，不妨在接下來的項目中嘗試使用ASP.NET Core 極簡 API，親身體驗它帶來的便捷與高效。相信隨著.NET 技術的不斷發展，極簡 API 也將不斷完善和進化，為我們帶來更多的驚喜和可能 。讓我們一起期待極簡 API 在未來的.NET 開發中綻放更加耀眼的光芒，助力我們打造出更加優秀、高效的應用程序 。