SuperAPI AI 工具集

dotnet-minimal-apis

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:面向新建 ASP.NET Core HTTP API 项目,采用微软推荐的 Minimal API 轻量 lambda 编程模型,提供路由组、终结点筛选器、TypedResults 与 OpenAPI 支持。

主要能力:路由组与嵌套组按共享前缀组织终结点并统一应用筛选器、元数据和授权;终结点筛选器实现日志、校验等横切关注点,按注册顺序执行(先注册在最外层);TypedResults 返回具体类型,便于构建时生成准确的 OpenAPI 响应架构,配合 Results<T1,T2> 声明多种响应码;参数绑定支持路由、查询、请求头、正文与依赖注入,并可用 AsParameters 绑定复杂对象;通过 ConfigureHttpJsonOptions 配置 JSON 序列化;支持用扩展方法类或 Carter 库的 ICarterModule 自动发现模块来组织大型 API。

使用方式:需 .NET 8.0+(路由组与筛选器基线),.NET 10.0 提供内置 OpenAPI 3.1;OpenAPI 文档生成需 Microsoft.AspNetCore.OpenApi,Carter 为可选。示例:builder.Services.AddOpenApi(); app.MapOpenApi(); 以及 app.MapGroup("/api/products").WithTags("Products").RequireAuthorization();

限制与注意:ConfigureHttpJsonOptions 仅作用于 Minimal API,MVC 控制器需单独用 AddControllers().AddJsonOptions();应优先用 TypedResults 而非 Results,否则 OpenAPI 无法推断响应类型;避免把校验逻辑内联到每个终结点,应使用筛选器;终结点过多时应拆分为扩展方法类或 Carter 模块。API 版本控制、输入校验框架、架构模式、认证授权、OpenAPI 定制、gRPC 与实时通信不在本技能范围内,需参考对应技能。