极简 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 开发中绽放更加耀眼的光芒，助力我们打造出更加优秀、高效的应用程序 。
