Minimal API 是一种在 .NET 6 中引入的轻量级 HTTP 服务构建方式,1. 它通过简化路由和处理逻辑定义,无需控制器即可快速搭建 API;2. 核心优势包括减少样板代码、提升开发效率、降低学习成本、资源占用少且易于容器化;3. 支持与 ASP.NET Core 生态无缝集成,如依赖注入、中间件、日志和数据库;4. 可通过 dotnet new web 快速创建项目,并在 Program.cs 中使用 lambda 表达式定义 GET、POST 等路由;5. 内置 JSON 序列化支持,可轻松返回或接收对象数据;6. 能注册服务(如 DbContext、Singleton 服务)并在请求中直接注入使用;7. 适合微服务、原型开发等场景,虽简洁但仍可扩展验证、错误处理等机制。

Minimal API 是 C# 中一种简洁高效的方式来创建轻量级的 HTTP 服务,它从 .NET 6 开始成为默认项目模板的一部分。它的核心特点是用最少的代码定义路由和处理逻辑,无需控制器(Controller),特别适合构建小型服务、微服务或快速原型。
Minimal API 的核心优势
它去除了传统 ASP.NET Core MVC 中的冗余结构,比如控制器类、动作方法等,直接在 Program.cs 中通过简单的 lambda 表达式定义接口行为。这种方式减少了样板代码,提高了开发效率。
代码更少,启动更快学习成本低,适合新手入门资源占用小,适合容器化部署与 ASP.NET Core 生态无缝集成(如依赖注入、中间件)
快速创建一个 Minimal API 项目
使用 .NET CLI 可以几秒内生成并运行一个基础 API。
打开终端,运行命令创建新项目:
dotnet new web -n MyApi进入项目目录:
cd MyApi运行项目:
dotnet run
此时会看到服务监听在 5000 和 5001 端口(HTTP/HTTPS),浏览器访问 https://www.php.cn/link/6060d322713797e84f598ea25c812cab 就能看到 “Hello World!”。
添加实际的 API 路由示例
修改 Program.cs 文件,添加几个常见类型的接口:
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
// 基础 GET 请求
app.MapGet(“/hello”, () => “Hello, Minimal API!”);
// 带路径参数
app.MapGet(“/user/{id}”, (int id) => $”User ID: {id}”);
// 返回 JSON 数据
app.MapGet(“/api/users”, () => new[] {
new { Id = 1, Name = “Alice” },
new { Id = 2, Name = “Bob” }
});
// POST 接收 JSON 输入
app.MapPost(“/api/users”, (User user) => Results.Created($”/api/users/{user.Id}”, user));
app.Run();
record User(int Id, string Name);
这个例子展示了如何处理不同类型的请求,并自动序列化/反序列化 JSON 数据,得益于内置的 System.Text.Json 支持。
集成日志、数据库和其他服务
尽管轻量,Minimal API 仍可轻松接入完整功能。例如注册服务:
builder.Services.AddSingleton();
builder.Services.AddDbContext(options =>
options.UseSqlite(“Data Source=app.db”));
然后在路由中通过参数获取服务实例:
app.MapGet(“/data”, (IDataService service) => service.GetData());
基本上就这些。Minimal API 让你用最直接的方式暴露 HTTP 接口,不复杂但容易忽略细节,比如模型验证、错误处理等,可在需要时逐步增强。
以上就是C#的Minimal API是什么?如何快速创建轻量级的HTTP API?的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1441503.html
微信扫一扫
支付宝扫一扫