"HelloWorld!");app.Run;在上面的示例中,app.MapGet方法使用了内联lambda表达式,完成一个ControllerAction的业务逻辑,真的是超简单。超简单完成一个HTTPW" />

通俗理解.NET 6 Minimal APIs

您所在的位置:网站首页 webapi什么意思 通俗理解.NET 6 Minimal APIs

通俗理解.NET 6 Minimal APIs

#通俗理解.NET 6 Minimal APIs| 来源: 网络整理| 查看: 265

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 看看里面的内容,有一个配置:

enable

dotnet build 后,找到 obj/Debug/net6.0 文件夹以查看隐藏的自动生成文件 - [ProjectName].GlobalUsings.g.cs。使用一个单独的类来将所有 using 语句保存在一个地方。

这个功能,让我们不需要在每个文件中重复声明命名空间的 using 引用了。的确很方便、简单了。

当然,如果不想使用此功能,可以禁用 .csproj 文件中的 ImplicitUsings 标志。

在上面的示例中,app.MapGet 方法使用了内联 lambda 表达式。同时还提供了:

app.MapPost

app.MapPut

app.MapDelete

接下来,我们用一个简单的示例,完成一个 demo。

Tutorial: Create a minimal web API with ASP.NET Core

完成一个 Minimal APIs 完整的 Demo

我们以一个简单 Order 订单为例,通过 Minimal APIs 实现 CRUD 设计和实现:

▌先准备好 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 接口:

namespaceNET6{publicinterfaceIOrderService{Order GetOrder( intid ) ;

voidCreateOrder( Order order) ;

voidDeleteOrder( intid ) ;

voidUpdateOrder( Order order) ; }}

OrderServiceRepository 类,使用内存集合模拟实现数据存储层。

namespaceNET6{publicclassOrderServiceRepository: IOrderService{staticList orders = newList;

publicOrder GetOrder( intid ) {returnorders.FirstOrDefault(i=>i.ID == id)?? null; }

publicvoidCreateOrder( Order order) {orders.Add(order);}

publicvoidDeleteOrder( intid ) {varorder = orders.FirstOrDefault(i=>i.ID == id); if(order!= null) orders.Remove(order);}

publicvoidUpdateOrder( Order order) {DeleteOrder(order.ID);CreateOrder(order);}}}

▌在 Program.cs 类中,注册 IOrderService 服务,添加 AddOrder 和 GetOrder Http Web API

using NET6;

var builder = WebApplication.CreateBuilder(args);

//registe IOrderService servicebuilder.Services.AddScoped;

var app = builder.Build;

app.MapGet("/", => "Hello World!");

//add order save APIapp.MapPost("/add",(Order order,IOrderService service)=>{ service.CreateOrder(order);}).WithName("addorder");

//add order query APIapp.MapGet("/getorder",(int id, IOrderService service)=>{ return service.GetOrder(id);}).WithName("getorder");

app.Run;

上面的低码中,首先增加一个文件级别的 namespace,这个地方为了和大家示意 Global Namespace 的区别

using NET6;

然后,在 ASP.NET DI 依赖注入框架中添加 IOrderService 服务:

//registe IOrderService servicebuilder.Services.AddScoped;

添加订单 Order 保存API 服务:

//add order save APIapp.MapPost("/add",(Order order,IOrderService service)=>{ service.CreateOrder(order);}).WithName("addorder");

上面这个 HttpWebAPI,我们采用了 Post 方式,请求是必须传入 order 参数。

这个代码中,我们看到保存订单方法有2个参数,一个是 Order,另一个是 IOrderService,第二个参数,原生支持依赖注入,不需要显式声明创建。

类似的,继续添加查询订单 API 服务

//add order query APIapp.MapGet("/getorder",(int id, IOrderService service)=>{ return service.GetOrder(id);}).WithName("getorder");

▌运行调试

在终端中输入 dotnet run 指令,启动运行调试

dotnet run

调试这3个 API,建议大家使用 PostMan 工具

先说一个小坑,一开始使用 PostMan 工具调试保存订单接口,将 order 显式地参数放到 Headers 中请求,结果一直不通:

看了微软的示例文档后,建议直接将 order json 对象,http 请求体中以 raw 的方式发起请求

其他的 API 接口则没有这个问题:

以上是.NET 6 Minimal APIs 的一些简单介绍和实践,希望能帮助大家。

微软最有价值专家(MVP)

微软最有价值专家是微软公司授予第三方技术专业人士的一个全球奖项。29年来,世界各地的技术社区领导者,因其在线上和线下的技术社区中分享专业知识和经验而获得此奖项。

MVP是经过严格挑选的专家团队,他们代表着技术最精湛且最具智慧的人,是对社区投入极大的热情并乐于助人的专家。MVP致力于通过演讲、论坛问答、创建网站、撰写博客、分享视频、开源项目、组织会议等方式来帮助他人,并最大程度地帮助微软技术社区用户使用 Microsoft 技术。

更多详情请登录官方网站:

https://mvp.microsoft.com/zh-cn

谢谢你读完了本文~相信你一定有一些感想、观点、问题想要表达。欢迎在评论区畅所欲言,期待听到你的“声音”哦!

同时,喜欢的内容也不要忘记转发给你的小伙伴们,谢谢你的支持!

关注微软中国MSDN

使用ASP.NET Core创建Minimal Web API教程 返回搜狐,查看更多



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3