創(chuàng)建ASP.NET Core MVC應(yīng)用程序(1)-添加Controller和View
參考文檔：Getting started with ASP.NET Core MVC and Visual Studio
這系列文章是參考了.NET Core文檔和源碼，可能有人要問，直接看官方的英文文檔不就可以了嗎，為什么還要寫這些文章呢？
原因如下：
- 官方文檔涉及的內(nèi)容相當(dāng)全面，屬于那種大而全的知識倉庫，不太適合初學(xué)者，很容易讓人失去重要，讓人掉入到具體的細(xì)節(jié)之中。
- 對于大多數(shù)人來講開發(fā)語言只是工具，程序員都有一個通病，就是死磕工具，把工具學(xué)深。我認(rèn)為在工具上沒有必要投入太多時間，以能高效地完成日常的工作項目為準(zhǔn)即可。要需求驅(qū)動學(xué)習(xí)，你需要什么學(xué)什么。如果你學(xué)的新技術(shù)新特性只是屠龍之技或者只需要用到的時候去查一下即可的話，這種死磕這又有什么用。沒有必要花120%的時間去學(xué)100%的知識，你只需要花20%的時間去學(xué)習(xí)80%的知識就可以了，剩下的等實際的項目中用到的時候去查就可以了,工具只是工具，不是工作本身。
- 目前基本所有的文章都是基于Windows平臺的Visual Studio IDE來介紹的。而我用的是一臺Mac，所以我將基于Mac平臺的Visual Studio Code講解適合我們實際項目中遇到的知識。
- 還有一點，就是這是我個人的學(xué)習(xí)總結(jié)。
這系列文章就是讓你去花20%的時間去學(xué)80%的東西，剩下的20%再去看官方文檔。
之前介紹了《如何在Mac下運行ASP.NET Core應(yīng)用程序》，主要是講解了如何在Mac下把ASP.NET Core跑起來，在這一篇中將進(jìn)一步分析如何添加Controller、View、Model等。
Model-View-Controller (MVC)?架構(gòu)模式將一個應(yīng)用程序分成了三大塊：Model、View、Controller。
-
Models: 用于表示應(yīng)用程序數(shù)據(jù)的類，并使用驗證邏輯來約束數(shù)據(jù)的業(yè)務(wù)規(guī)則。通常模型對象用來從數(shù)據(jù)庫獲取和存儲實體模型?數(shù)據(jù)。比如
UserModel 從數(shù)據(jù)庫獲取用戶數(shù)據(jù)，并將它交給View來顯示或者直接更新，更新后的數(shù)據(jù)再寫入到數(shù)據(jù)庫中。 - Views: 用來顯示應(yīng)用程序UI的組件，該UI會顯示Model數(shù)據(jù)。
- Controllers: 是Models和Views的一個橋梁。用來處理瀏覽器請求，獲取Model數(shù)據(jù)，并將指定視圖模板作為響應(yīng)返回給瀏覽器。視圖(View)僅僅用于顯示信息，控制器(Controller)用于處理并響應(yīng)用戶的輸入和交互。比如，Controller處理路由數(shù)據(jù)查詢字符串值，并將這些值傳遞給Model，Model再去使用這些值去查詢數(shù)據(jù)庫。
MVC模式幫助你創(chuàng)建一個關(guān)注分離的應(yīng)用程序(輸入邏輯、業(yè)務(wù)邏輯、UI邏輯),同時這個模塊之間是松耦合的。UI邏輯屬于View，輸入邏輯屬于Controller,業(yè)務(wù)邏輯屬于Model。
添加Controller
namespace MyFirstApp.Controllers
{
public class HomeController : Controller
{
// GET: /<controller>/
public IActionResult Index()
{
return View();
}
// GET: /<controller>/About
public IActionResult About()
{
ViewData["Message"] = "Your application description page.";
return View();
}
public IActionResult Contact()
{
ViewData["Message"] = "Your contact page.";
return View();
}
public IActionResult Error()
{
return View();
}
public IActionResult Welcome(string name, int id = 1)
{
ViewData["Message"] = "Hello " + name;
ViewData["id"] = id;
return View();
}
}
}
在控制器中的每一個public方法都可以作為HTTP終結(jié)點被調(diào)用。
第一個注釋表示這是一個通過在根URL添加“/Home/”進(jìn)行調(diào)用的HTTP GET方法。第二個注釋表示這是一個通過在根URL添加"/Home/About/"來進(jìn)行調(diào)用的HTTP GET方法。
MVC根據(jù)傳入的請求URL調(diào)用相應(yīng)的控制器類以及其中的Action方法，MVC默認(rèn)使用的URL路由邏輯采用類似于這樣的格式來決定具體的代碼調(diào)用：
/[Controller]/[ActionName]/[Parameters]
打開Startup.cs你會看到該項目的路由規(guī)則：
當(dāng)你不帶任何URL段(segment)直接運行該程序時，將默認(rèn)訪問“Home”控制器中的"Index"方法。
第一個URL segment決定運行哪個Controller,所以http://localhost:5000/Home映射到HomeController類；URL segment第二個部分決定類里面的Action方法。所以http://localhost:5000/Home/Index會運行HomeController類中的Index方法；URL segment的第三部分(id)是路由數(shù)據(jù)。
這里通過增加一個方法來顯示通過URL傳遞一些參數(shù)信息到Controller。
public string Welcome(string name, int id = 1)
{
return HtmlEncoder.Default.Encode($"Hello {name}, id: {id}");
}
上述代碼通過使用HtmlEncoder.Default.Encode來保護(hù)應(yīng)用免受JS的惡意輸入，并且使用了C#的新特性Interpolated Strings。
http://localhost:5000/Home/Welcome?name=Charlire&id=1
MVC的模型綁定系統(tǒng)自動將查詢字符串的命名參數(shù)映射到具體的方法中的參數(shù)，注意名稱必須一致。
上述代碼中URL segment(Parameters)沒有被使用到，參數(shù)name和id都是作為查詢字符串被傳遞的。?是一個分隔符，后面跟著的就是查詢字符串，&用來分割查詢字符串。
輸入下面的URL：http://localhost:5000/Home/Welcome/1?name=Charlire。這一次第三個URL segment將匹配到路由參數(shù)id。Welcome方法包含一個與MapRoute方法中的URL模板相匹配的id參數(shù)。隨后的?(id?)表示id參數(shù)是可選的。
添加View
通過Razor視圖引擎創(chuàng)建視圖模板文件，基于Razor的視圖模板使用 .cshtml 作為文件擴(kuò)展名，通過使用C#提供了一個優(yōu)雅的方式來創(chuàng)建HTML。
public IActionResult Index()
{
return View();
}
上面的Index方法使用視圖模板來生成一個HTML響應(yīng)給瀏覽器。Controller中的Action方法通常返回一個IActionResult（或一個派生于ActionResult 類），而不是像String這樣的基元類型。
點擊Views文件夾，在該文件夾下面新建與Controller名對應(yīng)的文件夾。
然后我們導(dǎo)航到Views->User文件夾，運行命令yo aspnet:mvcview Index在該文件夾下面生成Index.cshtml。
Index方法只是簡單地運行了return View()，來指定方法去使用一個視圖模板文件來為瀏覽器渲染最新的響應(yīng)。因為沒有顯式指定所要使用的視圖模板文件，MVC會默認(rèn)使用 /Views/User 文件夾中的 Index.cshtml。
改變視圖和布局頁面
通用點擊菜單鏈接，你會發(fā)現(xiàn)每一個頁面都顯示了相同的菜單布局，這個菜單布局位于 Views/Shared/_Layout.cshtml 文件。
Layout模板允許你在一個地方指定網(wǎng)站的HTML容器布局，并應(yīng)用到網(wǎng)站的多個頁面中。@RenderBody()是一個占位符，用來顯示你指定視圖的位置，“包裹在”布局頁面。舉個例子，當(dāng)你點擊About鏈接，Views/Home/About.cshtml視圖就會在RenderBody?方法內(nèi)渲染。
修改Layout文件中的標(biāo)題和菜單鏈接
注意現(xiàn)在每一個頁面都顯示了新修改的鏈接，通過在Layout模板中修改一次，網(wǎng)站上的所有的頁面都立即顯示成新修改的信息。
通過查看 Views/_ViewStart.cshtml 文件：
@{
Layout = "_Layout";
}
Views/_ViewStart.cshtml 文件將 Views/Shared/_Layout.cshtml 文件引入到每一個視圖中。你可以通過Layout屬性來設(shè)置一個不同的布局視圖，或?qū)⑺O(shè)置成null，那么將不使用任何一個布局文件。
修改 Views/User/Index.cshtml 文件如下：
@{
ViewData["Title"] = "User List";
}
<h2>User List</h2>
<p>Hello from View Template!</p>
ViewData["Title"] = "User List";將ViewDataDictionary的Title屬性設(shè)置為User List。這個Title屬性將用在 Views/Shared/_Layout.cshtml Layout頁面的<title>?HTML元素上。
<title>@ViewData["Title"] - User MVC Application</title>
注意 Index.cshtml 視圖模板中的內(nèi)容是怎么和 Views/Shared/_Layout.cshtml 視圖模板進(jìn)行合并的，布局模板使得修改應(yīng)用里所有的頁面很容易。
從Controller傳遞數(shù)據(jù)到View
在談到數(shù)據(jù)庫和模型(Models)之前，先讓我們討論一下從控制器傳遞信息到視圖。控制器方法會在傳入的URL請求響應(yīng)時被調(diào)用。控制器類是用于處理傳入的瀏覽器請求，從數(shù)據(jù)庫獲取數(shù)據(jù)，并最終決定哪種類型的的響應(yīng)會被回傳給瀏覽器。
控制器主要負(fù)責(zé)提供視圖模板向瀏覽器呈現(xiàn)一個響應(yīng)所需的數(shù)據(jù)或?qū)ο蟆?/p>
最佳實踐：視圖模板不應(yīng)該執(zhí)行業(yè)務(wù)邏輯或直接與數(shù)據(jù)庫進(jìn)行交互，而只應(yīng)該使用控制器提供給它的數(shù)據(jù)。保持這樣的“關(guān)注分離”有助于保持你的代碼整潔，可測試性及更易于維護(hù)。
當(dāng)前，HomeController控制器中的Welcome方法接受一個name、id參數(shù)，然后直接將值輸出到瀏覽器。我們在控制器中將使用一個視圖模板來代替字符串，視圖模板將生成一個動態(tài)響應(yīng)，這就意味著你需要通過控制器傳遞適當(dāng)?shù)臄?shù)據(jù)給視圖來生成響應(yīng)，可以讓控制器將視圖模板需要的動態(tài)數(shù)據(jù)（參數(shù)）放入ViewData字典中，隨后視圖模板可以通過訪問該字典獲取到這些數(shù)據(jù)。
ViewData字典是一個動態(tài)對象，你可以將任何你想要的數(shù)據(jù)加進(jìn)去。在你加入數(shù)據(jù)之前，ViewData對象沒有任何已定義的屬性。MVC的模型綁定系統(tǒng)自動映射地址欄中查詢字符串的命名參數(shù)到你方法中的參數(shù)。
public IActionResult Welcome(string name, int id = 1)
{
ViewData["Message"] = "Hello " + name;
ViewData["id"] = id;
return View();
}
ViewData字典對象包括將要傳遞到視圖的數(shù)據(jù)。接受，我們來創(chuàng)建一個Welcome視圖模板。
這里將在Welcome.cshtml視圖模板中創(chuàng)建一個循環(huán)。
@*
For more information on enabling MVC for empty projects, visit https://go.microsoft.com/fwlink/?LinkID=397860
*@
@{
ViewData["Title"]= "Welcome Page";
}
<h2>Welcome</h2>
<ul>
@for(int i=0; i<(int)ViewData["id"]; i++)
{
<li>@ViewData["Message"]</li>
}
</ul>
數(shù)據(jù)從URL獲得并通過MVC模型綁定器傳遞到控制器，控制器將數(shù)據(jù)打包封裝到ViewData字典中并將該對象傳遞給視圖。接著，視圖將數(shù)據(jù)以HTML的形式渲染到瀏覽器。
我們使用了一個ViewData字典來將數(shù)據(jù)從控制器傳遞到視圖，接下來我們將使用視圖模型(View Model)來實現(xiàn)相同的目的。通過View Model來傳遞數(shù)據(jù)比通過ViewData更受歡迎。
