基于 .NET 6 的轻量级 Webapi 框架 FastEndpoints

bee25a2f9bc8ec051f9f2c020fb00a50.gif

大家好,我是等天黑。

FastEndpoints 是一个基于 .NET 6 开发的开源 webapi 框架,它可以很好地替代 .NET Minimal APIs 和 MVC ,专门为开发效率而生,带来了全新的开发模式和编码体验。

另外对于 .NET 的中间件、认证、授权、日志,依赖注入这些也都是支持的,甚至有些还进行了加强,所以你很快就可以上手它。

058244f4131dd48da722c1897584dd8a.png

 小试牛刀 

接下来,我将用 FastEndpoints 创建一个 webapi 应用,展示它是如何使用的,真的非常简单。

创建一个新项目

dotnet new web -n MyWebApp

进入项目

cd MyWebApp

安装 Nuget 包

dotnet add package FastEndpoints

更新 Program.cs

global using FastEndpoints;var builder = WebApplication.CreateBuilder();
builder.Services.AddFastEndpoints();var app = builder.Build();
app.UseAuthorization();
app.UseFastEndpoints();
app.Run();

添加一个 Request DTO

public class MyRequest
{public int Age { get; set; }public string Name { get; set; }
}

添加一个 Response DTO

public class MyResponse
{public int Id { get; set; }public int Age { get; set; }public string Name { get; set; }public DateTime CreateTime { get; set; }
}

添加一个 Endpoint Class

然后添加下面的代码, 这是处理业务逻辑的地方

public class MyEndpoint : Endpoint<MyRequest>
{public override void Configure(){Post("/api/user/create");AllowAnonymous();}public override async Task HandleAsync(MyRequest req, CancellationToken ct){var response = new MyResponse(){Id = 1,Age = req.Age,Name = req.Name,CreateTime = DateTime.Now };await SendAsync(response);}
}

准备工作都好了,直接启动我们的 webapi 项目。

然后用 Postman 或者其他工具,向 /api/user/create 端点发送 POST 请求。

70a516a7d129fb5f2f6351dc8a0085c4.png

创建了一个用户,并返回了用户信息,就是这么简洁,这就是 FastEndpoints。

你可能注意到了上面的 Configure()方法,指定了 Http 动词和端点。当然,你也可以使用 .NET 原生的特性的方式,这也是支持的。

[HttpPost("/my-endpoint")]
[Authorize(Roles = "Admin,Manager")]
public class UpdateAddress : Endpoint<MyRequest, MyResponse>
{public override async Task HandleAsync(MyRequest req, CancellationToken ct){await SendAsync(new MyResponse { });}
}

 依赖注入 

在 FastEndpoints 中,可以使用三种方式来访问 IOC 容器中注册的服务。

假设我们有一个 HelloWorldService 。

public interface IHelloWorldService
{string SayHello();
}public class HelloWorldService : IHelloWorldService
{public string SayHello() => "hello world!";
}

并且注册到 IOC 容器中。

builder.Services.AddScoped<IHelloWorldService, HelloWorldService>();

1. 构造函数注入

这是我们最熟悉的也是使用最多的方式。

public class MyEndpoint : EndpointWithoutRequest
{private IHelloWorldService _helloService;public MyEndpoint(IHelloWorldService helloScv){_helloService = helloScv;}public override void Configure(){Get("/api/hello-world");}public override async Task HandleAsync(CancellationToken ct){await SendAsync(_helloService.SayHello());}
}

2. 属性注入

服务实例可以通过属性的方式进行自动注入。

public class MyEndpoint : EndpointWithoutRequest
{public IHelloWorldService HelloService { get; set; }public override void Configure(){Get("/api/hello-world");}public override async Task HandleAsync(CancellationToken ct){await SendAsync(HelloService.SayHello());}
}

3. 手动解析

也可以像下面这样,直接手动获取服务。

使用 TryResolve 或 Resolve() 方法。

public override async Task HandleAsync(CancellationToken ct)
{IHelloWorldService? helloSvc = TryResolve<IHelloWorldService>();if (helloSvc is null)ThrowError("service not resolved!");var logger = Resolve<ILogger<MyEndpoint>>();logger.LogInformation("hello service is resolved...");await SendAsync(helloSvc.SayHello());
}

预先解析的服务

下面的三个服务已经预先解析过,我们可以直接在处理程序中使用。

property: Config
service : IConfigurationproperty: Env
service : IWebHostEnvironmentproperty: Logger
service : ILogger

非常方便地使用它们。

public override async Task HandleAsync(CancellationToken ct)
{Logger.LogInformation("this is a log message");var isProduction = Env.IsProduction();var smtpServer = Config["SMTP:HostName"];...
}

 架构模式 

如果你写过 Go Web,你会发现这是何等的相似。

package mainimport ("fmt""net/http"
)func main() {http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {fmt.Fprintf(w, "Hello, you've requested: %s\n", r.URL.Path)})http.ListenAndServe(":80", nil)
}

FastEndpoints 遵循了 REPR 设计 (Request-Endpoint-Response),这和我们常说的 MVC 模式是不一样的。

思考一下,如果后端只是一个 webapi 应用,没有 View, 那它就变成了 MC 架构 。是不是很奇怪,那为什么不用 REPR 模式呢?

从另外一个角度上说,“分层架构” 是我们很熟悉和经常使用的,代码被分成不同的层。

这样的好处也是显而易见的。它们以解耦的方式组合在一起,在需要时,我们可以很方便的替换其中的层。

124d176c1ead996d119b6fc7b76510be.png

还有一种架构称为 “垂直切片架构", 系统的每个组件都是单独的一块,彼此并不影响,就像微服务那样。

3b905c24cf0f226ebbab7e6cd83c0084.png

而 FastEndpoints 正是使用了下面的 “垂直切片架构"。

 总结 

如您所见,FastEndpoints 是一个灵活高效的 webapi 框架。另外它还有其他的功能,比如异常处理,集成和单元测试,限流,API 版本控制等等。

希望对您有用!

文档: https://fast-endpoints.com/

Github: https://github.com/FastEndpoints

END

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/283378.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

OO学习总结(二)

第五次作业&#xff1a;多线程电梯 多线程的同步和控制 在本次作业里&#xff0c;请求发生器不断往请求队列里加入电梯请求&#xff0c;主调度器不停将电梯请求分发给从调度器&#xff0c;从调度器不断读取请求来操控电梯运行&#xff0c;因而这三者之间存在同步关系。请求发生…

js导出PPT -- pptxgen使用方法

pptxgen使用方法 下载地址 https://codechina.csdn.net/mirrors/gitbrent/PptxGenJS?utm_sourcecsdn_github_accelerator ## 1. 文件引入 <script src"../js/pptxgen.bundle.js"></script> <script src"../js/jszip.min.js"></scr…

记录最近的一些遇到的前端面试题

HTML部分&#xff1a;1.问&#xff1a;DOCTYPE是什么。 答&#xff1a;查看w3school的详细解释http://www.w3school.com.cn/ta...&#xff1a;DTD, SGML) 2.问&#xff1a;有哪些行内元素、有哪些块级元素。margin属性是否对行内元素有所作用。 答&#xff1a;块级元素常用的有…

【mysql】mysql优化

一&#xff0c;表设计   1.1. E-R&#xff08;entity relation&#xff09;实体关系图     长方形 实体 表     椭圆形 属性 字段     菱形 关系 一对一 多对一 属于 多对多   1.2. 三范式标准     原子性       个人信息       省市县乡镇  …

3d数学基础图形与游戏开发 英文版_1850款文字标题字幕条,AE图形预设包,logo生成神器...

2019最新1850款组文字LOGO动画预设&#xff0c;一键生成&#xff01;包含图形元素/字幕/logo/动画转场/背景等所有的元素都支持AE和PR所有元素的颜色、位置、大小、文字、Logo等都可以修改&#xff0c;包含GIF动图预览&#xff0c;方便查找使用&#xff0c;一键生成狂拽炫酷屌炸…

什么?WPF 不支持 SVG ?

什么&#xff1f;WPF 不支持 SVG &#xff1f;控件名&#xff1a;SharpVectors作者&#xff1a;Elinam LLC (Japan)项目地址&#xff1a; https://github.com/ElinamLLC/SharpVectors什么是SVG&#xff1f;SVG 指可伸缩矢量图形 (Scalable Vector Graphics)&#xff1b;SVG 用…

Vue实现pptx在线预览

PPTX在线预览&#xff0c;使用jquery的插件《PPTXjs》&#xff0c;纯前端实现pptx转html进行展示 1.在PPTXjs官网下载插件&#xff0c;并在index.html内引入 <link rel"stylesheet" href"/PPTXjs/css/pptxjs.css"> <link rel"stylesheet&quo…

手写数字识别

深度学习:一、感知器S型神经元sigmoid fuction:1/(1exp(-z)) ![image](https://yqfile.alicdn.com/2e0144aba1df89e4ad5437e51aa21abc052025e5.png)二、神经网路这是一个三层神经网络输入层 隐藏层 输出层三、手写数字识别神经网络一共四层神经网络&#xff0c;第一层是以28*28…

5.1 入门整合案例(SpringBoot+Spring-data-elasticsearch) ---- good

本节讲解SpringBoot与Spring-data-elasticsearch整合的入门案例。 一、环境搭建 新建maven项目&#xff0c;名字随意 pom.xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <…

小组是什么意思_生猪期货什么时候上市?相关企业如何参与生猪期货

2020年4月生猪期货已获中国证监会批准&#xff0c;7月份大连商品交易所开展生猪期货仿真交易&#xff0c;这个期待许久的新品种上市脚步声越来越近&#xff0c;而市场各方的关注度也日益提升。同时&#xff0c;期货公司也在积极备战&#xff0c;为需要申请交割库的实体企业提供…

iNeuOS工业互联网操作系统,在航天和军工测控领域的应用

目 录1. 行业概述... 22. 解决方案... 23. 解决的痛点... 61. 行业概述现在国际形势异常严峻&#xff0c;加大了偶发武装斗争的可能性。航天和军工领域的数字化转型和建设正在积极推进&#xff0c;在与航天二院、航天三院、航天六院、航天九院、无线电厂…

[vite] Failed to load source map for */*.css|.js

打开提示的文件&#xff0c;删除 “sourceMappingURL”这一行即可

《工具癖》Mac与Windows获取文件绝对路径的快捷键

对于开发者而言, 快速获取文件的绝对路径,是一件很提升效率的事情, 一般的做法是,右键... 其实是有快捷键的! Mac获取文件绝对路径 mac的快捷键为: commandoptioncWindows获取文件绝对路径 按住shift键, 右键, 会出现复制为路径的选项

PerfView专题 (第九篇):洞察 C# 中的 LOH 内存碎片化

一&#xff1a;背景 在 内存泄漏 的系列问题中&#xff0c;有一类问题是 内存碎片化 导致的&#xff0c;而且这种更容易发生在 LOH 上&#xff0c;因为它默认不开启 对象压缩&#xff0c;一般遇到这种情况&#xff0c;优先让朋友执行下面的代码应急。GCSettings.LargeObjectHea…

HSV色彩空间

转自原文 HSV色彩空间 理解HSV色彩空间&#xff1a; HSV颜色模式是除了RGB颜色模式之外的另一种流行的颜色模式&#xff0c;RGB被广泛运用于计算机中&#xff0c;而HSV则用在电视显示方面。它更符合人们对颜色的描述(什么颜色(H)&#xff0c;深浅度如何(S)&#xff0c;亮度如…

Linux之tomcat日志管理

tomcat 的日志输出catalina.out&#xff0c;变大&#xff0c;可使用下面方式解决。 cronolog. http://blog.csdn.net/huang_xw/article/details/6194232转载于:https://www.cnblogs.com/itdev/p/6103207.html

java随机抽题系统_为什么要使用考试系统的随机组卷功能?

一个考试系统的组卷灵活性&#xff0c;不仅仅在于其题型丰富、设置参数齐全&#xff0c;也在于抽题组卷方式。除了平时我们严肃性的固定题目出卷方式&#xff0c;我们往往也考虑到需要随机组卷的功能。为什么用户会需要随机组卷的功能呢&#xff1f;随机组卷功能有什么用处&…

vue 项目中 splice 删除的不是指定的位置 而是最后一个

问题 就是v-for选择里面 删除数组指定元素 结果splice删除的永远都是最后一个 //html <view class"card ml20 mr20 mt20 c-row"><view class"flex-cover time-main" v-for"(item,index) in tabbar" :key"index"><scr…

常用的git命令

GIT 什么是git 是一个源代码管理工具在一个项目中&#xff0c;凡是由开发人员编写的都是源代码源代码有必要被管理起来吗让源代码可以被追溯&#xff0c;主要记录每次变了什么&#xff0c;谁主导这次变化人为的维护比较麻烦GIT是Linux之父当年为了维护管理Linux源代码写的一个工…

frameset在html5下用什么代替_速速围观!冬至吃货地图来啦~蚌埠的吃货们,你们今天吃什么?...

中国传统二十四节日冬农历十一月初七至冬至&#xff0c;又称日短至、冬节、亚岁等&#xff0c;兼具自然与人文两大内涵&#xff0c;既是二十四节气中一个重要的节气&#xff0c;也是中国民间的传统节日&#xff0c;被视为冬季的大节日。我们迎来了冬至节气&#xff0c;真正的隆…