标题:从零开始实现 ASP.NET Core MVC 的插件式开发(八) - Razor 视图相关问题及解决方案
作者:Lamond Lu
地址:https://www.cnblogs.com/lwqlun/p/13197683.html
源代码:https://github.com/lamondlu/Mystique
前景回顾
- 从零开始实现 ASP.NET Core MVC 的插件式开发(一) - 使用 Application Part 动态加载控制器和视图
- 从零开始实现 ASP.NET Core MVC 的插件式开发(二) - 如何创建项目模板
- 从零开始实现 ASP.NET Core MVC 的插件式开发(三) - 如何在运行时启用组件
- 从零开始实现 ASP.NET Core MVC 的插件式开发(四) - 插件安装
- 从零开始实现 ASP.NET Core MVC 的插件式开发(五) - 使用 AssemblyLoadContext 实现插件的升级和删除
- 从零开始实现 ASP.NET Core MVC 的插件式开发(六) - 如何加载插件引用
- 从零开始实现 ASP.NET Core MVC 的插件式开发(七) - 问题汇总及部分问题解决方案
简介
在上一篇中,我给大家分享了程序调试问题的解决方案以及如何实现插件中的消息传递,完稿之后,又收到了不少问题反馈,其中最严重的问题应该就是运行时编译 Razor 视图失败的问题。
本篇我就给大家分享一下我针对此问题的解决方案,最后还会补上上一篇中鸽掉的动态加载菜单(T.T)。
Razor 视图中引用出错问题
为了模拟一下当前的问题,我们首先之前的插件 1 中添加一个新类TestClass
, 并在HelloWorld
方法中创建一个TestClass
对象作为视图模型传递给 Razor 视图,并在 Razor 视图中展示出TestClass
的Message
属性。
- TestClass.cs
public class TestClass
{
public string Message { get; set; }
}
- HelloWorld.cshtml
@using DemoPlugin1.Models;
@model TestClass
@{
}
<h1>@ViewBag.Contenth1>
<h2>@Model.Messageh2>
- Plugin1Controller.cs
[Area("DemoPlugin1")]
public class Plugin1Controller : Controller
{
private INotificationRegister _notificationRegister;
public Plugin1Controller(INotificationRegister notificationRegister)
{
_notificationRegister = notificationRegister;
}
[HttpGet]
public IActionResult HelloWorld()
{
string content = new Demo().SayHello();
ViewBag.Content = content + "; Plugin2 triggered";
TestClass testClass = new TestClass();
testClass.Message = "Hello World";
_notificationRegister.Publish("LoadHelloWorldEvent", JsonConvert.SerializeObject(new LoadHelloWorldEvent() { Str = "Hello World" }));
return View(testClass);
}
}
这个代码看似很简单,也是最常用的 MVC 视图展示方式,但是集成在动态组件系统中之后,你就会得到以下错误界面。
这里看起来似乎依然感觉是AssemblyLoadContext
的问题。主要的线索是,如果你将插件 1 的程序集直接引入主程序工程中,重新启动项目之后,此处代码能够正常访问,所以我猜想Razor
视图才进行运行时编译的时候,使用了默认的AssemblyLoadContext
,而非插件AssemblyPart
所在的AssemblyLoadContext
。
由此我做了一个实验,我在MystiqueSetup
方法中,在插件加载的时候,也向默认AssemblyLoadContext
中加载了插件程序集
public static void MystiqueSetup(this IServiceCollection services,
IConfiguration configuration)
{
...
using (IServiceScope scope = provider.CreateScope())
{
MvcRazorRuntimeCompilationOptions option = scope.ServiceProvider.GetService();
IUnitOfWork unitOfWork = scope.ServiceProvider.GetService();
List allEnabledPlugins = unitOfWork.PluginRepository.GetAllEnabledPlugins();
IReferenceLoader loader = scope.ServiceProvider.GetService();foreach (ViewModels.PluginListItemViewModel plugin in allEnabledPlugins)
{
...using (FileStream fs = new FileStream(filePath, FileMode.Open))
{
System.Reflection.Assembly assembly = context.LoadFromStream(fs);
context.SetEntryPoint(assembly);
loader.LoadStreamsIntoContext(context, referenceFolderPath, assembly);
...
fs.Position = 0;
AssemblyLoadContext.Default.LoadFromStream(fs);
}
context.Enable();
}
}
...
}
重新运行程序,访问插件 1 的路由,你就会得到以下错误。
这说明默认AssemblyLoadContext
中的程序集正常加载了,只是和视图中需要的类型不匹配,所以此处也可以说明Razor
视图的运行时编译使用的是默认AssemblyLoadContext
Notes: 这个场景在前几篇中遇到过,在不同
AssemblyLoadContext
加载相同的程序集,系统会将严格的将他们区分开,插件 1 中的AssemblyPart
引用是插件 1 所在AssemblyLoadContext
中的DemoPlugin1.Models.TestClass
类型,这与默认AssemblyLoadContext
中加载的DemoPlugin1.Models.TestClass
不符。
在之前系列文章中,我介绍过两次,在 ASP.NET Core 的设计文档中,针对AssemblyLoadContext
部分的是这样设计的
- 每个 ASP.NET Core 程序启动后,都会创建出一个唯一的默认
AssemblyLoadContext
- 开发人员可以自定义
AssemblyLoadContext
, 当在自定义AssemblyLoadContext
加载某个程序集的时候,如果在当前自定义的AssemlyLoadContext
中找不到该程序集,系统会尝试在默认AssemblyLoadContext
中加载。
但是这种程序集加载流程只是单向的,如果默认AssemblyLoadContext
未加载某个程序集,但某个自定义AssemblyLoadContext
中加载了该程序集,你是不能从默认AssemblyLoadContext
中加载到这个程序集的。
这也就是我们现在遇到的问题,如果你有兴趣的话,可以去 Review 一下 ASP.NET Core 的针对 RuntimeCompilation 源码部分,你会发现当 ASP.NET Core 的 Razor 视图引擎会使用 Roslyn 来编译视图,这里直接使用了默认的AssemblyLoadContext
加载视图所需的程序集引用。
绿线是我们期望的加载方式,红线是实际的加载方式
为什么不直接用默认AssemblyLoadContext
来加载插件?
可能会有同学问,为什么不用默认的AssemblyLoadContext
来加载插件,这里有 2 个主要原因。
首先如果都使用默认的AssemblyLoadContext
来加载插件,当不同插件使用了两个不同版本、相同名称的程序集时, 程序加载会出错,因为一个AssemblyLoadContext
不能加载不同版本,相同名称的程序集,所以在之前我们才设计成了这种使用自定义程序集加载不同插件的方式。
其次如果都是用默认的AssemblyLoadContext
来加载插件,插件的卸载和升级会变成一个大问题,但是如果我们使用自定义AssemblyLoadContext
的加载插件,当升级和卸载插件时,我们可以毫不犹豫的 Unload 当前的自定义AssemblyLoadContext
。
临时的解决方案
既然不能使用默认AssemblyLoadContext
来加载程序集了,那么是不是只能重写 Razor 视图运行时编译代码来满足当前需求呢?
答案当然是否定了,这里我们可以通过AssemblyLoadContext
提供的Resolving
事件来解决这个问题。
AssemblyLoadContext
的Resolving
事件是在当前AssemblyLoadContext
不能加载指定程序集时触发的。所以当 Razor 引擎执行运行时视图编译的时候,如果在默认AssemblyLoadContext
中找不到某个程序集,我们可以强制让它去自定义的AssemblyLoadContext
中查找,如果能找到,就直接返回匹配的程序。这样我们的插件 1 视图就可以正常展示了。
public static void MystiqueSetup(this IServiceCollection services, IConfiguration configuration)
{
...
AssemblyLoadContext.Default.Resolving += (context, assembly) =>
{
Funcbool> filter = p =>
p.Assemblies.Any(p => p.GetName().Name == assembly.Name
&& p.GetName().Version == assembly.Version);if (PluginsLoadContexts.All().Any(filter))
{var ass = PluginsLoadContexts.All().First(filter)
.Assemblies.First(p => p.GetName().Name == assembly.Name
&& p.GetName().Version == assembly.Version);return ass;
}return null;
};
...
}
Note:这里其实还有一个问题,如果插件 1 和插件 2 都引用了相同版本和名称的程序集,可能会出现插件 1 的视图匹配到插件 2 中程序集的问题,就会出现和前面一样的程序集冲突。这块最终的解决肯定还是要重写 Razor 的运行时编译代码,后续如果能完成这部分,再来更新。
临时的解决方案是,当一个相同版本和名称的程序集被 2 个插件共同使用时,我们可以使用默认
AssemblyLoadContext
来加载,并跳过自定义AssemblyLoadContext
针对该程序集的加载。
现在我们重新启动项目,访问插件 1 路由,页面正常显示了。
如何动态加载菜单
之前有小伙伴问,能不能动态加载菜单,每次都是手敲链接进入插件界面相当的不友好。答案是肯定的。
这里我先做一个简单的实现,如果后续其他的难点都解决了,我会将这里的实现改为一个单独的模块,实现方式也改的更优雅一点。
首先在Mystique.Core
项目中添加一个特性类Page
, 这个特性只允许在方法上使用,Name
属性保存了当前页面的名称。
[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]
public class Page : Attribute
{
public Page(string name)
{
Name = name;
}
public string Name { get; set; }
}
第二步,创建一个展示导航栏菜单用的视图模型类PageRouteViewModel
,我们会在导航部分使用到它。
public class PageRouteViewModel
{
public PageRouteViewModel(string pageName, string area, string controller, string action)
{
PageName = pageName;
Area = area;
Controller = controller;
Action = action;
}
public string PageName { get; set; }
public string Area { get; set; }
public string Controller { get; set; }
public string Action { get; set; }
public string Url
{
get
{
return $"{Area}/{Controller}/{Action}";
}
}
}
第三步,我们需要使用反射,从所有启用的插件程序集中加载所有带有Page
特性的路由方法,并将他们组合成一个导航栏菜单的视图模型集合。
public static class CollectibleAssemblyLoadContextExtension
{
public static List GetPages(this CollectibleAssemblyLoadContext context)
{
var entryPointAssembly = context.GetEntryPointAssembly();
var result = new List();if (entryPointAssembly == null || !context.IsEnabled)
{return result;
}var areaName = context.PluginName;var types = entryPointAssembly.GetExportedTypes().Where(p => p.BaseType == typeof(Controller));if (types.Any())
{foreach (var type in types)
{var controllerName = type.Name.Replace("Controller", "");var actions = type.GetMethods().Where(p => p.GetCustomAttributes(false).Any(x => x.GetType() == typeof(Page))).ToList();foreach (var action in actions)
{var actionName = action.Name;var pageAttribute = (Page)action.GetCustomAttributes(false).First(p => p.GetType() == typeof(Page));
result.Add(new PageRouteViewModel(pageAttribute.Name, areaName, controllerName, actionName));
}
}return result;
}else
{return result;
}
}
}
Notes: 这里其实可以集成 MVC 的路由系统来生成 Url, 这里为了简单演示,就采取了手动拼凑 Url 的方式,有兴趣的同学可以自己改写一下。
最后我们来修改主站点的母版页_Layout.cshtml
, 在导航栏尾部追加动态菜单。
@using Mystique.Core.Mvc.Extensions;
@{
var contexts = Mystique.Core.PluginsLoadContexts.All();
var menus = contexts.SelectMany(p => p.GetPages()).ToList();
}
...
<header>
<nav class="navbar navbar-expand-sm navbar-toggleable-sm navbar-light bg-white border-bottom box-shadow mb-3">
<div class="container">
<a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="Index">DynamicPluginsDemoSitea>
<button class="navbar-toggler" type="button" data-toggle="collapse" data-target=".navbar-collapse" aria-controls="navbarSupportedContent"aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon">span>
button>
<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse">
<ul class="navbar-nav flex-grow-1">
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Index">Homea>
li>
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-controller="Home" asp-action="Privacy">Privacya>
li>
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-controller="Plugins" asp-action="Index">Pluginsa>
li>
<li class="nav-item">
<a class="nav-link text-dark" asp-area="" asp-controller="Plugins" asp-action="Assemblies">Assembliesa>
li>
@foreach (var item in menus)
{
<li class="nav-item">
<a class="nav-link text-dark" href="/Modules/@item.Url">@item.PageNamea>
li>
}
ul>
div>
div>
nav>
header>
这样基础设施部分的代码就完成了,下面我们来尝试修改插件 1 的代码,在HelloWorld
路由方法上我们添加特性[Page("Plugin One")]
, 这样按照我们的预想,当插件 1 启动的时候,导航栏中应该出现Plugin One
的菜单项。
[Area("DemoPlugin1")]
public class Plugin1Controller : Controller
{
private INotificationRegister _notificationRegister;
public Plugin1Controller(INotificationRegister notificationRegister)
{
_notificationRegister = notificationRegister;
}
[Page("Plugin One")]
[HttpGet]
public IActionResult HelloWorld()
{
string content = new Demo().SayHello();
ViewBag.Content = content + "; Plugin2 triggered";
TestClass testClass = new TestClass();
testClass.Message = "Hello World";
_notificationRegister.Publish("LoadHelloWorldEvent", JsonConvert.SerializeObject(new LoadHelloWorldEvent() { Str = "Hello World" }));
return View(testClass);
}
}
最终效果
下面我们启动程序,来看一下最终的效果,动态菜单功能完成。
总结
本篇给大家演示了处理Razor
视图引用问题的一个临时解决方案和动态菜单的实现,Razor
视图引用问题归根结底还是AssemblyLoadContext
的问题,这可能就是 ASP.NET Core 插件开发最常见的问题了。当然视图部分也有很多其他的问题,其实我一度感觉如果仅停留在控制器部分,仅实现 ASP.NET Core Webapi 的插件化可能相对更容易一些,一旦牵扯到Razor
视图,特别是运行时编译Razor
视图,就有各种各样的问题,后续编写部分组件可能会遇到更多的问题,希望能走的下去,有兴趣或者遇到问题的小伙伴可以给我发邮件(309728709@qq.com)或者在 Github(https://github.com/lamondlu/Mystique)中提 Issues,感谢支持。
前景回顾
- 从零开始实现 ASP.NET Core MVC 的插件式开发(一) - 使用 Application Part 动态加载控制器和视图
- 从零开始实现 ASP.NET Core MVC 的插件式开发(二) - 如何创建项目模板
- 从零开始实现 ASP.NET Core MVC 的插件式开发(三) - 如何在运行时启用组件
- 从零开始实现 ASP.NET Core MVC 的插件式开发(四) - 插件安装
- 从零开始实现 ASP.NET Core MVC 的插件式开发(五) - 使用 AssemblyLoadContext 实现插件的升级和删除
- 从零开始实现 ASP.NET Core MVC 的插件式开发(六) - 如何加载插件引用
- 从零开始实现 ASP.NET Core MVC 的插件式开发(七) - 问题汇总及部分问题解决方案