（9）ASP.NET Core 中的MVC路由（二）

 1.URL生成

MVC應用程序可使用路由的URL生成功能，生成指向操做（Action）的URL連接。 IUrlHelper 接口用於生成URL，是MVC與路由之間的基礎部分。在控制器、視圖和視圖組件中，可經過Url屬性找到IUrlHelper的實例。在此示例中，將經過Controller.Url屬性使用IUrlHelper接口來生成指向另外一項操做的URL。

public class HomeController : Controller
{
    public IActionResult Index()
    {
        var url1= Url.Action("Privacy");//Url:Home/Privacy
        var url2 = Url.Action("Error");//Url:Home/Error
        var url3 = Url.Action("Article");//Url:Blog/Article
        var msg = $"url1: {url1}";
        msg += $"\r\nurl2: {url2}";
        msg += $"\r\nurl3: {url3}";
        return Content(msg);
    }
    [HttpGet("custom/url/to/privacy")]//定義一個路由模版
    public IActionResult Privacy()
    {
        return View();
    }
    public IActionResult Error(string code)
    {
        return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
    }
}

響應結果：

若是Url.Action方法都只設置Action名稱，那麼IUrlHelper接口會獲取經過指向當前所在控制器裏存在的Action操做，而後生成URL。若是當前控制器裏Action操做自定義路由模版，則會生成對應路由模版URL。若是Action不存在當前控制器裏，則會生成空字符串的URL。

2.URL生成方式

2.1根據操做名稱生成URL

Url.Action (IUrlHelper. Action) 能夠經過指定控制器（Controller）名稱和操做（Action）名稱來生成要連接的內容。而重載方法裏還包含添加路由值對象，好比Url.Action("Home", "Index", new { id = 17 })，此處路由值對象就是new { id = 17 }（路由值對象一般是匿名類型的對象）。下面咱們經過示例來看看：

public class HomeController : Controller
{
    public IActionResult Index(int id)
    {
        var url = Url.Action("Index", "Home", new { id = 17, color = "red", sex = "m" });
        return View();
    }
}

經過DEBUG查看生成URL：

 

2.2根據路由生成URL

上面的代碼演示瞭如何經過傳入控制器和操做名稱來生成URL。IUrlHelper還提供 Url.RouteUrl系列的方法。這些方法相似於Url.Action，但它們不會將action和controller的當前值複製到路由值。最多見的用法是指定一個路由名稱，以使用特定路由來生成URL，一般不指定控制器或操做名稱。

public class HomeController : Controller
{
    public IActionResult Index(int id)
    {
        var url = Url.RouteUrl("Privacy_Name");
        return View();
    }
    [HttpGet("custom/url/to/privacy",Name = "Privacy_Name")]//定義一個路由模版
    public IActionResult Privacy()
    {
        return View();
    }
}

經過DEBUG查看生成URL：

2.3在HTML中生成URL

IHtmlHelper提供HtmlHelper方法Html.BeginForm和Html.ActionLink，可分別生成<form>和 <a>元素。這些方法使用Url.Action方法來生成URL，而且採用類似的參數。HtmlHelper的配套Url.RouteUrl爲Html.BeginRouteForm和Html.RouteLink，二者具備類似的功能。

@using (Html.BeginForm("Article", "Blog", FormMethod.Get, new { name = "nForm", id = "idForm" })){}
@Html.ActionLink("Article", "Article", "Blog")

經過瀏覽器工具查看生成HTML：

2.4在操做結果中生成URL

以上示例展現瞭如何在控制器中使用IUrlHelper。不過，控制器中最多見的用法是將URL生成爲操做結果的一部分。ControllerBase和Controller基類爲操做結果提供簡便的方法來引用另外一項操做。一種典型用法是在接受用戶輸入後進行重定向。

public IActionResult Edit(int id, Customer customer)
{
    if (ModelState.IsValid)
    {
        // Update DB with new details.
        return RedirectToAction("Index");
    }
    return View(customer);
}

3.區域（Area）

區域是ASP.NET功能，它提供了一種將ASP.NET Core Web應用程序劃分爲更小的功能組的方法，每一個功能組都有本身的一組Razor Pages、控制器（Controllers）、視圖（Views）和模型（Models）。區域其實是應用程序內的結構。在ASP.NET Core Web項目中，Pages、模型、控制器和視圖等邏輯組件保存在不一樣的文件夾中。ASP.NET Core運行時使用命名約定來建立這些組件之間的關係。對於大型應用程序，將應用程序區分爲獨立的高級功能區域可能更有利。例如，具備多個業務單位（如結帳、計費、搜索等）的電子商務應用程序。每一個單位都有本身的區域，以包含視圖、控制器、Razor Pages和模型。下面的示例咱們根據採購（Purchase）和銷售（Sale）訂單兩個業務場景在MVC中配置使用默認傳統路由和區域路由：

public class Startup
{  
    public void Configure(IApplicationBuilder app)
    {
        app.UseMvc(routes =>
        {
            routes.MapAreaRoute(
                name: "MyAreaPurchase",
                areaName: "Purchase",
                template: "Purchase/{controller}/{action}/{id?}");
            routes.MapAreaRoute(
                name: "MyAreaSale",
                areaName: "Sale",
                template: "Sale/{controller}/{action}/{id?}");
            routes.MapRoute(
                name: "default",
                template: "{controller=Home}/{action=Index}/{id?}");
            //等價於
            //routes.MapAreaRoute("purOrder_route", "Purchase",
            //"Purchase/{controller}/{action}/{id?}");
            //routes.MapAreaRoute("saleOrder_route", "Sale",
            //"Sale/{controller}/{action}/{id?}");
            //routes.MapRoute("default", "{controller=Home}/{action=Index}/{id?}");
        });
    }
}

在上面的示例中，路由值將與如下操做匹配：

[Area("Purchase")]
public class PurOrderController : Controller
{
    public IActionResult Index()
    {
        return View();
    }
}
[Area("Sale")]
public class SaleOrderController : Controller
{
    public IActionResult Index()
    {
        return View();
    }
}

在每一個控制器加入AreaAttribute屬性是表示該控制器是某個區域的一部分，比方說，PurOrderController控制器位於Purchase區域中，SaleOrderController控制器位於Sale區域中。 而沒有 [Area] 屬性的控制器不是任何區域的成員，在路由提供area路由值時不匹配時，打開對應控制器下的視圖時將沒法打開。在上面的示例中，只有所列出PurOrderController、SaleOrderController控制器下視圖Index的路由值 { area = Purchase, controller = PurOrder, action = Index } 、{ area = Sale, controller = SaleOrder, action = Index }匹配才能打開對應連接。

4.實現IActionConstraint的路由約束

實現IActionConstraint約束最簡單的方法是建立派生自System.Attribute的類，並將其置於操做（Action）和控制器（Controller）上。 MVC將自動發現任何應用爲屬性的IActionConstraint屬性，便對應用程序模型應用程序進行約束。在下面的示例中，對路由數據中的國家/地區選擇操做進行約束。

public class CountrySpecificAttribute : Attribute, IActionConstraint
{
    private readonly string _countryCode;
    public CountrySpecificAttribute(string countryCode)
    {
        _countryCode = countryCode;
    }
    public int Order
    {
        get
        {
            return 0;
        }
    }
    public bool Accept(ActionConstraintContext context)
    {
        string routeDataValue = context.RouteContext.RouteData.Values["id"] == null ? "" : context.RouteContext.RouteData.Values["id"].ToString();
        return string.Equals(
            routeDataValue,
            _countryCode,
            StringComparison.OrdinalIgnoreCase);
    }
}
public class HomeController : Controller
{
    [CountrySpecific("en-us")]
    public IActionResult Index(string id)
    {
        return View();
    }
}

根據官網解釋IActionConstraint.Order是順序約束意思，好比HomeController 控制器上有[CountrySpecific("en-us")]和[HttpGet]（或者其餘自定義屬性約束）屬性約束，數值較低的屬性約束先運行。響應結果經過下面表格進行分析：

Route Url	Result
[SERVICE_NAME]/Home/Index/en-us	200
[SERVICE_NAME]/Home/Index/zh-cn	404

經過以上的表格能夠知道，在此例中，當Index傳入路由值（en-us）匹配時，Accept方法返回true以表示該操做是匹配項，而後能夠打開鏈接，反之傳入值（zh-cn）不匹配，則404。

 

參考文獻：
在 ASP.NET Core 中路由到控制器操做