1. 程式人生 > >MVC 5 + EF6 完整教程16 -- 控制器詳解

MVC 5 + EF6 完整教程16 -- 控制器詳解

cpp tpc 當我 出了 多個 展現 dts model類 路由規則

Controller作為持久層和展現層的橋梁, 封裝了應用程序的邏輯,是MVC中的核心組件之一。

本篇文章我們就來談談 Controller, 主要討論兩個方面:

  • Controller運行機制簡介
  • Controller數據傳遞方式

Controller運行機制簡介

實現自定義的Controller

我們自己要實現一個控制器有兩種方法:
一種是繼承IController接口,一種是繼承Controller或ControllerBase.
Controller繼承了ControllerBase, 另外Controller和ControllerBase本身也繼承了IController,總之需要實現IController接口.
首先我們到XEngine中隨便打開一個Controller, 例如AccountController,
可以看到新建Controller時,腳手架幫我們繼承了Controller類
技術分享

我們逐級查看,如下幾張圖,右鍵 轉到Controller定義--> 查看ControllerBase定義 --> 查看IController定義,可以看到Controller需要實現IController中Execute方法。
技術分享
技術分享
技術分享

接下來,我們就新建一個類MyCustomController,繼承IController接口,實現Execute方法。

namespace XEngine.Web.Controllers
{
    public class MyCustomController:IController
    {
        public void Execute(RequestContext requestContext)
        {
            requestContext.HttpContext.Response.Write("Hello world.");
        }
    }
}

運行http://localhost/XEngine/mycustom,可以看到瀏覽器輸出了Hello world.

MVC框架將實現IController接口的類當作一個控制器,根據路由規則將請求發送給它。
上例中,我們使用到了RequestContext的HttpContext屬性,該屬性用來獲取有關HTTP請求的信息。
RequestContext另外還有一個屬性RouteData,用來獲取請求路由的信息,例如可以通過如下方式可以獲得controller和action的名稱:
requestContext.RouteData.Values["controller"].ToString();
requestContext.RouteData.Values["action"].ToString();
實現IController接口的控制器需要負責處理請求的各個方面,包括生成對客戶端的響應。
實際應用中我們像腳手架一樣直接繼承System.Web.Mvc.Controller就可以了,這種方式我們就不需要自己實現Execute方法來輸出內容了,可以通過MVC Framework的action results來解決這個問題。
我們先舉個例子,看看我們原來一直使用的ActionReslut生成響應的方式,例如

public ActionResult NativeOutput()
{
    return Redirect("~/Account/Login");
}

Action 方法不直接使用Response對象,而是返回ActionResult類型的對象。ActionResult類描述了response的類型,比如返回一個view或跳轉到另外一個頁面。
當MVC Framework從一個action方法接收一個ActionResult對象時,會調用那個對象的ExecuteResult方法。

namespace System.Web.Mvc
{
    // 摘要: 
    //     表示操作方法的結果。
    public abstract class ActionResult
    {
        // 摘要: 
        //     初始化 System.Web.Mvc.ActionResult 類的新實例。
        protected ActionResult();

        // 摘要: 
        //     通過從 System.Web.Mvc.ActionResult 類繼承的自定義類型,啟用對操作方法結果的處理。
        //
        // 參數: 
        //   context:
        //     用於執行結果的上下文。上下文信息包括控制器、HTTP 內容、請求上下文和路由數據。
        public abstract void ExecuteResult(ControllerContext context);
    }
}

我們通過一個自定義的ActionResult實現來演示工作機制, 模擬實現這個簡單的跳轉功能, ExecuteResult實現如下:

namespace XEngine.Web.Utility
{
    public class CustomRedirectResult:ActionResult
    {
        public string Url { get; set; }
        public override void ExecuteResult(ControllerContext context)
        {
            string fullUrl = UrlHelper.GenerateContentUrl(Url, context.HttpContext);
            context.HttpContext.Response.Redirect(fullUrl);
        }
    }
}

在Controller中使用

public CustomRedirectResult CustomOutput()
{
    return new CustomRedirectResult { Url = "~/Account/Login" }; 
}

可以看到,實現了同樣的效果。

內置的action result 類型

類似於我們實現的CustomRedirectResult,MVC框架包含一些內置的action result類型,所有這些類型都繼承於ActionReslut類型。如下列表:
https://msdn.microsoft.com/en-us/library/system.web.mvc.actionresult.aspx
技術分享

我們具體使用時可以明確指明返回類型,如

public ViewResult xxx()
{  xxx }

或統一返回 ActionResult, 如

public ActionResult xxx()
{  xxx }

一般我都是籠統的返回 ActionResult,這樣比較方便。(另外具體實現時,一個Action也可能根據不同情況返回不同種類的ActionResult,沒辦法明確返回類型)
上面這張表格, HttpStatusCodeResult、 HttpUnauthorizedResult、 EmptyResult這三個Action Result是沒有Helper Method的.
類似於我們自定義的CustomRedirectResult,使用時需要使用字面量來明確返回結果。下面看例子:
可以使用HttpStatusCodeResult 類將一個特定的HTTP狀態碼發送給瀏覽器。下面看下HttpStatusCodeResult的例子,返回特定的HTTP結果碼:
這個類沒有具體的控制器輔助方法,因此必須對這個類進行實例化。

public HttpStatusCodeResult StatusCode()
{
    return new HttpStatusCodeResult(404, "URL cannot beserviced");
}

技術分享

401和404是HttpStatusCodeResult的兩個特例:
可以使用HttpNotFoundResult類取得上面的404效果

public HttpStatusCodeResult NotFoundStatusCode()
{
    return HttpNotFound();
}

發送401結果,通常是把用戶重定向到認證頁面

public HttpStatusCodeResult UnauthorizedStatusCode()
{
    return new HttpUnauthorizedResult();
}

可以看到,運行後跳轉到認證頁面
技術分享

數據的傳遞方式

我們討論下一話題:MVC中常用的傳遞數據方式。(傳統的Session, Cookie傳遞方式還可以繼續用,就不再做介紹了)
我們使用到的數據傳遞主要有 view到controller, controller到view, 跨view間的數據傳遞三種。下面我們分別加以說明。

一、 Controller接收View數據

Controller 經常需要訪問來自輸入請求的數據,如查詢字符串值、表單值,以及路由系統根據輸入URL解析所得到的參數。訪問這些數據有兩個主要途徑:
1、通過context(和ASP.NET 之前版本的技術類似,如我們熟悉的Request)
2、通過action方法的參數(包括模型綁定),(MVC框架自動檢查上下文給這些參數賦值)
這兩個方式都很常用,我們來依次講解。

通過 Context獲取數據

當我們通過繼承ControllerBase類創建controller時, 我們可以利用context對象的一組屬性來獲取請求的相關信息, 如Request, Response, RouteData, HttpContext和Server.
常用的歸納如下表:
技術分享

這些使用方法有些之前的文章已經介紹過,其他的在用到時再介紹,就不重復說明了。

通過action方法的參數(利用模型綁定)

通過參數的方法可讀性更好。
如下的重寫例子,我們先用context讀取表單值,再改寫成參數方式讀取。
先定義一個View

@{
    Layout = null;
}

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>GetDataFromView</title>
</head>
<body>
    <h1>@ViewBag.Name</h1>
    <form method="post"  >
        <input name="name" value="Tony"/>
        <input type="submit" value="提交表單" />
    </form>
</body>
</html>

通過context讀取

public ActionResult GetDataFromView()
{
    ViewBag.Name = Request.Form["name"];
    return View();
}

改成通過參數讀取

public ActionResult GetDataFromView(string name)
{
    ViewBag.Name = name;
    return View();
}

點擊按鈕後,均返回如下頁面:
技術分享

通過自動檢查上下文對象和屬性,MVC框架會給action method 參數提供值,這些對象包括Request.QueryString, Request.Form 和 RouteData.Values
模型綁定是MVC推薦的方式,個人感覺可以使代碼更加幹凈。原理是通過Value Provider ? Model Binder 兩個組件。
有一組內建的 Value Provider,它們會抓取Request.Form, Request.QueryString, Request.Files以及 RouteData.Values的數據項,然後將這些值傳遞給Model Binder,嘗試將這些數據映射為action method參數的數據類型。
當然參數也可以是一個model, 這種方式前面文章已經使用多次,不再重復舉例。

二、Controller傳遞數據到View

直接將對象作為View的參數即可(即傳遞一個view model object)。

public ActionResult DateOutput()
{
    DateTime date = DateTime.Now;
    return View(date);
}
在View中使用Model關鍵字來訪問
@{
    ViewBag.Title = "Index";
}

<h2> DateOutput </h2>

The day is: @(((DateTime)Model).DayOfWeek)

技術分享

這種視圖是無類型視圖。該視圖不知道關於視圖模型的任何情況,而把它作為object的一個實例來看待。
可以通過創建強類型視圖來明確model類型,在強類型視圖中包含視圖模型對象類型的詳細信息。

@model DateTime

@{
    ViewBag.Title = "Index";
}

<h2>DateOutput</h2>

The day is: @Model.DayOfWeek

註意:指定模型類型是需要小寫的 m, 讀取時用大寫的 M

使用ViewBag

之前也用過多次,不再贅述。
個人認為ViewBag最大的一個優點是它便於將多個對象發送給視圖。

三、跨請求傳遞

前面兩種請求方式都在一輪請求應答中。
還有一種跨請求的情況,例如重定向導致瀏覽器遞交新的HTTP請求。
如果需要將一個請求的數據傳遞到下一個請求,這種情況可以使用TempData.
使用時直接按Session一樣的語法就可以了。
TempData和Session的區別是,當讀取TempData值時,值就會被標記為待刪除,
當請求結束後就會被刪除。
有兩個小技巧:
1、利用Peek方法,可以得到TempData的值,而不把它標記為刪除

DateTime time = (DateTime)TempData.Peek("Date");

2、利用Keep方法,可以保留一個將被刪除的值

TempData.Keep("Date");

Keep方法不會永久保護一個值。如果這個值被再次讀取,它將被再次標記為刪除。

總結

關於Controller需要了解常用的ActionResult類型,掌握數據的傳遞的幾種方式。
歡迎大家多多評論,祝 學習進步:)

MVC 5 + EF6 完整教程16 -- 控制器詳解