通俗理解.NET 6 Minimal APIs
.NET 6,微软称为“最快的.NET”,带有了许多令人兴奋的新功能、语言和性能改进。这是自 .NET Core 3.1 以来的第一个 LTS 版本,将支持三年。
本次大版本发布,增加了一个新特性:Minimal APIs,这是什么技术?
.NET6 使编写具有最小依赖性的 REST API 变得非常简单。
乍一看,Minimal APIs 似乎是微软对 NodeJS(使用 ExpressJS)HTTP 服务器的回应,它提供了最小的 API。
但是微软也对这项技术增加了几个关键词
- LightWeight,Single file,Cloud Native API
- Low ceremony,Top-Level C# programs
- Easy to get started
- Path to MVC
总结一句话:.NET 6 Minimal APIs 简化了HTTP Rest API的设计和实现,让开发者快速高效实现HTTP Rest API。
今天,我们花点时间,研究并科普一下.NET 6 Minimal APIs。
一、先看一下.NET 6 Minimal APIs的示例代码
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build(); app.MapGet("/", () => "Hello World!"); app.Run();
在上面的示例中,app.MapGet 方法使用了内联 lambda 表达式,完成一个Controller Action的业务逻辑,真的是超简单。
超简单完成一个HTTP WebAPI的定义:不再有 Startup.cs、API 控制器、额外依赖项等。
只需要这 4 行代码即可生成以下输出:
二、探究一下这段代码背后的一些技术
上面的代码,微软官方文档上,建议大家使用VS2022,其实用VS Code也可以
Tutorial: Create a minimal web API with ASP.NET Core
但是本机得先安装.NET 6 SDK
安装完成后,打开VS Code,新建终端,创建一个Web Project
dotnet new web -o MyMinimalAPI
代码工程中,我们可以看到:
Program.cs这个类中没有using了,当然也没有main函数了,这里跟大家解释一下:
① .NET5 引入了Top-Level Class,可以没有main函数,代码作为直接入口执行
② .NET 6 新增了一个很棒的新特性——“隐式全局使用”
自动生成不可见的 using 语句并在全局范围内声明它们,因此不必处理在每个文件中重复声明命名空间的混乱。
我们打开MyMinimalAPI.csproj 看看里面的内容,有一个配置:

dotnet build后,找到obj/Debug/net6.0 文件夹以查看隐藏的自动生成文件 - [ProjectName].GlobalUsings.g.cs。您可以定义一个单独的类来将所有 using 语句保存在一个地方。
这个功能,让我们不需要在每个文件中重复声明命名空间的using引用了。的确很方便、简单了。
当然,如果不想使用此功能,可以禁用 .csproj 文件中的ImplicitUsings标志。
在上面的示例中,app.MapGet 方法使用了内联 lambda 表达式。同时还提供了:
app.MapPost()
app.MapPut()
app.MapDelete()
接下来,我们用一个简单的示例,完成一个demo;
三、完成一个Minimal APIs完整的Demo
我们以一个简单Order订单为例,通过Minimal APIs实现CRUD设计和实现:
3.1 先准备好Order类和IOrderService接口以及OrderServiceRepository
Order类:
namespace NET6
{
public class Order
{
public int ID {get;set;} public decimal Price {get;set;} public string CustomAddress {get;set;} public int State{get;set;}
}
}
IOrderService接口:
namespace NET6
{
public interface IOrderService
{
Order GetOrder(int id); void CreateOrder(Order order); void DeleteOrder(int id); void UpdateOrder(Order order);
}
}
OrderServiceRepository类,使用内存集合模拟实现数据存储层。
namespace NET6
{
public class OrderServiceRepository : IOrderService
{
static List<Order> orders = new List<Order>(); public Order GetOrder(int id)
{
return orders.FirstOrDefault(i=>i.ID == id)?? null;
} public void CreateOrder(Order order)
{
orders.Add(order);
} public void DeleteOrder(int id)
{
var order = orders.FirstOrDefault(i=>i.ID == id);
if(order!=null)
orders.Remove(order);
} public void UpdateOrder(Order order)
{
DeleteOrder(order.ID);
CreateOrder(order);
}
}
}
3.2 在Program.cs类中,注册IOrderService服务,添加AddOrder和GetOrder Http Web API
using NET6; var builder = WebApplication.CreateBuilder(args); //registe IOrderService service
builder.Services.AddScoped<IOrderService, OrderServiceRepository>(); var app = builder.Build(); app.MapGet("/", () => "Hello World!"); //add order save API
app.MapPost("/add",(Order order,IOrderService service)=>
{
service.CreateOrder(order);
}).WithName("addorder"); //add order query API
app.MapGet("/getorder",(int id, IOrderService service)=>
{
return service.GetOrder(id);
}).WithName("getorder"); app.Run();
上面的低码中,首先增加一个文件级别的namespace,这个地方为了和大家示意Global Namespace的区别
//registe IOrderService service
builder.Services.AddScoped<IOrderService, OrderServiceRepository>();
添加订单Order 保存API服务:
//add order save API
app.MapPost("/add",(Order order,IOrderService service)=>
{
service.CreateOrder(order);
}).WithName("addorder");
上面这个HttpWebAPI,我们采用了Post方式,请求是必须传入order参数。
这个代码中,我们看到保存订单方法有2个参数,一个是Order,另一个是IOrderService,第二个参数,原生支持依赖注入,不需要显式声明创建。
类似的,继续添加查询订单API服务
//add order query API
app.MapGet("/getorder",(int id, IOrderService service)=>
{
return service.GetOrder(id);
}).WithName("getorder");
3.3 运行调试
在终端中输入dotnet run指令,启动运行调试
dotnet run
调试这3个API,建议大家使用PostMan工具
先说一个小坑,一开始使用PostMan工具调试保存订单接口,将order显式地参数放到Headers中请求,结果一直不通:
看了微软的示例文档后,建议直接将order json对象,http请求体中以raw的方式发起请求
其他的API接口则没有这个问题:
好了,以上是.NET 6 Minimal APIs的一些简单介绍和实践,希望能帮助大家。
周国庆
2022/2/28
通俗理解.NET 6 Minimal APIs的更多相关文章
- 通俗理解Android事件分发与消费机制
深入:Android Touch事件传递机制全面解析(从WMS到View树) 通俗理解Android事件分发与消费机制 说起Android滑动冲突,是个很常见的场景,比如SliddingMenu与Li ...
- Effective Java通俗理解(持续更新)
这篇博客是Java经典书籍<Effective Java(第二版)>的读书笔记,此书共有78条关于编写高质量Java代码的建议,我会试着逐一对其进行更为通俗易懂地讲解,故此篇博客的更新大约 ...
- Effective Java通俗理解(下)
Effective Java通俗理解(上) 第31条:用实例域代替序数 枚举类型有一个ordinal方法,它范围该常量的序数从0开始,不建议使用这个方法,因为这不能很好地对枚举进行维护,正确应该是利用 ...
- 关于MySQL中的自联结的通俗理解
关于MySQL中的自联结的通俗理解 前言:最近在通过SQL必知必会这本书学习MySQL的基本使用,在学习中也或多或少遇到了点问题,我也正好分享给大家,我的这篇博客用到的所有表格的代码都是来自SQL必知 ...
- Effective Java通俗理解(上)
这篇博客是Java经典书籍<Effective Java(第二版)>的读书笔记,此书共有78条关于编写高质量Java代码的建议,我会试着逐一对其进行更为通俗易懂地讲解,故此篇博客的更新大约 ...
- OSI七层模式简单通俗理解
OSI七层模式简单通俗理解 这个模型学了好多次,总是记不住.今天又看了一遍,发现用历史推演的角度去看问题会更有逻辑,更好记.本文不一定严谨,可能有错漏,主要是抛砖引玉,帮助记性不好的人.总体来说,OS ...
- 通俗理解决策树中的熵&条件熵&信息增益
参考通俗理解决策树算法中的信息增益 说到决策树就要知道如下概念: 熵:表示一个随机变量的复杂性或者不确定性. 假如双十一我要剁手买一件衣服,但是我一直犹豫着要不要买,我决定买这件事的不确定性(熵)为2 ...
- CNN笔记:通俗理解卷积神经网络【转】
本文转载自:https://blog.csdn.net/v_july_v/article/details/51812459 通俗理解卷积神经网络(cs231n与5月dl班课程笔记) 1 前言 2012 ...
- 通俗理解LDA主题模型
通俗理解LDA主题模型 0 前言 印象中,最開始听说"LDA"这个名词,是缘于rickjin在2013年3月写的一个LDA科普系列,叫LDA数学八卦,我当时一直想看来着,记得还打印 ...
随机推荐
- 【Java】方法
文章目录 何谓方法 方法的定义 方法调用 方法重载 命令行传参 可变参数 递归 何谓方法 System.out.println(),是什么 Java方法是语句的集合,它们在一起执行一个功能 方法是解决 ...
- CTF-sql-order by盲注
本文章只讨论了order by盲注,关于order by的报错等注入不在本文章讨论范围,另有文章. 让我们先来看看本文章所使用的表的内容,如下图: 接下来先了解一下order by的基础知识: ord ...
- Netlib文件转化为mps文件
Netlib文件转化为mps文件 简单方法1 下载并执行: git clone https://github.com/mtanneau/Netlib_experiments.git cd Netlib ...
- 【reverse】逆向2 寄存器与内存
[reverse]逆向2 寄存器与内存 1.通用寄存器 主要用途其实没必要记下来,因为只是CPU建议你这么做. 寄存器需要按照顺序被下来 32位就是可以存32个0或1 所以存储范围就是0-0xFFFF ...
- BarTender调用示例
安装BarTender 软件后,会注册一个COM 然后在项目中添加BarTender COM 引用 BarTender模板中的条码右键属性-数据源类型-嵌入的数据-名称(比如设置为 barcode p ...
- 免密码提交gitlab
在你的用户目录下新建一个文本文件.git-credentials echo 'https://henry:123456@ggithub.com' > /root/.git-credentials ...
- Android开发-适配器
适配器非常关键,它是连接页面和和数据源之间的桥梁,通过适配器,可以将数据库中的数据显示在页面上. 记账本适配器 记账类型选择适配器 日历选择适配器 还有图标适配器等
- 分治FFT小记🐤
分治FFT:在 $O(n \log^2 n)$ 的时间内求出类似于 $f_i=\sum\limits_{j=0}^{i-1}g(i-j)f(j)$ 之类的递推式 思想:同 CDQ 分治的思想,先分成左 ...
- MySQL 新增表分区很慢,转移大表数据
问题: MySQL (version 5.7.26) 数据库有一批表 xxx_yyy,由于评估的数据量可能比较大,因此每张表都设置了表分区,把每个月的数据保存在单独的分区里. 那么如果每年年末,没有提 ...
- JS 函数提升&变量提升以及函数声明&函数表达式的区别
感谢原文作者:迟早会有猫 原文链接:https://www.cnblogs.com/SidselLoong/p/10515809.html 今天看js的变量提升问题,里面提到了函数提升.然后发现自己之 ...