SuperAPI AI 工具集

dotnet-minimal-apis

编程与开发

查看项目

更新于 10-16 01:10

技能介绍

用途:介绍 ASP.NET Core Minimal API 的构建方式,这是微软推荐的新 HTTP API 项目模型,基于 lambda 编程,并具备 OpenAPI 支持、终结点过滤器与路由组。

主要能力:路由组(MapGroup)用共享前缀组织终结点并统一应用过滤器、元数据与授权,支持嵌套组;终结点过滤器(IEndpointFilter)处理日志、校验等横切关注点,按注册顺序执行,先注册者最外层;TypedResults 返回具体类型,便于 OpenAPI 在构建时推断响应架构,配合 Results<T1,T2> 声明多种响应码;.NET 10 通过 Microsoft.AspNetCore.OpenApi 内置 OpenAPI 3.1,可用 AddOpenApi、MapOpenApi 及 WithName、WithSummary、Produces 等丰富元数据。

使用方式:用 app.MapGroup 建立分组,AddEndpointFilter 应用过滤器,MapGet/MapPost 等注册终结点;参数可自动从路由、查询、请求头、正文和依赖注入绑定,也可用 AsParameters 绑定复杂对象;JSON 通过 ConfigureHttpJsonOptions 全局配置。规模化时可用扩展方法类或 Carter 库的 ICarterModule 自动发现,或按垂直切片组织功能目录。

适用场景:新建 ASP.NET Core HTTP API 项目、需要轻量编程模型与自动 OpenAPI 文档的服务。

限制:不涉及 API 版本控制、输入校验框架、架构模式、认证授权实现及 OpenAPI 文档生成定制,这些由其他技能覆盖。需 .NET 8.0+,OpenAPI 3.1 需 .NET 10.0。注意 ConfigureHttpJsonOptions 仅作用于 Minimal API,MVC 控制器需单独配置;避免用 Results 替代 TypedResults;过滤器顺序影响执行层级。