.NET 6 轻量级 WebApi 框架 FastEndpoints 入门

原文：.NET 6 轻量级 WebApi 框架 FastEndpoints 入门_.net api框架-CSDN博客

(一)前言

前段时间我从公众号：dotNET跨平台了解到了一个webapi框架叫：基于 .NET 6 的轻量级 Webapi 框架 FastEndpoints (qq.com)

随后觉得可以试试，然后就去搜索了一下，不过网上的资料比较少，可能是由于该框架出来的不久，毕竟.NET 6 也没发布多久，但是官网也提供了不少资料：FastEndpoints (fast-endpoints.com)

又到了充电学习的时间，然后我就开始按照公众号的文章一步一步操作，发现这文章也是用的官方的快速入门教程的一部分，但是里面有些代码和解释不完整，导致我卡在了一些地方，没办法还是得在官网和github上去扒拉。

最终就有了我接下来要分享的内容：利用vs2022建一个webapi的服务程序，写两个api，写两个api，一个是添加用户，一个是获取token，这样就会涉及到数据库的查询、新增、修改。以及token的认证，以及swagger的配置，数据使用的是MongoDB，平时我是用的mysql，但是官网用的是这个，还有个原因就是觉得自己也该接触一下这些数据库，得试试了。

分享的内容对于FastEndpoints整个框架的内容来说确实只有一小部分内容，但是已经够引入门了，更深入的得自己根据需求去深入去学习，生产环境中遇到的需求在官网的上基本都有解决方案。

虽然我没有深入去了解了，但是个人感觉了一下这样的WebAPI确实比之前的方便快捷了不少，效率也快了不少，我个人觉得挺实用的，因为现在都微服务了，一个服务的api功能本来就比较专一，用这个框架来做个人觉得问题不大，虽然我没有用到生产环境。

参考资料整理：

1.FastEndpoints官网：快速端点 (fast-endpoints.com)

2.官方示例文章：在 .net 6 中构建 REST API 非常简单！- 开发社区 👩 💻👨 💻 (dev.to)

3.官方示例项目文件：https://codeload.github.com/dj-nitehawk/MiniDevTo/zip/refs/heads/main

4.完整的官方示例教程：Get Started | FastEndpoints (fast-endpoints.com)

5.我的项目文件：GitHub - LYD2015/MyFastEndpoints，就是下面分享类容的项目，建议下载后对照看。

建议：先看看官网的快速构建，以及部分思想介绍，因为下面我只是分享项目怎么写的，思想方面需要自己慢慢悟。

(二)创建项目

话不多说，我们可以可以开始了，下面采用图文方式来介绍，也要注意图片上的笔记文字哦。

1.创建一个空的WebAPI项目

2.引入需要的nuget包

3.创建结构目录

我的这个目录结构是根据官网的例子以及结合自己以前开发一些项目的经营简单建立的一个目录结构。简而言之来说，官网的例子或者说是FastEndpoints思想的其中一点就是每一个API一个文件夹，每个文件夹下面都有几个API需要的.cs文件。

4.修改程序入口文件Program.cs

没有写注释的就是建项目自动生成的。

global using FastEndpoints;
 
global using FastEndpoints.Security;
 
global using MyWebApp.Consts;
 
using FastEndpoints.Swagger;
 
using MongoDB.Entities;
 
 
 
var builder = WebApplication.CreateBuilder();
 
builder.Services.AddFastEndpoints();//FastEndpoints框架核心
 
builder.Services.AddAuthenticationJWTBearer(SysConst.TokenSigningKey);//添加jw认证
 
builder.Services.AddSwaggerDoc(addJWTBearerAuth:true);//添加swagger,并在swagger上显示输入token的按钮
 
 
 
var app = builder.Build();
 
app.UseAuthentication();//启用jw认证
 
app.UseAuthorization();
 
app.UseFastEndpoints();//启用FastEndpoints框架核心
 
app.UseOpenApi();//启用swagger扫描api
 
app.UseSwaggerUi3(s => s.ConfigureDefaults());//默认配置启用swagger的ui
 
 
 
await DB.InitAsync(database: "FastEndpoints_TestDB", host: "localhost");//配置连接到我本地的MongoDB数据库
 
 
 
app.Run();