C#的Minimal API是什么?如何快速创建轻量级的HTTP API?

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. 适合微服务、原型开发等场景,虽简洁但仍可扩展验证、错误处理等机制。

c#的minimal api是什么?如何快速创建轻量级的http api?

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

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 18:09:04
下一篇 2025年12月17日 18:09:17

相关推荐

发表回复

登录后才能评论
关注微信