整个项目范围的依赖注入(Project-Wide Dependency Injection)
在书接下来的章节里面,我们会看到MVC框架提供的很多不同的方式来让我们扩展和自定义对请求的处理,每一种方式都会用一个实现的接口或一个派生的基类来定义。
在第一部分的SportsStore项目实例里面已经有过引入。我们从DefaultControllerFactory类派生了一个NinjectControllerFactory类,以至于我们能够创建Controller,并使用Ninject来管理DI(依赖注入)。如果使用这种方法针对MVC里面每一个自定义的点,最终会让我们将DI贯彻到整个应用程序,但是这样会复制很多代码,会有比我们想象得多的Ninject kernel。
当MVC框架需要创建一个类的实例时,它会调用System.Web.Mvc.DependencyResolver类的一个静态方法。我们可以通过实现IDependencyResolver接口并使用DependencyResolver注册我们的实现来达到将DI贯彻整个应用程序的效果。这样做以后,无论MVC框架什么时候需要创建一个类的实例,它都会调用我们定义的类,我们就可以调用Ninject来创建对象。
下面的代码展示了在SportsStore里面如何实现IDependencyResolver接口,如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
using System;
using System.Collections.Generic;
using System.Web.Mvc;
using Ninject;
using Ninject.Parameters;
using Ninject.Syntax;
using SportsStore.Domain.Abstract;
using SportsStore.Domain.Concrete;
using SportsStore.WebUI.Infrastructure.Abstract;
using SportsStore.WebUI.Infrastructure.Concrete;
using System.Configuration;
namespace SportsStore.WebUI.Infrastructure {
public class NinjectDependencyResolver : IDependencyResolver {
private IKernel kernel;
public NinjectDependencyResolver() {
kernel = new StandardKernel();
AddBindings();
}
public object GetService(Type serviceType) {
return kernel.TryGet(serviceType);
}
public IEnumerable<object> GetServices(Type serviceType) {
return kernel.GetAll(serviceType);
}
public IBindingToSyntax<T> Bind<T>() {
return kernel.Bind<T>();
}
public IKernel Kernel {
get { return kernel; }
}
private void AddBindings() {
// put additional bindings here
Bind<IProductRepository>().To<EFProductRepository>();
Bind<IAuthProvider>().To<FormsAuthProvider>();
// create the email settings object
EmailSettings emailSettings = new EmailSettings {
WriteAsFile = bool.Parse(
ConfigurationManager.AppSettings["Email.WriteAsFile"] ?? "false")};
Bind<IOrderProcessor>()
.To<EmailOrderProcessor>()
.WithConstructorArgument("settings", emailSettings);
}
}
}
上面的类里面,当MVC请求一个新的类的实例的时候会调用开始的两个方法,经历这样的请求也会很简单的调用Ninject kernel。我们添加了一个用来绑定来自类外面绑定的方法AddBindings()方法。接着注册IDependencyResolver接口实现,如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
protected void Application_Start() {
AreaRegistration.RegisterAllAreas();
RegisterGlobalFilters(GlobalFilters.Filters);
RegisterRoutes(RouteTable.Routes);
DependencyResolver.SetResolver(new NinjectDependencyResolver());
ModelBinders.Binders.Add(typeof(Cart), new CartModelBinder());
}
所有这些修改让我们将Ninject放在了MVC非常核心的位置上,我们仍然能够利用MVC扩展性强的优势。但是如果我们要做的全部就是在请求管2道的一些部分引入DI的话,我们就不用再做了,因为前面已经完成了,呵呵。
接下来的笔记主要是关于URL和Routing的(非常重要的,webform里面是基于事件驱动的,MVC里面是基于URL驱动的)
在WebFrom里面我们知道,在请求的URL和服务器磁盘上的文件是有直接的对应关系的,要是没有这种关系,通常都会报404错误。而在MVC里面是没有这种一对一的对应关系的,URL请求都是通过Controller里面的Action方法来处理的。为了处理MVC的URL,asp.net平台使用了routing system,路由系统不是MVC特有的,而是asp.net平台的功能,也就是说在WebFrom里面也是存在路由系统的。routing system的类包含在了System.Web命名空间下,从这里也可以看出它不是MVC特有的。
MVC的Routing System(路由系统)具有两个功能:
1.检查传入的URL,并计算出该请求需要的Controller和Action
2.创建输出的URL,这些URL是在从View呈现的html里面出现的,为了能够在用户点击一个URL时能调用一个具体的Action(当用户点击时又变成一个传入的URL了)
下面创建一个MVC3的项目UrlsAndRoutes来具体说明MVC里面的routing。
这次我们选择Internet Application Template,它会帮我们生成一个实例程序,方便我们学习。MVC里面的路由定义在Global.asax.cs里面
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
using System.Web.Mvc;
using System.Web.Routing;
namespace UrlsAndRoutes {
public class MvcApplication : System.Web.HttpApplication {
protected void Application_Start() {
AreaRegistration.RegisterAllAreas();
RegisterGlobalFilters(GlobalFilters.Filters);
RegisterRoutes(RouteTable.Routes);
}
public static void RegisterRoutes(RouteCollection routes) {
路由定义在这里...
}
public static void RegisterGlobalFilters(GlobalFilterCollection filters) {
filters.Add(new HandleErrorAttribute());
}
}
}
Application_Start()方法在程序第一次启动时被底层的asp.net平台调用,进而导致RegisterRoutes方法也会被调用。方法的参数是一个静态属性RouteTable.Routes,它是RouteCollection类的一个实例。
这里我们可以先删除在RegisterRoutes里面生成的默认的路由值,在此之前,我们要先了解下对routing system非常重要的东西:
URL模式(URL patterns)
routing system一个不可思议的地方是它使用了一套routes,这些routes组合构成一个应用程序的URL架构或模式,这些URL模式是程序将要识别和响应的。每一个路由包含一个URL模式,将它跟请求过来的URL进行比较。如果能够匹配,routing system就会用它来处理这个URL。
URL可以分割为几个不同的段(Segment)(不包含主机名和query string),通过"/"分隔,例如下面的一个URL。
分隔的第一个小段是Admin,第二个是Index。
我们能够看出这个对应了Controller和Action,但是我们需要把这种对应关系表达为routing system能够理解的形式,也就是URL模式(URL pattern)。这里的URL模式就是{controller}/{action}。
当处理请求URL时,routing system的工作就是匹配该URL到一个URL模式并提取在模式里面定义的segment变量的值(segment变量就是这里的controller和action,它们对应的值分别是Admin和Index)。
Note:routing system没有任何关于controller和action的特别的知识点,仅仅是当请求到达MVC框架本身时提取segment变量的值并在请求管道(request pipeline)中传递,这意味着会给controller和action变量赋值。这也就是为什么routing system能够在WebFrom里面使用以及我们如何能够自定义变量。
默认情况下,一个URL模式会匹配任何一个跟它具有相同segment数量的URL。例如{controller}/{action}会匹配如下URL
图中高亮的部分说明了URL模式的两个关键的行为:
1.URL模式是保守的:只匹配具有同等segment数量的URL
2.URL模式同时又是开放的:只有segment数量相等,不过具体的是什么,都能够提取segment变量对应的值。
前面有提到过,routing system是独立于MVC的,对MVC应用程序没有任何了解。所以,当没有对应的controller和action能够对从URLsegment变量提取的值进行响应的时候,URL模式仍会进行匹配。
上图中的第二种情况,就是把Admin和Index颠倒了,也能够提取值,只不过提取出来的值也是颠倒的。这里并没有一个Index的controller和Admin的Action。
下面创建一个简单的route,代码如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes) {
Route myRoute = new Route("{controller}/{action}", new MvcRouteHandler());
routes.Add("MyRoute", myRoute);
}
我们创建了一个新的route对象,并将URL模式作为一个构造器参数传递,同时还传递了一个MvcRouteHandler的实例参数。不同的ASP.NET技术提供不同的类来处理路由的行为,MvcRouteHandler类是MVC里面使用的类。一旦创建了一个路由(Route),可以使用Add方法添加到RouteCollection对象里面,同时可以给我们创建的路由传递一个名字。在Add方法里面传递路由的名字是可选的,也可以为空。这里使用的是Add方法将定义的路由注册到RouteCollection里面,还有一种更加简便的方式就是使用MapRoute方法。如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes) {
routes.MapRoute("MyRoute", "{controller}/{action}");
}
这个方法更加精简,主要是因为不需要创建MvcRouteHandler类的实例。MapRoute仅仅是MVC使用的,在ASP.NET WebFrom里面使用的是MapPageRoute(也是定义在RouteCollection里面的)
要对routes进行单元测试,需要mock三个类 HttpRequestBase, HttpContextBase, 和HttpResponseBase。为了方便测试,我们创建几个通用的方法如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
private HttpContextBase CreateHttpContext(string targetUrl = null, string httpMethod = "GET")
{
//create the mock request
Mock<HttpRequestBase> mockRequest = new Mock<HttpRequestBase>();
mockRequest.Setup(m => m.AppRelativeCurrentExecutionFilePath).Returns(targetUrl);
mockRequest.Setup(m => m.HttpMethod).Returns(httpMethod);
//create the mock response
Mock<HttpResponseBase> mockResponse = new Mock<HttpResponseBase>();
mockResponse.Setup(m => m.ApplyAppPathModifier(It.IsAny<string>())).Returns<string>(s => s);
//create the mock context,using the request and response
Mock<HttpContextBase> mockContext = new Mock<HttpContextBase>();
mockContext.Setup(m => m.Request).Returns(mockRequest.Object);
mockContext.Setup(m => m.Response).Returns(mockResponse.Object);
//return the mocked context
return mockContext.Object;
}
private void TestRouteMatch(string url, string controller, string action, object routeProperties = null, string httpMethod = "GET")
{
//Arrange
RouteCollection routes = new RouteCollection();
MvcApplication.RegisterRoutes(routes);
//Act- process the route
RouteData result = routes.GetRouteData(CreateHttpContext(url, httpMethod));
//Assert
Assert.IsNotNull(result);
Assert.IsTrue(TestIncomingRouteResult(result, controller, action, routeProperties));
}
private bool TestIncomingRouteResult(RouteData routeResult, string controller, string action, object propertySet = null)
{
Func<object, object, bool> valCompare = (v1, v2) => { return StringComparer.InvariantCultureIgnoreCase.Compare(v1, v2) == 0; };
bool result = valCompare(routeResult.Values["controller"], controller) && valCompare(routeResult.Values["action"], action);
if (propertySet != null)
{
PropertyInfo[] propInfo = propertySet.GetType().GetProperties();
foreach (PropertyInfo pi in propInfo)
{
if (!(routeResult.Values.ContainsKey(pi.Name) && valCompare(routeResult.Values[pi.Name], pi.GetValue(propertySet, null))))
{
result = false;
break;
}
}
}
return result;
}
private void TestRouteFail(string url, string httpMethod = "GET")
{
// Arrange
RouteCollection routes = new RouteCollection();
MvcApplication.RegisterRoutes(routes);
// Act - process the route
RouteData result = routes.GetRouteData(CreateHttpContext(url, httpMethod));
// Assert
Assert.IsTrue(result == null || result.Route == null);
}
下面是一个测试路由的例子:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
[TestMethod]
public void TestIncomingRoutes()
{
// check for the URL that we hope to receive
TestRouteMatch("~/Admin/Index", "Admin", "Index");
// check that the values are being obtained from the segments
TestRouteMatch("~/One/Two", "One", "Two");
// ensure that too many or too few segments fails to match
TestRouteFail("~/Admin/Index/Segment");
TestRouteFail("~/Admin");
}
测试里面有两个方法TestRouteMatch和TestRouteFail,TestRouteMatch确保URL正确的格式以及能够使用URL segments取到controller和action恰当的值;TestRouteFail确保我们的程序不接受不匹配URL模式的URL。测试时,在URL前面加上了"~"的前缀。因为ASP.NET框架就是这样将URL呈现给routing system的。
如果我们运行程序会报404错误,因为直接运行时,地址栏里面的URL是http://localhost:<port>/ ,而我们没有创建针对该URL的路由。当我们输入URL:http://localhost:<port>/Home/Index就可以看到示例效果了。
这里URL模式处理URL并提取Home这个controller变量的值和Index这个action变量的值(Home和Index就是segment变量)
定义默认值
在上面我们第一次运行程序的时候报了404错误,是因为"~/"没有匹配我们定义的URL模式{controller}/{action}。一种解决的方式就是定义默认值,当URL里面不包含要匹配的segment时,默认值就被使用了。把路由做如下更改:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}", new { action = "Index" });
}
默认值是作为一个匿名类型的属性提供的,上面的我们提供了action变量Index的默认值。这时路由就可以匹配两种URL了:
1.http://localhost:<port>/Home/Index;2.http://localhost:<port>/Home.
第一种不必说当然可以,因为我们定义action变量的默认值所以当URL里面没有action这个segment时,我们定义的默认值就被使用了。
我们进一步提供默认值,修改如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}",
new { controller = "Home", action = "Index" });
}
我们提供了两个默认值,这个时候运行程序就不会报错了。因为此时"http://localhost:<port>/"里面既没有controller这个segment,也没有action这个segment。但是我们定义的它们的默认值会被使用。这个路由可以匹配的URL如下所示:
可以做如下测试:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
[TestMethod]
public void TestIncomingRoutes()
{
TestRouteMatch("~/", "Home", "Index");
TestRouteMatch("~/Customer", "Customer", "Index");
TestRouteMatch("~/Customer/List", "Customer", "List");
TestRouteFail("~/Customer/List/All");
}
使用静态的URL Segment
并不是在一个URL模式里面所有的segments都需要是变量。也可以定义不变的segment,即静态segment。
假设我们需要匹配这样一个URL:http://mydomain.com/Public/Home/Index 。可以添加一个路由如下:
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}",
new { controller = "Home", action = "Index" });
routes.MapRoute("", "Public/{controller}/{action}",
new { controller = "Home", action = "Index" });
}
Public/{controller}/{action}匹配包含3个segment的URL,第一个必须是Public.也可以创建一个具有静态元素也有变量的segment的URL模式.如下所示:
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("", "X{controller}/{action}");
routes.MapRoute("MyRoute", "{controller}/{action}",
new { controller = "Home", action = "Index" });
routes.MapRoute("", "Public/{controller}/{action}",
new { controller = "Home", action = "Index" });
}
如果http://mydomain.com/XHome/Index,而取第一个segment变量的值是不会包含X的,仍然取的是Home而不是XHome
Route排序
当使用MapRoute方法添加routes时,被使用的顺序一般情况下是按照它在RouteCollection对象里面出现的顺序。之所以这里说"一般情况",是因为有方法能够让我们选择插入的位置,但是不提倡这样做,因为直接使用MapRoute插入route是按照它们被定义的顺序,这样更容易理解程序的路由。路由系统通过URL模式匹配请求的URL,并且在当前路由不匹配的情况下才处理下一个路由,会一直匹配到最后一个路由为止。这样的结果就要求我们必须按照从具体到抽象的顺序来排列路由,这里类似于我们处理异常的顺序。如果我们将上面的路由排列顺序做如下改动:
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}",
new { controller = "Home", action = "Index" });
routes.MapRoute("", "X{controller}/{action}");
routes.MapRoute("", "Public/{controller}/{action}",
new { controller = "Home", action = "Index" });
}
因为第一个路由会匹配具有0,1,2个segment的URL,其实也就是全部的情况了。这个时候运行程序输入:http://mydomain.com/XHome/Index,程序会报404错误。
我们能够联合静态URL和默认值来创建一个具体URL的别名,这会在需要公开的发布我们的URL架构并且与用户制定了一个契约时非常有用。如果我们在这种情形下重构一个应用程序,我们需要保护之前的URL格式。让我们设想这样一个场景:我们有一个ShopController,现在被HomeController代替,下面的代码展示如何保护老的URL架构:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("ShopSchema", "Shop/{action}", new { controller = "Home" });
...other routes...
}
这个路由可以匹配以Shop为第一个segment并包含两个segment的URL。该URL模式没有包含一个controller的segment变量,所以这里的默认值会被使用。这意味着对ShopController里面Action请求转换成了对HomeController里面的Action请求。
我们可以进一步深入,为我们要重构的Action方法创建一个别名并且不用在呈现controller了,达到这样的效果只需要我们提供controller和action的默认值就可以了。如下:
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("ShopSchema2", "Shop/OldAction",
new { controller = "Home", action = "Index" });
routes.MapRoute("ShopSchema", "Shop/{action}", new { controller = "Home" });
其他路由...
}
这时我们只需要输入http://localhost:port/Shop就行了,输入Shop/OldAction是会报404的。
自定义segment变量
MVC里面不是只能定义controller和action两个segment变量,我可以定义自己的segment变量,如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { controller = "Home", action = "Index", id = "DefaultId" });
}
上面的路由定义了一个id的segment变量,可以匹配0-3个segment的URL。对于我们自己定义segment变量时,变量名不能是controller,action,area。
我们可以使用RouteData.Values访问任何segment变量,这里我们添加一个CustomVariable的方法到HomeController里面,如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public ViewResult CustomVariable()
{
ViewBag.CustomVariable = RouteData.Values["id"];
return View();
}
添加一个视图CustomVariable.cshtml将id的值显示出来,如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
@{
ViewBag.Title = "CustomVariable";
}
<h2>Variable: @ViewBag.CustomVariable</h2>
下面是针对上面路由的单元测试,如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
[TestMethod]
public void TestIncomingRoutes()
{
TestRouteMatch("~/", "Home", "Index", new {id = "DefaultId"});
TestRouteMatch("~/Customer", "Customer", "index", new { id = "DefaultId" });
TestRouteMatch("~/Customer/List", "Customer", "List", new { id = "DefaultId" });
TestRouteMatch("~/Customer/List/All", "Customer", "List", new { id = "All" });
TestRouteFail("~/Customer/List/All/Delete");
}
使用自定义的变量作为Action方法的参数
使用RouteData.Values访问自定义的segment变量的值仅仅是一种方式,有更加优雅的方式来访问segment变量的值。如果我们在Action里面定义参数匹配URL模式的变量,MVC框架会将从URL获取的值作为参数传递给action方法。修改CustomVariable action方法以至于它有一个匹配的参数,如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public ViewResult CustomVariable(string id)
{
ViewBag.CustomVariable = id;
return View();
}
运行程序输入http://localhost:<port>/Home/CustomVariable/page_1/d 会显示id的值page_1.
当然也可以在路由里面定义多个segment参数,同样也在action方法里面定义多个同样的参数,这时就可以取多个自定义的segment变量的值。自定义的segment变量与action方法的参数要保持一样。
上面定义的id参数是一个字符串的类型,但是MVC框架会试图将URL值转换为任何我们定义在action方法里面的参数类型。如果我们这里定义id为Datetime类型,这时从URL传过来的就是Datetime类型。
下面修改路由增加一个segment变量为flag,并且修改action方法参数如下:
//修改路由 可能有些参数的作用前面还没有介绍,不用急,后面会有说明。
routes.MapRoute("AddContollerRoute", "{controller}/{action}/{id}/{flag}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional }, new[] { "AdditionalControllers" });//这个地方要改成你自己对应的,我这里用的不是
URLsAndRoutes.Controllers。这里后面有介绍的
public ViewResult CustomVariable(string id, DateTime flag)
{
ViewBag.CustomVariable = "id的值为:"+id +"——"+"flag的值为:"+ flag.ToString();
return View();
}
运行程序如下图所示:
注意:如果这里的flag不能被转换为DateTime,则会报如下错误:
MVC框架使用模型绑定系统(model binding system)将URL里面包含的指转换为.NET类型。并且可以处理比上面例子里面更加复杂的情形,这一部分在书里面的后面章节会介绍。
在上面定义路由时会有id = UrlParameter.Optional。这个表示该URL中的id segment变量是可选的。关于匹配情况如下所示:
从上面的图可以看出,当URL里面有了对应id的segment时,id就有了相应的值。当没有相应的URL segment来对应id时,并不是表示值为null,而是没有定义。
当你需要知道用户是否提供了一个值时,这点就非常有用。当我们给action里面的参数id提供一个默认值时,我们就不能分别是默认值使用了还是用户输入的URL本身就恰好包含了默认值。
对应测试的代码如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
[TestMethod]
public void TestIncomingRoutes()
{
TestRouteMatch("~/", "Home", "Index");
TestRouteMatch("~/Customer", "Customer", "index");
TestRouteMatch("~/Customer/List", "Customer", "List");
TestRouteMatch("~/Customer/List/All", "Customer", "List", new { id = "All" });
TestRouteFail("~/Customer/List/All/Delete");
}
前面的URL模式里面有包含/{*catchall}。以"*"开始的segment,这意味着{controller}/{action}/{id}/{flag}/后面可以匹配多个segment。
对于{controller}/{action}/{id}/{*catchall}(这里不一定要写成catchall,其他的以*开始也OK)可以匹配的情况,如下图所示:
对于*catchall的segment的数量是没有上限的。对应的单元测试如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
[TestMethod]
public void TestIncomingRoutes()
{
TestRouteMatch("~/", "Home", "Index");
TestRouteMatch("~/Customer", "Customer", "Index");
TestRouteMatch("~/Customer/List", "Customer", "List");
TestRouteMatch("~/Customer/List/All", "Customer", "List", new { id = "All" });
TestRouteMatch("~/Customer/List/All/Delete", "Customer", "List",
new { id = "All", catchall = "Delete" });
TestRouteMatch("~/Customer/List/All/Delete/Perm", "Customer", "List",
new { id = "All", catchall = "Delete/Perm" });
}
定义优先使用的Controller所属的命名空间
在上面有定义路由时,有这样一个参数new[] { "AdditionalControllers" },AdditionalControllers是另外建的一个类库里面添加了一个HomeController。所以要添加一个这样的参数,是因为当有几个HomeController分别属于不同的命名空间。这个时候如果不指定一个优先的命名空间,就会抛异常。你可以添加一个AdditionalControllers类库项目,然后添加一个HomeController类,代码如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
namespace AdditionalControllers
{
public class HomeController : Controller
{
public ViewResult CustomVariable(string id, DateTime flag)
{
ViewBag.CustomVariable = "id的值为:"+id +"——"+"flag的值为:"+ flag.ToString();
return View();
}
}
}
当一个传入的URL匹配了一个路由,MVC框架会取controller变量的值并寻找合适的controller。例如:当controller变量的值是Home,MVC就会寻找名为HomeController的Controller。这是一个没有限制的类名,当有两个或以上的HomeController时,MVC是不知道怎么处理的,会报错。
这种在大的MVC项目里面发生的概率会大些,所以这就有必要指定一个优先的Controller。具体的使用在上面的定义的路由里面已经有了,定义一个路由如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new[] { "URLsAndRoutes.Controllers"});
}
我们将命名空间表达成一个字符串数组,在上面的代码里面,我们告诉MVC框架首先在URLsAndRoutes.Controllers里面寻找,如果没有找到合适的,则会在其他的命名空间里面寻找。所有添加到这个字符串数组里面的命名空间具有相同的优先级,也就是说不会因为URLsAndRoutes.Controllers在new[] { "URLsAndRoutes.Controllers", "AdditionalControllers"}的最前面而具有更高的优先级。
这样定义以后运行程序仍然会报错的,因为面对两个同名的同优先级的Controller,MVC是不知道怎么处理的。
那我们想要倾向性的使用一个命名空间中的Controller要怎么做呢?使用多个routes,如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("AddContollerRoute", "Home/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new[] { "AdditionalControllers" });
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new[] { "URLsAndRoutes.Controllers"});
}
在后面的章节会介绍如何对整个应用程序设置命名空间的优先级。
我们能够告诉MVC框架仅仅在指定的命名空间寻找,如果没有找到匹配的也不去其他的命名空间寻找。只需要添加一个属性值,如下所示:
public static void RegisterRoutes(RouteCollection routes)
{
Route myRoute = routes.MapRoute("AddContollerRoute", "Home/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new[] { "AdditionalControllers" });
myRoute.DataTokens["UseNamespaceFallback"] = false;
}
使用正则表达式约束路由(Constraining Routes)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new { controller = "^H.*"},
new[] { "URLsAndRoutes.Controllers"});
}
我们通过传递给MapRoute方法一个参数来定义约束,也是一个匿名类型的。要约束的变量跟URL模式里面的segment变量保持一致。上面的路由对controller变量进行约束,必须是H开头的(当然,如果你跟我一样对正则不熟悉,那就去找相关的资料学习下,至少能够明白本书里面的所有正则表达式的含义)。默认值会在约束检查之前被使用。
将约束定义为具体的值:new { controller = "^H.*", action = "^Index$|^About$"}意思是:路由的controller要以H开头,并且action是Index或About。
使用HTTP方法约束:new { controller = "^H.*", action = "Index|About", httpMethod = new HttpMethodConstraint("GET") },这里是不是httpMethod不重要,只要我们实例化HttpMethodConstraint("")并赋值给一个变量(自定义,这里是httpMethod).
注意:这里的约束HTTP方法与在Action方法上面添加特性HttpGet和HttpPost是没有关联的。对路由的限制比在Action上面添加HttpGet和HttpPost限制会在请求管道(request pipeline)的更早的时候被处理。对处理不同的HTTP方法会在后面的章节详细介绍的。我们也可以添加几个HTTP方法如:httpMethod = new HttpMethodConstraint("GET", "POST") }。
对应的单元测试如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
[TestMethod]
public void TestIncomingRoutes()
{
TestRouteMatch("~/", "Home", "Index");
TestRouteMatch("~/Home", "Home", "Index");
TestRouteMatch("~/Home/Index", "Home", "Index");
TestRouteMatch("~/Home/About", "Home", "About");
TestRouteMatch("~/Home/About/MyId", "Home", "About", new { id = "MyId" });
TestRouteMatch("~/Home/About/MyId/More/Segments", "Home", "About",
new {
id = "MyId",
catchall = "More/Segments"
});
TestRouteFail("~/Home/OtherAction");
TestRouteFail("~/Account/Index");
TestRouteFail("~/Account/About");
}
自定义约束
如果标准的约束不能满足我们的需求,可以自己实现约束,必须继承IRouteConstraint接口。下面的示例实现了对游览器的约束,当然实际情况不提倡限制浏览器的。这里仅仅为了说明功能。代码如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
using System.Web;
using System.Web.Routing;
namespace URLsAndRoutes.Infrastructure
{
public class UserAgentConstraint : IRouteConstraint
{
private string requiredUserAgent;
public UserAgentConstraint(string agentParam)
{
requiredUserAgent = agentParam;
}
public bool Match(HttpContextBase httpContext, Route route, string parameterName,
RouteValueDictionary values, RouteDirection routeDirection) {
return httpContext.Request.UserAgent != null &&
httpContext.Request.UserAgent.Contains(requiredUserAgent);
}
}
}
IRouteConstraint接口定义了一个Match方法,用来实现路由系统的约束是否被满足。如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new {
controller = "^H.*", action = "Index|About",
httpMethod = new HttpMethodConstraint("GET", "POST"),
customConstraint = new UserAgentConstraint("IE") },
new[] { "URLsAndRoutes.Controllers" });
}
路由文件请求
不是所有的请求都是针对controller的action的,我也需要提供对images,静态HTML文件,javascript库等的服务。为了说明,先创建一个 StaticContent.html文件。
代码如下:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
<html>
<head><title>Static HTML Content</title></head>
<body>This is the static html file (~/Content/StaticContent.html)</body>
</html>
输入http://localhost:<port>/Content/StaticContent.html可以访问.默认情况下:路由系统会先检查URL是否匹配具体的文件,不是匹配路由。如果有匹配的,则不会进行路由匹配。如果我们要颠倒这个顺序,可以使用routes.RouteExistingFiles = true(这里有个约定:必须放在方法体的最上面)。接着就可以为具体的文件路径定义路由了,如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.RouteExistingFiles = true;
routes.MapRoute("DiskFile", "Content/StaticContent.html",
new {
controller = "Account", action = "LogOn",
},
new {
customConstraint = new UserAgentConstraint("IE")
});
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new {
controller = "^H.*", action = "Index|About",
httpMethod = new HttpMethodConstraint("GET", "POST"),
customConstraint = new UserAgentConstraint("IE")
},
new[] { "URLsAndRoutes.Controllers" });
}
此时运行系统输入:http://localhost:<port>/Content/StaticContent.html,会显示登录界面。因为优先使用了路由而不会去匹配URL里面的路径。
启用这个属性要慎重,以为很可能导致异常。一般情况下不要启用。现在添加一个OtherStaticContent.html,定义如下路由:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes) {
routes.RouteExistingFiles = true;
routes.MapRoute("DiskFile", "Content/StaticContent.html",
new {
controller = "Account", action = "LogOn",
},
new {
customConstraint = new UserAgentConstraint("IE")
});
routes.MapRoute("MyNewRoute", "{controller}/{action}");
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new {
controller = "^H.*", action = "Index|About",
httpMethod = new HttpMethodConstraint("GET", "POST"),
customConstraint = new UserAgentConstraint("IE") },
new[] { "URLsAndRoutes.Controllers" });
}
运行程序,请求http://localhost:<port>/Content/OtherStaticContent.html就会报404.这样做是为了说明:当我们开启了routes.RouteExistingFiles = true属性,优先匹配的是文件路径而不是URL,当文件路径不匹配时(显然现在请求的是OtherStaticContent.html,跟路由里定义的routes.MapRoute("DiskFile", "Content/StaticContent.html"...是不匹配的,所以报404错误)
绕过路由
要忽略对某些文件的路由可以使用routes.IgnoreRoute,如下所示:
![](https://i-blog.csdnimg.cn/blog_migrate/8f900a89c6347c561fdf2122f13be562.gif)
![](https://i-blog.csdnimg.cn/blog_migrate/961ddebeb323a10fe0623af514929fc1.gif)
public static void RegisterRoutes(RouteCollection routes)
{
routes.RouteExistingFiles = true;
routes.MapRoute("DiskFile", "Content/StaticContent.html",
new {
controller = "Account", action = "LogOn",
},
new {
customConstraint = new UserAgentConstraint("IE")
});
routes.IgnoreRoute("Content/{filename}.html");
routes.MapRoute("", "{controller}/{action}");
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { controller = "Home", action = "Index", id = UrlParameter.Optional },
new {
controller = "^H.*", action = "Index|About",
httpMethod = new HttpMethodConstraint("GET", "POST"),
customConstraint = new UserAgentConstraint("IE")
},
new[] { "URLsAndRoutes.Controllers" });
}
IgnoreRoute方法创建了一个通路,让处理路由的实例是StopRoutingHandler类的而不是MvcRouteHandler的。当一个URL模式经过IgnoreRoute并匹配上,那后面的路由就不会进行匹配了或者说是评估。
好了,今天的笔记到这里,内容比较多,希望对跟我一样的同学有点帮助。
晚安!