Orchard路由随记(一)

时间:2023-03-09 22:36:55
Orchard路由随记(一)

对于Orchard来说,个人以为要真正理解Orchard,必须理解其路由工作方式。

一、Orchard的自定义路由由三种类型组成

1、分发类:

HubRoute:其功能是按租户筛选出当前访问租户的路由

2、容器类:

shellRoute:其功能是按当前租户路由,如果此时没有其它路由,路由数据处理后,交由MVC的路由处理

3、插件类:

主要是: AliasRoute ,其主要功能是处理别名路由,当然其功能不仅如此。别名路由(如将:locahost/thisisolditem,变成locahost/i)通过保存在数据库中对照表AliasRecord来工作,此类由Orchard.Alias.Routes加入到路由描述中,在Orchard_Alias_AliasRecord表中查找是否有别名路由存在。

不论如何路由,最后都会交由标准的MVC路由管理

二、Orchard通过对IRouteProvider接口扫描,获取了一组关于RouteDescriptor的列表,并通过RoutePublisher类Publish方法将所有描述转换为租户路由

1、按 RouteDescriptor 的先级排列路由;

2、加入合理的域;

3、根据描述生成ShellRoute类型的路由;

4、第3步中,如果有插件路由,则ShellRoute类路由将其包装(图2);

5、将ShellRoute类路由包装在HubRoute类路由中,即除原如路由(MVC原生路由),其它路由均包装进了 HubRoute;

6、是后形成的可能是(插件类不一定启用)如下:

HubRoute(shellRoute(AliasRoute(MvcRouteHandler)));

三、由第二条及多租户运行时不难理解,Orchard访问情形

1、用户访问;

2、创建Host如果还没有的话;

3、形成租户设置列表;

4、通过URL来判断应该使用哪一个租户设置;

5、根据当前租户,使用HubRoute路由,筛选出当前租户路由,进行匹配;

6、找到合适的控制器执行操作;

四、以下是运行期,真实的数据截图

  1、路由集合(可见所有路由均被HubRoute包裹)Orchard路由随记(一)

2、shellRouteOrchard路由随记(一)