学习ASP.NET MVC5框架揭秘笔记-ASP.NET路由(七)

5.RouteTable

对于一个Web应用来说,访问所有页面采用的URL不可能具有相同的模式,与之匹配的Route自然也不可能是唯一的,一个Web应用通过RouteTable类型的静态只读属性Routes维护一个全局的路由表,如下面的代码片段所示,该属性返回一个RouteCollection对象。

public class RouteTable
{
public RouteTable();
public static RouteCollection Routes { get; }
}

顾名思义,RouteCollection就是一组Route对象的集合。如下面的代码片段所示,RouteCollection直接继承自Collection<RouteBase>,除了继承自基类用于操作集合相关的成员之外,它还定义了一些额外的属性和方法。

public class RouteCollection : Collection<RouteBase>
{
public void Add(string name, RouteBase item);
protected override void ClearItems();
public IDisposable GetReadLock();
public RouteData GetRouteData(HttpContextBase httpContext);
public VirtualPathData GetVirtualPath(RequestContext requestContext, string name, RouteValueDictionary values);
public VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values);
public System.IDisposable GetWriteLock();
public void Ignore(string url, object constraints);
public void Ignore(string url);
protected override void InsertItem(int index,RouteBase item);
public Route MapPageRoute(string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess,RouteValueDictionary defaults, RouteValueDictionary constraints, RouteValueDictionary dataTokens);
public Route MapPageRoute(string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess,RouteValueDictionary defaults,RouteValueDictionary constraints);
public Route MapPageRoute(string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess,RouteValueDictionary defaults);
public Route MapPageRoute(string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess);
public Route MapPageRoute(string routeName, string routeUrl, string physicalFile);
protected override void RemoveItem(int index);
public RouteCollection(VirtualPathProvider virtualPathProvider);
public RouteCollection();
protected override void SetItem(int index, RouteBase item);
public bool AppendTrailingSlash { set; get; }
public bool LowercaseUrls { set; get; }
public bool RouteExistingFiles { set; get; }
public RouteBase this[string name] { get; }
}

当我们调用RouteCollection的GetRouteData和GetVirtualPath方法的时候,该方法会遍历集合中的每一个Route对象。针对每个Route对象,同名的方法就会被调用。如果方法返回一个具体的RouteData或者VirtualPathData对象,他们会直接作为方法的返回值。换言之,集合中第一个匹配的Route对象返回的RouteData或者VirtualPathData对象将直接作为整个方法的返回值。如果每个对象均返回Null,那么整个方法的返回值就是Null。

RouteCollection的RouteExistingFiles属性用来控制是否对存在的物理文件实施路由,也就是说在被解析的URL与某个物理文件的路劲一致的情况下是否还需要对其实施路由。该属性默认值为False,即注册的路由不会影响针对物理文件的请求。

AppendTrailingSlash和LowercaseUrls这两个布尔类型的属性与方法GetVirtualPath有关,他们决定了对URL的正常化行为。具体来说,AppendTrailingSlash属性表示是否需要在生成的URL末尾添加“/”(如果没有),而LowercaseUrls属性则表示是否需要将生成的URL转换成小写。

其实我们使用最为频繁的还是MapPageRoute和lognore这两个方法。前者用于注册某个物理文件与路由模板之间的映射,其本质就是在本集合中添加一个Route对象。后者则与此相反,用于注册一个路由模板使路由系统可以忽略具有对应模式的URL。

当我们在调用MapPageRoute方法的时候,它会将routeName参数作为对应Route对象的注册名称。如下面的代码段所示,RouteCollection具有一个Dictionary<string,RouteBase>类型的字段,注册的Route对象和注册名称之间的映射关系就保存在这个字典对象中。我们可以通过这个注册名称从RouteCollection中提取对应的Route对象。

public class RouteCollection : Collection<RouteBase>
{
//其他成员
private Dictionary<string,RouteBase> _nameMap;
}
时间: 2024-10-14 19:51:43

学习ASP.NET MVC5框架揭秘笔记-ASP.NET路由(七)的相关文章

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC是如何运行的(四)

Action的执行 作为Controller的基类ControllerBase,它的Execute方法主要作用在于执行目标Action方法.如果目标Action方法返回一个ActionResult对象,它还需要执行该对象来对当前请求予以响应.在ASP.NET MVC框架中,两者的执行是通过一个叫做ActionInvoker的对象来完成的. 1.ActionInvoker 我们同样为ActionInvoker定义了一个借口IActionInvoker.如下所示.该接口定义了唯一的方法InvokeA

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC是如何运行的(一)

ASP.NET MVC是如何运行的 ASP.NET由于采用了管道式设计,所以具有很好的扩展性,整个ASP.NET MVC应用框架就是通过扩展ASP.NET实现的.通过上面对ASP.NET管道设计的介绍我们知道,ASP.NET 的扩展点主要体现在HttpModule和HttpHandler这两个核心组件之上,整个ASP.NET MVC框架就是通过自定义的HttpModule和HttpHandler建立起来的. 接下来我们通过自定义组件来模拟ASP.NET MVC的运行原理. 1.4.1建立在迷你版

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC路由(五)

2.AreaRegistration的缓存 Area的注册(主要是基于Area的路由映射注册)通过具体的AreaRegistration来完成.在应用启动的时候,ASP.NET MVC会遍历通过调用BuildManager的静态方法GetReferencedAssemblies得到的程序集列表,并从中找到所有AreaRegistration类型.如果一个应用涉及太多的程序集,则这个过程可能会耗费很多时间.为了提高性能,ASP.NET MVC会对解析出来的所有AreaRegistration类型列

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC是如何运行的(三)

Controller的激活 ASP.NET MVC的路由系统通过注册的路由表对当前HTTP请求实施路由解析,从而得到一个用于封装路由数据的RouteData对象,这个过程是通过自定义的UrlRoutingModule对HttpApplication的PostResolveRequestCache事件进行注册实现的.由于得到的RouteData对象中已经包含了目标Controller的名称,我们需要根据该名称激活对应的Controller对象. 1.MvcRouteHandler 通过前面的介绍我

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC是如何运行的(五)

完整的流程 对于我们创建的这个迷你版的ASP.NET MVC框架来说,虽然很多细节被直接忽略掉,但是它基本上能够展现整个ASP.NET MVC框架的全貌,支持这个开发框架的核心对象可以说一个不少.接下来我们对通过这个模拟框架展现出来的ASP.NET MVC针对请求的处理流程作一个简单的概括. 由于UrlRoutingModule这个HttpModule被注册到Web应用中,所以对于每个抵达的请求来说,当代表当前应用的HttpApplication对象的PostResolveRequestCach

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC是如何运行的(二)

路由 对于一个ASP.NET MVC应用来说,针对HTTP请求的处理实现在目标Controller类型的某个Action,每个HTTP请求不在像ASP.NET Web Forms应用一样是针对一个物理文件,而是针对某个Controller的某个Action方法.目标Controller和Action的名称由HTTP请求的URL来决定,当ASP.NET MVC接收到抵达的请求后,其首要任务就是通过当前HTTP请求解析得到目标Controller和Action的名称,这个过程是通过ASP.NET M

学习ASP.NET MVC5框架揭秘笔记-ASP.NET路由(十一)

3.对现有物理文件的路由 在成功注册路由的情况下,如果我们按照传统的方式访问一个现存的物理文件,在请求地址满足某个Route的路由规则,ASP.NET是否还能正常实施路由呢?我们不妨通过实例来测试一下.为了让针对某个物理文件的访问地址也满足注册路由对象的路由模板采用的URL模式,我们需要按照如下的方式在进行路由注册时将表示约束的参数设置为Null. public class Global : System.Web.HttpApplication { protected void Applicat

学习ASP.NET MVC5框架揭秘笔记-ASP.NET路由(二)

实例演示:通过路由实现请求地址与.aspx页面的映射 我们创建一个简单的ASP.NET Web Forms应用,并采用一套独立于.aspx文件路径的URL来访问对应的Web页面,两者之间的映射通过路由来实现,我们依然沿用员工管理的场景. 首先我们将员工的所有信息(ID.姓名.性别.出生日期和所在部门)定义在如下所示的Employee类型中,然后定义一个EmployeeRepository类型来维护员工列表的数据.简单起见,员工列表通过静态字段employees表示.EmployeeReposit

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC路由(二)

2.2.2 路由注册 ASP.NET MVC通过调用代表全局路由表的RouteCollection对象的扩展方法MapRoute进行路由注册.我们来进行一个简单的实例演示.我们依然沿用之前关于获取天气信息的路由模板,看看通过这种方式注册的Route对象针对匹配的请求将返回怎样一个RouteData对象. 我们创建一个空的ASP.NET Web程序,并手动添加"System.Web.Mvc.dll"和"System.Web.WebPages.Razor.dll"的引用

学习ASP.NET MVC5框架揭秘笔记-ASP.NET MVC路由(三)

2.2.3缺省URL参数 当通过VisualStudio的ASP.NET MVC项目模板创建一个Web应用后,它会为我们注册如下一个模板为"{controller}/{action}/{id}"的默认Route对象.3个路由模板均有相应额默认值.但是变量名为id的默认值为URLParameter.Optional.按照字面的意思,我们将其称为可缺省URL参数.那么将路由变量的默认值进行如此设置与设置一个具体的默认值有什么区别呢? routes.MapRoute( name: "