Orchard对mvc路由重新做了包装,重写了asp.net的路由模块

一、路由模块类图
1、路由 Descriptor

RouteDescriptor是对常规mvc路由的包装类,它的Route属性就是在mvc注册路由中使用的RouteBase类型。在Orchard中注册路由,应该用这种方式
  1. newRouteDescriptor{
    Route=newRoute(
    "Admin/Blogs/Create",
    newRouteValueDictionary{
    {"area","Orchard.Blogs"},
    {"controller","BlogAdmin"},
    {"action","Create"}
    },
    newRouteValueDictionary(),
    newRouteValueDictionary{
    {"area","Orchard.Blogs"}
    },
    newMvcRouteHandler())
    }
 
2、路由实现
    Orchard的路由实现有2个类组成:HubRoute和ShellRoute类。它们都继承了System.Web.Routing.RouteBase类,要重新实现GetRouteData和GetVirtualPath方法
2.1、HubRoute类中的GetRouteData方法
  1. publicoverrideRouteDataGetRouteData(HttpContextBase httpContext)
    {
    var settings = _runningShellTable.Match(httpContext); if(settings ==null)
    returnnull;
    //这里获取1个ShellRoute的集合
    IList<RouteBase> routes;
    if(!_routesByShell.TryGetValue(settings.Name,out routes))
    {
    returnnull;
    } foreach(var route in routes)
    {
    RouteData routeData = route.GetRouteData(httpContext);//这里的route是ShellRoute类型
    if(routeData !=null)
    {
    return routeData;
    }
    } returnnull;
    }
HubRoute类只是1个route的分配器,它的GetRouteData方法只是从1个ShellRoute集合中获取匹配的 ShellRoute,而真正的获取RouteData 实例的是ShellRoute 类中的 GetRouteData方法
 
2.2、ShellRoute中的GetRouteData方法
  1. publicoverrideRouteDataGetRouteData(HttpContextBase httpContext)
    {
    // locate appropriate shell settings for request
    var settings = _runningShellTable.Match(httpContext); // only proceed if there was a match, and it was for this client
    if(settings ==null|| settings.Name!= _shellSettings.Name)
    returnnull; var effectiveHttpContext = httpContext;
    if(_urlPrefix !=null)
    effectiveHttpContext =newUrlPrefixAdjustedHttpContext(httpContext, _urlPrefix); var routeData = _route.GetRouteData(effectiveHttpContext);//这里获取的是真正的mvc RouteData
    if(routeData ==null)
    returnnull; // otherwise wrap handler and return it
    routeData.RouteHandler=newRouteHandler(_workContextAccessor, routeData.RouteHandler,SessionState);
    routeData.DataTokens["IWorkContextAccessor"]= _workContextAccessor; if(IsHttpRoute)
    {
    routeData.Values["IWorkContextAccessor"]= _workContextAccessor;// for WebApi
    } return routeData;
    }
3、路由注册
    Orchard的路由注册功能由2个接口定义:IRouteProvider、IRoutePublisher。Orchard提供默认的实现:DefaultRouteProvider和RoutePublisher类
3.1、DefaultRouteProvider类:
  1. publicclassDefaultRouteProvider:IRouteProvider
    {
    //GetRoutes方法中定义了你要使用的所有的路由信息.
    publicIEnumerable<RouteDescriptor>GetRoutes()
    {
    returnnew[]{
    newRouteDescriptor{
    Priority=-,
    Route=newRoute(
    "{controller}/{action}/{id}",
    newRouteValueDictionary{
    {"controller","home"},
    {"action","index"},
    {"id",""},
    },
    newRouteValueDictionary{
    {"controller",newHomeOrAccount()}
    },
    newMvcRouteHandler())
    }
    };
    } publicvoidGetRoutes(ICollection<RouteDescriptor> routes)
    {
    foreach(var routeDescriptor inGetRoutes())
    routes.Add(routeDescriptor);
    } }
3.2、RoutePublisher类:
  1.  public void Publish(IEnumerable<RouteDescriptor> routes)
    {
    var routesArray = routes
    .OrderByDescending(r => r.Priority)
    .ToArray(); // this is not called often, but is intended to surface problems before
    // the actual collection is modified
    var preloading = new RouteCollection();
    foreach (var routeDescriptor in routesArray)
    { // extract the WebApi route implementation
    var httpRouteDescriptor = routeDescriptor as HttpRouteDescriptor;
    if (httpRouteDescriptor != null)
    {
    var httpRouteCollection = new RouteCollection();
    httpRouteCollection.MapHttpRoute(httpRouteDescriptor.Name, httpRouteDescriptor.RouteTemplate, httpRouteDescriptor.Defaults, httpRouteDescriptor.Constraints);
    routeDescriptor.Route = httpRouteCollection.First();
    } preloading.Add(routeDescriptor.Name, routeDescriptor.Route);
    } using (_routeCollection.GetWriteLock())
    {
    // existing routes are removed while the collection is briefly inaccessable
    _routeCollection
    .OfType<HubRoute>()
    .ForEach(x => x.ReleaseShell(_shellSettings)); // new routes are added
    foreach (var routeDescriptor in routesArray)
    {
    // Loading session state information.
    var defaultSessionState = SessionStateBehavior.Default; ExtensionDescriptor extensionDescriptor = null;
    if (routeDescriptor.Route is Route)
    {
    object extensionId;
    var route = routeDescriptor.Route as Route;
    if (route.DataTokens != null && route.DataTokens.TryGetValue("area", out extensionId) ||
    route.Defaults != null && route.Defaults.TryGetValue("area", out extensionId))
    {
    extensionDescriptor = _extensionManager.GetExtension(extensionId.ToString());
    }
    }
    else if (routeDescriptor.Route is IRouteWithArea)
    {
    var route = routeDescriptor.Route as IRouteWithArea;
    extensionDescriptor = _extensionManager.GetExtension(route.Area);
    } if (extensionDescriptor != null)
    {
    // if session state is not define explicitly, use the one define for the extension
    if (routeDescriptor.SessionState == SessionStateBehavior.Default)
    {
    Enum.TryParse(extensionDescriptor.SessionState, true /*ignoreCase*/, out defaultSessionState);
    }
    } // Route-level setting overrides module-level setting (from manifest).
    var sessionStateBehavior = routeDescriptor.SessionState == SessionStateBehavior.Default ? defaultSessionState : routeDescriptor.SessionState; var shellRoute = new ShellRoute(routeDescriptor.Route, _shellSettings, _workContextAccessor, _runningShellTable)
    {
    IsHttpRoute = routeDescriptor is HttpRouteDescriptor,
    SessionState = sessionStateBehavior
    }; var area = extensionDescriptor == null ? "" : extensionDescriptor.Id; var matchedHubRoute = _routeCollection.FirstOrDefault(x =>
    {
    var hubRoute = x as HubRoute;
    if (hubRoute == null)
    {
    return false;
    } return routeDescriptor.Priority == hubRoute.Priority && hubRoute.Area.Equals(area, StringComparison.OrdinalIgnoreCase) && hubRoute.Name == routeDescriptor.Name;
    }) as HubRoute; if (matchedHubRoute == null)
    {
    matchedHubRoute = new HubRoute(routeDescriptor.Name, area, routeDescriptor.Priority, _runningShellTable); int index;
    for (index = ; index < _routeCollection.Count; index++)
    {
    var hubRoute = _routeCollection[index] as HubRoute;
    if (hubRoute == null)
    {
    continue;
    }
    if (hubRoute.Priority < matchedHubRoute.Priority)
    {
    break;
    }
    } _routeCollection.Insert(index, matchedHubRoute);
    } matchedHubRoute.Add(shellRoute, _shellSettings);
    }
    }
    }
Publish方法将路由注册到asp.net mvc 的路由系统中。
 
二、如何在Module开发中使用路由系统
    Orchard的功能都是通过Module实现的。那么在Module开发中如何使用 路由呢?我们以Orcahrd自己的 Orchard.Blogs Module为例,在Orchard中实现自己的路由其实很简单,只需要在自己的Module中创建1个实现IRouteProvider接口的类型即可。
  1.  public class Routes : IRouteProvider
    {
    private readonly IArchiveConstraint _archiveConstraint;
    private readonly IRsdConstraint _rsdConstraint; public Routes(
    IArchiveConstraint archiveConstraint,
    IRsdConstraint rsdConstraint)
    {
    _archiveConstraint = archiveConstraint;
    _rsdConstraint = rsdConstraint;
    } public void GetRoutes(ICollection<RouteDescriptor> routes)
    {
    foreach (var routeDescriptor in GetRoutes())
    routes.Add(routeDescriptor);
    } public IEnumerable<RouteDescriptor> GetRoutes()
    {
    return new[] {
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/Create",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogAdmin"},
    {"action", "Create"}
    },
    new RouteValueDictionary(),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Edit",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogAdmin"},
    {"action", "Edit"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Remove",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogAdmin"},
    {"action", "Remove"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogAdmin"},
    {"action", "Item"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Posts/Create",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogPostAdmin"},
    {"action", "Create"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Posts/{postId}/Edit",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogPostAdmin"},
    {"action", "Edit"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Posts/{postId}/Delete",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogPostAdmin"},
    {"action", "Delete"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Posts/{postId}/Publish",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogPostAdmin"},
    {"action", "Publish"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs/{blogId}/Posts/{postId}/Unpublish",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogPostAdmin"},
    {"action", "Unpublish"}
    },
    new RouteValueDictionary (),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Admin/Blogs",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogAdmin"},
    {"action", "List"}
    },
    new RouteValueDictionary(),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "Blogs",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "Blog"},
    {"action", "List"}
    },
    new RouteValueDictionary(),
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Route = new Route(
    "{*path}",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "BlogPost"},
    {"action", "ListByArchive"}
    },
    new RouteValueDictionary {
    {"path", _archiveConstraint},
    },
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    },
    new RouteDescriptor {
    Priority = ,
    Route = new Route(
    "{*path}",
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"},
    {"controller", "RemoteBlogPublishing"},
    {"action", "Rsd"}
    },
    new RouteValueDictionary {
    {"path", _rsdConstraint}
    },
    new RouteValueDictionary {
    {"area", "Orchard.Blogs"}
    },
    new MvcRouteHandler())
    }
    };
    }
    }
三、Orchard路由系统如何工作的。
1、将自定义路由注册到asp.net mvc路由系统中
        这个工作是在创建和激活shell的时候,调用 DefaultOrchardShell类的Activate方法时进行的
  1. publicvoidActivate()
    {
    var allRoutes =newList<RouteDescriptor>();
    allRoutes.AddRange(_routeProviders.SelectMany(provider => provider.GetRoutes()));
    allRoutes.AddRange(_httpRouteProviders.SelectMany(provider => provider.GetRoutes())); _routePublisher.Publish(allRoutes);//这里就是注册路由
    _modelBinderPublisher.Publish(_modelBinderProviders.SelectMany(provider => provider.GetModelBinders())); using (var events = _eventsFactory())
    {
    events.Value.Activated();
    } _sweepGenerator.Activate();
    }
2、路由的使用:像mvc路由一样使用自定义路由。
 

Orchard学习 02、orchard 路由的更多相关文章

  1. Orchard 学习-安装Orchard

    前段时间使用一个ABP的框架进行了一个简单CMS开发.但感觉自己开发CMS不够灵活和通用,所以还是学习一下Orchard.学习的第一步,阅读官方的文档.由于是英文,所以我对其进行了翻译和记录,方便自己 ...

  2. Orchard学习笔记

    1.下载Orchard sourcrs资源文件,同时也可以去百度下载中文包 资源地址(https://github.com/OrchardCMS/Orchard/releases/download/1 ...

  3. 200. Orchard学习 目录

    201. Orchard学习 一.基础 210. Orchard学习 二.启动 211. Orchard学习 二 1.Application_Start 212. Orchard学习 二 2.Manu ...

  4. Orchard学习系列-----如何运行的

    感慨:当接触到微软这套程序时,代码实在是太好了,好的几乎都读不懂.很久之前就对这个套开源程序特别感兴趣,但读不明白也让人郁闷. 背景(Orchard官网): 可组装系统的CMS系统,OrChard在运 ...

  5. JavaScript学习02 基础语法

    JavaScript学习02 基础语法 JavaScript中很多基础内容和Java中大体上基本一样,所以不需要再单独重复讲了,包括: 各种算术运算符.比较运算符.逻辑运算符: if else语句.s ...

  6. Java虚拟机JVM学习02 类的加载概述

    Java虚拟机JVM学习02 类的加载概述 类的加载 类的加载指的是将类的.class文件中的二进制数据读入到内存中,将其放在运行时数据区的方法区内,然后在堆区创建一个java.lang.Class对 ...

  7. Python学习02 列表 List

    Python学习02 列表 List Python列表 List Python中的列表(List)用逗号分隔,方括号包围(comma-separated values (items) between ...

  8. Android Testing学习02 HelloTesting 项目建立与执行

    Android Testing学习02 HelloTesting 项目建立与执行 Android测试,分为待测试的项目和测试项目,这两个项目会生成两个独立的apk,但是内部,它们会共享同一个进程. 下 ...

  9. [译]:Orchard入门——安装Orchard

    原文链接:Installing Orchard 文章内容基于Orchard 1.8版本 安装Orchard的方式 主要有以下四种方式安装Orchard: 利用Microsoft Web Platfor ...

随机推荐

  1. C语言常用修饰符

    前言 这两天在梳理自己C语言的知识,发现写了这么久的代码,居然所有的知识点都在自己的脑袋里.这可不好,万一老了呢.... 接下来的几天里,会以文字的形式,将这些知识整理出来,分享给大家. 想要看看英文 ...

  2. 【树状数组套主席树】带修改区间K大数

    P2617 Dynamic Rankings 题目描述给定一个含有n个数的序列a[1],a[2],a[3]……a[n],程序必须回答这样的询问:对于给定的i,j,k,在a[i],a[i+1],a[i+ ...

  3. c++函数写的都对,还是说incompatible或者not found的解决办法

    vs2010,c++,定义了一个函数如下,在BianHuanYuDib.h文件中: 在BianHuanYuDib.cpp中: 写的完全正确,但还是会报错: 很明显,连std都报错了,一般不是真的有很大 ...

  4. 【洛谷P1272】道路重建

    题目大意:给定一个 N 个节点的树,求至少剪掉多少条边才能使得从树中分离出一个大小为 M 的子树. 题解:考虑树形 dp,定义 \(dp[u][i][t]\) 为以 u 为根节点与前 i 个子节点构成 ...

  5. Java后台面试 常见问题

    Java后台面试 常见问题   从三月份找实习到现在,面了一些公司,挂了不少,但最终还是拿到小米.百度.阿里.京东.新浪.CVTE.乐视家的研发岗offer.我找的是java后台开发,把常见的问题分享 ...

  6. 收藏:Windows消息机制

    百度百科介绍的windows消息机制也不错:http://baike.baidu.com/view/672379.htm Windows的应用程序一般包含窗口(Window),它主要为用户提供一种可视 ...

  7. 3: $.ajax()方法详解

    1.url: 要求为String类型的参数,(默认为当前页地址)发送请求的地址. 2.type: 要求为String类型的参数,请求方式(post或get)默认为get.注意其他http请求方法,例如 ...

  8. maven 整合支付宝,导入alipay-sdk-java包到本地仓库

    maven 整合支付宝,导入alipay-sdk-java包到本地仓库   1.环境变量添加: MAVEN_HOME:(maven位置) M2_HOME:(maven位置) PATH:%M2_HOME ...

  9. laravel 单元测试设置模拟时间

    有时候我们需要对一些超时的逻辑进行测试,需要等待一定的时间来验证超时逻辑是否生效. Carbon 库提供了 setTestNow 方法来设置一个虚拟的当前时间 使用这个特性的前提是:我们的待测试代码利 ...

  10. Hadoop生态圈-使用Kafka命令在Zookeeper中对应关系

    Hadoop生态圈-使用Kafka命令在Zookeeper中对应关系 作者:尹正杰 版权声明:原创作品,谢绝转载!否则将追究法律责任. 一.zookeeper保存kafka的目录     二.使用Ka ...