上一篇介绍了Asp.Net MVC 中,从Http Pipeline上接收到请求如何匹配,匹配限制,以及如何控制在指定命名空间查找,解析出controller和action,并传参。
这篇主要介绍如何使用路由完成url生成,实现页面跳转,以及customize一个路由。
路由配置使用默认生成的:
routes.MapRoute( name:"Default", url:"{controller}/{action}/{id}", defaults: new { controller ="Home", action = "Index", id = UrlParameter.Optional } );
最简单的方法是使用Html.ActionLink ,在home View里添加代码:
@{ Layout = null; } <!DOCTYPE html> <html> <head> <meta name="viewport"content="width=device-width" /> <title>ActionName</title> </head> <body> <div>The controller is:@ViewBag.Controller</div> <div>The action is: @ViewBag.Action</div> <div> @Html.ActionLink("This is an outgoing URL", "CustomVariable") </div> </body> </html>
这样就会生成:
<a href="/Home/CustomVariable">This is anoutgoing URL</a>
这样,实际上是生成了在当前controller内,指向另一个action的url。
使用Html.ActionLink生成链接的好处是什么,可以根据当前的路由配置,自动维护生成好的url,上例使用的是默认配置。例如如果路由配置改为:
routes.MapRoute("NewRoute","App/Do{action}", new { controller = "Home" });
使用同样的代码:
@Html.ActionLink("This is an outgoing URL","CustomVariable")
此时url连接就会生成为:
<a href="/App/DoCustomVariable">This is anoutgoing URL</a>
因为当我们访问home controller时,NewRoute 在默认路由之前被匹配到了,就会拿它的pattern来生成url了。
当一个请求来时,路由会检测:
1.Pattern
2.路由限制
3.Assign给匿名对象的默认值,就是解析存在Route Dictionary 里面的那些值
最简单的方式:
@Html.ActionLink("Thistargets another controller", "Index", "Admin")
直接传入第二个参数,指向”admin”controller
生成url连接,同时传参
对于同一个controller:
@Html.ActionLink("This is anoutgoing URL", "CustomVariable", new {id = "Hello" })
跨controller传值:
@Html.ActionLink("Click me to go to anotherarea","Index", "Test",new {Id="aaa"},null)
注意,如果路由成功匹配了传值的参数名称,那么url就会以匹配的格式生成;如果路由匹配成功,可是传的值没有在路由模式中指定,那么就会以?param=value的形式传值。例如,对于以上actionlink,如果是路由:
routes.MapRoute("NewRoute","App/Do{action}", new { controller ="Home" })
那么生成的url连接就是:
<a href="/Home/CustomVariable?id=Hello">This is an outgoingURL</a>
如果对于路由:
routes.MapRoute("MyRoute","{controller}/{action}/{id}", new { controller ="Home", action = "Index", id = UrlParameter.Optional });
那么生成的url就是:
<a href="/Home/CustomVariable/Hello">This is an outgoingURL</a>
简单的,还是同样使用Html.ActionLink:
@Html.ActionLink("This is anoutgoing URL", "Index","Home", null, new {id = "myAnchorID", @class = "myCSSClass"})
这样就可以生成一个连接,class设为了myCssClass
<aclass="myCSSClass"href="/"id="myAnchorID">This is an outgoing URL</a>
生成一个绝对路径的url连接
@Html.ActionLink("This is anoutgoing URL", "Index", "Home", "https","myserver.mydomain.com", " myFragmentName", new { id = "MyId"}, new { id ="myAnchorID", @class = "myCSSClass"})
生成:
<a class="myCSSClass" href="https://myserver.mydomain.com/Home/Index/MyId#myFragmentName" id="myAnchorID">This is an outgoing URL</a>
通常,不建议生成绝对路径的url,如需指向外部连接,可以直接使用html标签。
有些场景,只需要生成一个连接,而不想和html.ActionLink建立耦合,那么就可以使用Url.Action:
@Url.Action("Index","Home", new { id = "MyId" })
对于默认route({controller}/{action}/{id})生成:
Home/Index/MyId
public ViewResult MyActionMethod() { string myActionUrl = Url.Action("Index",new { id = "MyID" }); string myRouteUrl =Url.RouteUrl(new { controller = "Home", action = "Index"}); //... do something with URLs... return View(); }
当然,更推荐简单的使用 RedirectToAction(),返回值为RedirectToRouteResult:
public RedirectToRouteResult MyActionMethod() { return RedirectToAction("Index"); }
如果想跳出当前的controller,使用另一个重载:
public RedirectToRouteResult TestRedirect() { returnRedirectToAction("TestAction", "AnotherController"); }
如果这个请求handle不掉,也不想跳到哪个controller,那就还给route吧(这种场景不多):
public RedirectToRouteResult MyActionMethod() { return RedirectToRoute(new { controller = "Home", action = "Index", id = "MyID" }); }
如果当前route的行为还不能满足场景需要,那么可以自定义route,例如,对于刚从asp.netweb form移植到mvc上的网站,对于旧版本的url,我们也需要支持。
创建controller:
namespace UrlsAndRoutes.Controllers { public class LegacyController : Controller { public ActionResult GetLegacyURL(string legacyURL) { return View((object)legacyURL); } } }
这个controller接收传来的url,打印出当前的url(真正的行为应该是显示出该文件内容)。
View里面显示出controller拿来的url值:
@model string @{ ViewBag.Title = "GetLegacyURL"; Layout = null; } <h2>GetLegacyURL</h2> The URL requested was: @Model
完成了简单的controller和view,重点在于后面的route。
public class LegacyRoute : RouteBase { private string[] urls; public LegacyRoute(params string[] targetUrls) { urls = targetUrls; } public override RouteData GetRouteData(HttpContextBase httpContext) { RouteData result = null; string requestedURL = httpContext.Request.AppRelativeCurrentExecutionFilePath; if (urls.Contains(requestedURL, StringComparer.OrdinalIgnoreCase)) { result = new RouteData(this, new MvcRouteHandler()); result.Values.Add("controller", "Legacy"); result.Values.Add("action", "GetLegacyURL"); result.Values.Add("legacyURL", requestedURL); } return result; } public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values) { return null; }
创建一个类,继承了routeBase,重点在后面的那两个需要重写的方法:
GetRouteData和GetVirtualPath
对于getroutedata,我们做的操作时从httpcontext对象里拿当前的requesturl,如果是旧版本url里面的,那么直接就把controller指向legacy,action指向GetLegacyURL,并且把参数一起给了:LegacyURL设为当前的url。如果这个请求不是旧版本url里面,那么简单的返回null,让其他的route对象来handle吧。
对于GetVirtualPath,用于生产Url时,先简单的返回null,后面章节会介绍如何生成url。
最后,注册一下自定义的route:
routes.Add(new LegacyRoute( "~/articles/test1 ", "~/old/.NET_1.0_Class_Library"));
可以看到,自定义的route已经生效了。
把刚才那个GetVirtualPath的函数做个简单实现:
public override VirtualPathData GetVirtualPath(RequestContext requestContext, RouteValueDictionary values) { VirtualPathData result = null; if(values.ContainsKey("legacyURL") && urls.Contains((string)values["legacyURL"],StringComparer.OrdinalIgnoreCase)) { result = newVirtualPathData(this, new UrlHelper(requestContext) .Content((string)values["legacyURL"]).Substring(1)); } return result; }
函数功能:把传入的匿名对象的legacyURL的值做字符串截取,把首字符滤掉。
在view加入代码:
@Html.ActionLink("Clickme", "GetLegacyURL", new { legacyURL = "~/articles/Windows_3.1_Overview" })
就会生成:
<a href="/articles/Windows_3.1_Overview">Click me</a>
前面的例子,我们都是用MvcRouteHandler,对于场景:http请求需要被httphandler来处理掉,那么就需要customize一个routehandler了。
1.提供一个类继承IRouteHandler
public class CustomRouteHandler : IRouteHandler { public IHttpHandler GetHttpHandler(RequestContext requestContext) { return new CustomHttpHandler(); } }
2.准备好HttpHandler
public class CustomHttpHandler : IHttpHandler { public bool IsReusable { get { return false; } } public void ProcessRequest(HttpContext context) { context.Response.Write("Hello"); } }
用于展示,这个handler拿到httpcontext后仅仅打印出hello。
3. 注册一个路由,对于相应的pattern,指向这个routehandler
routes.Add(new Route("SayHello", new CustomRouteHandler()));
访问SayHello,验证结果: