FastEndpoints:轻量级、高性能的ASP.NET Core Web API开发框架
编程乐趣 2024-08-10 17:33:01 阅读 93
对于在.Net中搭建API系统,我们一般是使用MVC的模式。但随着功能越来越多,控制器会越来越臃肿。
而FastEndpoints就为我们提供一种更加灵活、轻便的Web API处理方式,可以将每个控制器方法的垂直切割。
01 项目简介
FastEndpoints是基于REPR设计模式(请求-端点-响应)的Web API框架,它旨在减少开发代码量,提升开发效率。
与传统的ASP.NET Core Web API相比,FastEndpoints通过内联处理程序和直接的数据访问,大大简化了开发流程。
该框架不仅支持中间件、认证、授权、日志和依赖注入等常用功能,而且在性能上表现优异,性能与Minimal API不相上下。它比我们的基准测试中的MVC控制器更快,使用更少的内存,每秒处理大约35k个请求。
FastEndpoints可以很好的替换Minimal API和MVC。
02 框架核心功能
1、职场在多个类文件中定义端点(即使在深度嵌套的文件夹中)
2、端点可自动发现和注册
3、支持无属性的端点定义(无属性参数类型限制)
4、默认安全并支持大多数认证提供商
5、内置支持JWT Bearer认证方案
6、支持基于策略/权限/角色/声明的安全性
7、声明性安全策略构建(在每个端点内)
8、支持任何与ASP.NET兼容的IOC容器
9、端点依赖项的构造函数和属性注入
10、从路由/查询/JSON体/声明/表单/头信息中轻松绑定模型
11、支持对请求/响应DTO的Json源代码生成器
12、简易的文件处理(multipart/form-data)
13、使用FluentValidation规则的模型验证
14、方便的业务逻辑验证和错误响应
15、可快速访问环境和配置设置
16、API版本控制
17、速率限制
18、支持响应缓存
19、进程内发布/订阅事件通知(带自动发现)
20、用于实时数据流的简易服务器发送事件
21、方便的集成测试(无路由且强类型)
22、内置未捕获异常处理程序
23、支持swagger/serilog等
24、Visual Studio扩展(vsix),用于简单的垂直切片功能脚手架
25、与ASP.NET中间件管道支持良好
26、以及Minimal APIs可以做的任何其他事情…
03 使用方法
1、安装并初始化
<code>dotnet new web -n MyWebApp
cd MyWebApp
dotnet add package FastEndpoints
2、项目启动
修改Program.cs,完整代码如下:
var bld = WebApplication.CreateBuilder();
bld.Services.AddFastEndpoints();
var app = bld.Build();
app.UseFastEndpoints();
app.Run();
3、定义请求和返回对象DTO
namespace MyWebApp.DTO
{
public class UserRequest
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int Age { get; set; }
}
}
namespace MyWebApp.DTO
{
public class UserResponse
{
public string FullName { get; set; }
public bool IsOver18 { get; set; }
}
}
4、定义端点并实现业务
using MyWebApp.DTO;
namespace MyWebApp.Endpoint
{
public class UserEndpoint : Endpoint<UserRequest, UserResponse>
{
public override void Configure()
{
Post("/api/user/create");
AllowAnonymous();
}
public override async Task HandleAsync(UserRequest req, CancellationToken ct)
{
await SendAsync(new()
{
FullName = req.FirstName + " " + req.LastName,
IsOver18 = req.Age > 18
});
}
}
}
5、请求和返回结果
测试效果如下:
04 项目地址
https://github.com/FastEndpoints/FastEndpoints
- End -
推荐阅读
CsvHelper:一个轻便高性能的Csv文件读写操作开源库!
TheAlgorithms/C-Sharp:一个包含上百个C#算法示例代码的开源库
AutoFixture:.NET 的假数据生成工具
FluentAssertions:C#单元测试断言库,让测试代码更加直观、易读!
2个支持大文件上传.Net开源项目
声明
本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。