(3/7).NET Core 3 WPF MVVM框架 Prism系列之模块化

本文来自转载

原文作者：RyzenAdorer

原文标题：.NET Core 3 WPF MVVM 框架 Prism 系列之模块化

原文链接：https://www.cnblogs.com/ryzen/p/12185054.html

本文将介绍如何在.NET Core3 环境下使用 MVVM 框架 Prism 的应用程序的模块化

1. 前言

我们都知道，为了构成一个低耦合，高内聚的应用程序，我们会分层，拿一个 WPF 程序来说，我们通过 MVVM 模式去将一个应用程序的分成 View-ViewModel-Model，大大消除之前业务逻辑和界面元素之间存在的高耦合，使我们后台开发人员可以将重点更放在业务逻辑层面上，属于 UI 界面的则可以交给更专业的 UI 人员

但是一个应用程序是由不同的业务模块来组合而成，我们理想状态下，每个业务模块拥有着能够独立的功能，并且和其他业务模块之间的是低耦合关系的，且每个业务模块可以单独用来开发,测试和部署，这样组成的应用程序是非常容易扩展，测试和维护的，而 Prism 提供将应用程序模块化的功能

我们先来看下一个小 Demo

再来看看解决方案的项目：

我将该小 demo，分为四个项目，其中 Shell 为主窗体项目，然后 MedicineModule 和 PatientModule 为我们分割开的业务模块，最后 Infrastructure 则为我们的公共共享项目，我们将一步步讲解该 demo 如何进行模块化的.

首先，我们引用官方的一个图，大致讲解了创建加载模块的流程：

注册/发现模块
加载模块
初始化模块

我们就根据这个流程来看看 demo 是如何进行模块化的？

2. 注册/发现模块

2.1. 注册模块

prism 注册模块有三种方式：

代码注册
目录文件扫描注册
配置文件 App.config 注册

我们先用代码注册的方式，首先我们要先定义模块，我们分别在 PrismMetroSample.MedicineModule 和 PrismMetroSample.PatientModule 两个项目中创建 MedicineModule 类和 PatientModule 类,代码如下：

MedicineModule.cs:

 public class MedicineModule : IModule
 {
     public void OnInitialized(IContainerProvider containerProvider)
     {
         var regionManager = containerProvider.Resolve<IRegionManager>();


         //MedicineMainContent
         regionManager.RegisterViewWithRegion(RegionNames.MedicineMainContentRegion, typeof(MedicineMainContent));

         //SearchMedicine-Flyout
         regionManager.RegisterViewWithRegion(RegionNames.FlyoutRegion, typeof(SearchMedicine));

         //rightWindowCommandsRegion
         regionManager.RegisterViewWithRegion(RegionNames.ShowSearchPatientRegion, typeof(ShowSearchPatient));
        }

     public void RegisterTypes(IContainerRegistry containerRegistry)
     {

     }
 }

PatientModule.cs:

 public class PatientModule : IModule
 {
     public void OnInitialized(IContainerProvider containerProvider)
     {
         var regionManager = containerProvider.Resolve<IRegionManager>();

         //PatientList
         regionManager.RegisterViewWithRegion(RegionNames.PatientListRegion, typeof(PatientList));
         //PatientDetail-Flyout
         regionManager.RegisterViewWithRegion(RegionNames.FlyoutRegion, typeof(PatientDetail));

     }

     public void RegisterTypes(IContainerRegistry containerRegistry)
     {

     }
 }

2.1.1. 代码注册

然后我们在 PrismMetroSample.Shell 主窗体的项目分别引用 PrismMetroSample.MedicineModule 和 PrismMetroSample.PatientModule 程序集，之后在 App.xaml.cs 中代码注册：

protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog)
{
   moduleCatalog.AddModule<PrismMetroSample.PatientModule.PatientModule>();

    //将MedicineModule模块设置为按需加载
   var MedicineModuleType = typeof(PrismMetroSample.MedicineModule.MedicineModule);
   moduleCatalog.AddModule(new ModuleInfo()
   {
        ModuleName= MedicineModuleType.Name,
        ModuleType=MedicineModuleType.AssemblyQualifiedName,
        InitializationMode=InitializationMode.OnDemand
    });

 }

注：代码注册是没有所谓的发现模块部分，是直接注册部分

2.1.2.目录文件扫描注册

2.1.2.1. 注册模块

首先我们先在 MedicineModule 加上特性,OnDemand 为 true 为"按需"加载，而 PatientModule 默认加载则可以不加

 [Module(ModuleName = "MedicineModule", OnDemand =true)]
 public class MedicineModule : IModule

然后我们将 PrismMetroSample.MedicineModule 项目和 PrismMetroSample.PatientModule 项目设置生成事件 dll 拷贝到 PrismMetroSample.Shell 项目 bin\Debug 下的 Modules 文件夹下

生成事件命令行如下：

xcopy "$(TargetDir)$(TargetName)*$(TargetExt)" "$(SolutionDir)\PrismMetroSample.Shell\bin\Debug\netcoreapp3.1\Modules\" /Y /S

2.1.2.2. 发现模块

然后我们在 App.xaml.cs 重载实现该函数：

protected override IModuleCatalog CreateModuleCatalog()
{
   //获取该路径下的文件夹的模块目录
   return new DirectoryModuleCatalog() { ModulePath = @".\Modules" };
}

2.1.3. 使用配置文件 App.config 注册#

2.1.3.1. 注册模块

我们在主窗体项目 PrismMetroSample.Shell 添加一个 App.config 文件:

App.config:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="modules" type="Prism.Modularity.ModulesConfigurationSection, Prism.Wpf"/>
  </configSections>
  <modules>
    <!--注册PatientModule模块-->
    <module assemblyFile="PrismMetroSample.PatientModule.dll" moduleType="PrismMetroSample.PatientModule.PatientModule, PrismMetroSample.PatientModule, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" moduleName="PatientModule" startupLoaded="True" />
    <!--注册MedicineModule模块-->
    <module assemblyFile="PrismMetroSample.MedicineModule.dll" moduleType="PrismMetroSample.MedicineModule.MedicineModule, PrismMetroSample.MedicineModule, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" moduleName="MedicineModule" startupLoaded="false" />
  </modules>
</configuration>

其中 startupLoaded 为 true 则设置自动加载，为"可用时"模块，为 false 则不加载，设置为“按需”模块

2.1.3.2. 发现模块

修改 App.xaml.cs 的 CreateModuleCatalog 函数：

App.xaml.cs：

 protected override IModuleCatalog CreateModuleCatalog()
 {
    return new ConfigurationModuleCatalog();//加载配置文件模块目录
 }

3. 加载模块

prism 应用程序加载模块有两种方式：

加载“可用时”的模块(默认方式)
根据情况加载“按需”模块

在代码注册时候，我将通过默认方式注册了 PatientModule，然后注册 MedicineModule 将其设置为"按需"加载，“按需”加载有个好处就是，应用程序运行初始化后，MedicineModule 模块是不加载到内存的，这样就提供了很大的灵活空间，默认我们可以加载一些"可用"的模块,然后我们可以根据自身要求去"按需"加载我们所需要的模块

这里可以讲解下按需加载 MedicineModule 的代码实现，首先我们已经在 App.cs 中将 MedicineModule 设置为"按需"加载，然后我们在主窗体通过一个按钮去加载 MedicineModule，代码如下:

MainWindowViewModle.cs:

 public class MainWindowViewModel : BindableBase
 {
    IModuleManager _moduleManager;
    public MainWindowViewModel(IModuleManager moduleManager)
    {
       _moduleManager = moduleManager;
    }

    private DelegateCommand _loadPatientModuleCommand;
    public DelegateCommand LoadPatientModuleCommand =>
        _loadPatientModuleCommand ?? (_loadPatientModuleCommand = new DelegateCommand(ExecuteLoadPatientModuleCommand));

    void ExecuteLoadPatientModuleCommand()
    {
       _moduleManager.LoadModule("MedicineModule");
    }
 }

我们还可以去检测加载模块完成事件，我们 MainWindowViewModle 中加上这几句：

IModuleManager _moduleManager;
public MainWindowViewModel(IModuleManager moduleManager)
{
   _moduleManager = moduleManager;
   _moduleManager.LoadModuleCompleted += _moduleManager_LoadModuleCompleted;
}

private void _moduleManager_LoadModuleCompleted(object sender, LoadModuleCompletedEventArgs e)
{
   MessageBox.Show($"{e.ModuleInfo.ModuleName}模块被加载了");
}

效果如下:

4. 初始化模块

加载模块后，模块就会进行初始化，我们以 MedicineModule 为例子,先来看看代码：

 public class MedicineModule : IModule
 {
     public void OnInitialized(IContainerProvider containerProvider)
     {
         var regionManager = containerProvider.Resolve<IRegionManager>();


         //MedicineMainContent
         regionManager.RegisterViewWithRegion(RegionNames.MedicineMainContentRegion, typeof(MedicineMainContent));

         //SearchMedicine-Flyout
         regionManager.RegisterViewWithRegion(RegionNames.FlyoutRegion, typeof(SearchMedicine));

         //rightWindowCommandsRegion
         regionManager.RegisterViewWithRegion(RegionNames.ShowSearchPatientRegion, typeof(ShowSearchPatient));
        }

     public void RegisterTypes(IContainerRegistry containerRegistry)
     {

     }
 }

其中，IModule 接口定义了两个函数 OnInitialized 和 RegisterTypes,其中初始化顺序是 RegisterTypes->OnInitialized，也就是 RegisterTypes 函数会先于 OnInitialized 函数，虽然这里我没在 RegisterTypes 写代码，但是这里通过是可以依赖注入到容器，给 MedicineModule 模块使用的，而 OnInitialized 我们通常会注册模块试图，或者订阅应用程序级别的事件和服务，这里我是将三个 View 分别分区域注册模块视图

最后，其实一开始我们看到 Demo 演示，点击病人列表，出来的病人详细页是没有数据的，这涉及到窗体之间的通讯，病人列表和病人详细页属于同一模块,这很好办，如何我要将搜索到的药物加到当前病人详细页的药物列表里面，这就涉及到不同模块窗体之间的通讯，处理不好是会造成模块之间的强耦合，下篇我们会讲到如何使用事件聚合器来实现同一模块不同窗体的通讯和不同模块不同窗体的通讯，而完整的 Demo 也会在下一篇放出。