※台中搬家公司教你幾個打包小技巧,輕鬆整理裝箱!
還在煩惱搬家費用要多少哪?台中大展搬家線上試算搬家費用,從此不再擔心「物品怎麼計費」、「多少車才能裝完」
0. 前言
在上一篇文章中,我們初步介紹了asp.net core,以及如何創建一個mvc項目。從這一篇開始,我將為大家展示asp.net core 的各種內容,並且嘗試帶領大家來挖掘其中的內在邏輯。
當然,那是以後的事情。這一篇將通過自定義一個控制器來為大家介紹asp.net core mvc 中控制器和路由的相關知識。
1. 控制器
先在Controllers目錄下添加一個類,名叫:
public class DemoController
{
public string Index()
{
return "你好";
}
}
訪問地址:
http://localhost:5006/demo/index
如果不出意外的話,你應該能看到網頁上的“你好”兩個字。
再新建一個類:
using Microsoft.AspNetCore.Mvc;
public class NoContrl : Controller
{
public IActionResult Index()
{
return Content("Test");
}
}
結合兩個不常規的控制器類,讓我們初窺asp.net core MVC是如何識別控制器的。這正是我之前說的,約定優於配置最好的體現。這個哲學最早也是為MVC提出來的,後來被.net framework引申到各個方面。
asp.net core mvc識別控制器,會在項目中發現 以Controller結尾的公開類或者繼承自Controller的公開類,並將這些類標記為控制器。當接到用戶或者界面轉交的請求時,程序從請求路徑中解析出控制器名稱,然後尋找 <控制器>Controller 或者 <控制器> : Controller 的類。
在默認情況下,一個訪問URL會在程序中解析成如下格式:
http://<HOST>:<PORT>/<Controller>/<Action>[其他參數]
在上文中,我們知道了控制器的解析規則,那麼現在看一下Action的解析規則:
在DemoController中添加如下方法:
public int TestInt()
{
return 10;
}
public object TestObject()
{
return new
{
Name = "TestObject",
Age = 1
};
}
public string TestPublic()
{
return "成功訪問 TestPublic";
}
protected string TestProtect()
{
return "成功訪問 TestProtect";
}
private string TestPrivate()
{
return "成功訪問 TestPrivate";
}
重新啟動,后依次訪問如下地址:
http://localhost:5006/Demo/TestInt
http://localhost:5006/Demo/TestObject
http://localhost:5006/Demo/TestPublic
http://localhost:5006/Demo/TestProtect
http://localhost:5006/Demo/TestPrivate
然後可以看到,TestInt、TestObject以及TestPublic均能正常訪問,但TestProtect和TestPrivate都提示找不到網頁或無法訪問。
可以看到,對於程序而言,Action就是控制器類里的公開類方法,與方法的返回值無關。也就是說,程序會找到 XXXController 或者名為XXX但繼承了Controller的類作為XXX的控制器,然後繼續在這個類里尋找到Action,如果沒有找到就會返回404的請求。
2. 路由
在第一節中,我們介紹了一下asp.net core mvc如何尋找控制器和Action,那這一節將介紹程序如何從請求鏈接中解析出控制器和Action的名稱,也就是路由映射。
路由(Routing)負責匹配傳入的HTTP請求,然後將這些請求發送給應用的可執行終結點。終結點是應用的可執行請求處理代碼單元,也就是我們控制器里的方法(Action)。
2.1 路由的配置
對於所有的asp.net core模板都包括生成在代碼中的路由。通常,我們要求路由在Startup.Configure
方法中進行配置。
注意,Startup類里有且只有一個Configure方法,不能出現其重載版本。
該方法的聲明一般情況如下:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env);
如果想要設置路由,需要先註明項目啟用路由:
※推薦台中搬家公司優質服務,可到府估價
台中搬鋼琴,台中金庫搬運,中部廢棄物處理,南投縣搬家公司,好幫手搬家,西屯區搬家
app.UseRouting();
然後使用如下方法配置路由:
app.UseEndpoints(endpoints =>
{
// 配置路由
});
通常對於mvc項目而言,我們一般使用如下方式配置路由:
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
這行代碼的意思是:創建一個名字為 default 的映射控制器的路由,映射規則為 {controller}/{action}/{id?},也就是第一個為控制器,第二個為Action,第三個是ID,其中ID可以不存在,當Action無法從請求地址中解析出來時默認為Index,控制器默認為Home。
通過這個解析,我們可以得知 我們之前訪問的
http://localhost:5000/
是哪個控制器里的什麼方法來處理了——HomeController.Index。
那麼我們修改一下HomeController.Index來驗證一下,我們理解是否有誤:
public IActionResult Index()
{
return View();
}
// 修改為
public IActionResult Index()
{
return Content("測試");
}
重新運行程序,訪問
http://localhost:5000/
然後看到頁面出現:測試字樣,可以看到路由系統自動為我們補全了控制器名和action名。如果方法中出現參數,則自動按照參數名1=值1&參數名2=值2這種形式查看參數。Id為特殊的,會自動按照目錄其映射。所以:
http://localhost:5000/控制器1/方法1/id值
http://localhost:5000/控制器1/方法1?id=id值
是一個請求鏈接。
2.2 添加路由配置
那麼,我們回過頭來看一下聲明路由的方法:
public static ControllerActionEndpointConventionBuilder MapControllerRoute(this IEndpointRouteBuilder endpoints, string name, string pattern, object defaults = null, object constraints = null, object dataTokens = null);
默認情況下,我們不會設置 defaults、constraints、dataTokens,這三個參數都有含義,這裏不對后兩個做介紹,簡單介紹一下第一個:
在路由配置的方法里,添加以下內容:
endpoints.MapControllerRoute(
name : "test",
pattern: "DemoTest/{action=Index}/{id?}",
defaults : new
{
Controller = "Demo",
});
至此,我們沒有創建名為DemoTest的控制器,但是我們在訪問:
http://localhost:5006/DemoTest
仍然能得到響應,而且控制器被解析為Demo。
這就是defaults的意義,路由在解析的時候,系統會把defaults中的值自動填充到路由連接中沒有設置的值里。
當我們設置多個路由的時候,路由系統會優先嘗試匹配最容易解析的配置。比如說,當我們訪問:
http://localhost:5000/DemoTest/
的時候,路由系統會優先從名為test的配置表中解析,只有當無法從這裏找到時才會從其他路由中解析。
3. 總結
這一篇我們簡單介紹了控制器與路由映射,可以訪問我們自己添加的路由。在開發中,通常情況下,創建的控制器都是以Controller結尾並繼承Controller類。這是因為Controller類有很多有用的屬性和方法供我們使用,以Controller結尾是為了統一規則,可以讓我們一眼看出哪些是控制器。
更多內容煩請關注我的博客《高先生小屋》
本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
※台中搬家公司教你幾個打包小技巧,輕鬆整理裝箱!
還在煩惱搬家費用要多少哪?台中大展搬家線上試算搬家費用,從此不再擔心「物品怎麼計費」、「多少車才能裝完」