ASP.NET Core 6 Minimal API

ASP.NET Core 6 Minimal API

Intro

微軟在 ASP.NET 6 Preview 4 的介紹文章中介紹了即將到來的 ASP.NET Core 6 中的最小 API 的雛形簿废,我們現(xiàn)在已經(jīng)基本可以達(dá)到最小化 API 了雛形了瘾敢,在 Preview 4 的時候就寫了這個小示例砚尽,但是不夠簡潔罗岖,沒有達(dá)到最簡潔的代碼固该,現(xiàn)在在 Preview 5 上嘗試一下,感覺已經(jīng)很簡潔了递鹉,于是就想分享一下

Sample-0

在 Preview 4 的時候藏斩,示例是下面這樣的:

using?System;
using?Microsoft.AspNetCore.Builder;

var?app?=?WebApplication.Create(args);
app.Map("/",?(Func<string>)(()?=>?"Hello?World"));
app.Run();

主要是使用了新增的 WebApplication/WebApplicationBuilder API狰域,然后結(jié)合了 C# 9 中的 Top-Level Statement,去掉了 Main 方法的聲明

C# 10 New Features

在即將到來 C# 10 中的兩個新特性可以幫助我們簡化這個特性屈溉,分別是:

  • global using
  • lamdba 優(yōu)化

通過 global using 這個 feature 我們可以實現(xiàn)命令空間的統(tǒng)一管理這樣就可以避免寫很多 namespace 的引用了抬探,我們可以把常用的 namespace 放在一個文件中管理小压,類似于 MVC 中的 _ViewImports.cshtml 和 Razor Page 中的 _Imports,這樣就可以簡化上面的 using 了仪搔,之前看介紹說是蜻牢,ASP.NET Core 6 會把 ASP.NET Core 相關(guān)的常用的命令空間通過 global using 的方式默認(rèn)引用,這樣上面的示例中就不需要再引用命名空間了煮嫌。

另外一個 feature 則是對于 lambda 表達(dá)式的優(yōu)化立膛,可以自動進行類型推斷來隱式的轉(zhuǎn)換成委托,就可以簡化上面強制類型轉(zhuǎn)換成 Func<string> 了好啰,就可以自動的隱式轉(zhuǎn)換了,

除此之外鳄抒,我們還可以方便的在 lamdba 表達(dá)式上加 Attribute 注解许溅,這有助于大大簡化 API 書寫的復(fù)雜度,具體看后面的示例吧

Sample-1

使用 C# 10 新特性之后的代碼:

var?app?=?WebApplication.Create(args);
app.Map("/",?()?=>?"Hello?World");
app.Run();

主要有兩點變化茬祷,一個是 Func<string> 的轉(zhuǎn)換不再需要了并蝗,一個是命名空間的引用滚停,會放在一個單獨 Imports 文件中添加全局的命名空間引用

Imports 內(nèi)容如下:

global?using?System;
global?using?System.Collections.Generic;
global?using?System.Linq;
global?using?System.Threading.Tasks;
global?using?Microsoft.AspNetCore.Builder;
global?using?Microsoft.AspNetCore.Http;
global?using?Microsoft.AspNetCore.Mvc;
global?using?Microsoft.AspNetCore.Hosting;
global?using?Microsoft.AspNetCore.Routing;
global?using?Microsoft.Extensions.DependencyInjection;
global?using?Microsoft.Extensions.Hosting;
global?using?Microsoft.Extensions.Logging;
global?using?Microsoft.Extensions.Configuration;

上面提到了我們可以很方便在 lamdba 表達(dá)式上使用 Attribute键畴,下面我們就來一個例子:

var?app?=?WebApplication.Create(args);
app.MapPost("/info",?[HttpPost](IWebHostEnvironment?env)?=>?new?
{
????Time?=?DateTime.UtcNow,
????env.EnvironmentName?
});
app.Run();

除了 Attribute,我們還可以添加參數(shù)涡贱,參數(shù)可以自動從依賴注入服務(wù)中獲取盼产,如上面的 IWebHostEnvironment

接著我們來測試一下我們的 API 看試試 work 了吧勺馆,現(xiàn)在我們已經(jīng)可以使用 dotnet watch 來運行項目,會自動啟用 Hot Reload灌灾,但是測試發(fā)現(xiàn)锋喜,感覺現(xiàn)在的 ASP.NET Core 里的 Hot Reload豌鸡,還是有點問題,需要使用 Ctrl + R 來重新 build 才能生效涯冠,不知道是不是我姿勢不對蛇更,不知道大家有沒有遇到這樣的問題赛糟,希望后面的版本能夠解決這個問題

可以通過 dotnet watch 來啟動項目

接著我們就可以通過 http://localhost:5000 或者 https://localhost:5001 來訪問我們的 API 了

訪問 http://localhost:5000,會看到下面的結(jié)果

直接訪問 http://localhost:5000/info司倚,會看到類似下面的結(jié)果字旭,這是因為我們的 info API 只允許 POST 方式進行訪問

通過工具用 POST 方式訪問 http://localhost:5000/info遗淳,可以看到類似下面的結(jié)果

可以看到我們的 API 都已經(jīng)正常工作了~~

More

上面的示例代碼可以在 Github 上獲取 https://github.com/WeihanLi/SamplesInPractice/tree/master/net6sample/MininalAPI

編譯需要安裝 .NET 6 ?preview 5 環(huán)境

目前 .NET 6 Preview 還是有一些問題的屈暗,還不太建議大家實際項目進行升級养叛,當(dāng)然自己想嘗試是可以的

如果使用遇到了什么問題弃甥,也可以通過 Github 上的 issue 向微軟反饋 https://github.com/dotnet/core/issues/6389

References

  • https://devblogs.microsoft.com/aspnet/asp-net-core-updates-in-net-6-preview-4/
  • https://github.com/WeihanLi/SamplesInPractice/tree/master/net6sample/MininalAPI

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末淆攻,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子啸箫,更是在濱河造成了極大的恐慌忘苛,老刑警劉巖扎唾,帶你破解...
    沈念sama閱讀 222,378評論 6 516
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件胸遇,死亡現(xiàn)場離奇詭異西乖,居然都是意外死亡,警方通過查閱死者的電腦和手機薄腻,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,970評論 3 399
  • 文/潘曉璐 我一進店門尽纽,熙熙樓的掌柜王于貴愁眉苦臉地迎上來弄贿,“玉大人,你說我怎么就攤上這事差凹∥D颍” “怎么了谊娇?”我有些...
    開封第一講書人閱讀 168,983評論 0 362
  • 文/不壞的土叔 我叫張陵,是天一觀的道長攀例。 經(jīng)常有香客問我,道長挖胃,這世上最難降的妖魔是什么酱鸭? 我笑而不...
    開封第一講書人閱讀 59,938評論 1 299
  • 正文 為了忘掉前任凹髓,我火速辦了婚禮蔚舀,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘狼牺。我一直安慰自己是钥,他們只是感情好缅叠,可當(dāng)我...
    茶點故事閱讀 68,955評論 6 398
  • 文/花漫 我一把揭開白布悄泥。 她就那樣靜靜地躺著,像睡著了一般肤粱。 火紅的嫁衣襯著肌膚如雪弹囚。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,549評論 1 312
  • 那天狼犯,我揣著相機與錄音余寥,去河邊找鬼。 笑死悯森,一個胖子當(dāng)著我的面吹牛宋舷,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播瓢姻,決...
    沈念sama閱讀 41,063評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼祝蝠,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了幻碱?” 一聲冷哼從身側(cè)響起褥傍,我...
    開封第一講書人閱讀 39,991評論 0 277
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后摆屯,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體准验,經(jīng)...
    沈念sama閱讀 46,522評論 1 319
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,604評論 3 342
  • 正文 我和宋清朗相戀三年蓖扑,在試婚紗的時候發(fā)現(xiàn)自己被綠了潭流。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,742評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡股耽,死狀恐怖炎滞,靈堂內(nèi)的尸體忽然破棺而出丽惭,到底是詐尸還是另有隱情柜砾,我是刑警寧澤证芭,帶...
    沈念sama閱讀 36,413評論 5 351
  • 正文 年R本政府宣布蝇完,位于F島的核電站氢架,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜拓售,卻給世界環(huán)境...
    茶點故事閱讀 42,094評論 3 335
  • 文/蒙蒙 一值骇、第九天 我趴在偏房一處隱蔽的房頂上張望使碾。 院中可真熱鬧,春花似錦、人聲如沸祟剔。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,572評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽蓉冈。三九已至家夺,卻和暖如春惨好,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,671評論 1 274
  • 我被黑心中介騙來泰國打工葬燎, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 49,159評論 3 378
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親纪蜒。 傳聞我的和親對象是個殘疾皇子窗看,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,747評論 2 361

推薦閱讀更多精彩內(nèi)容