首页 > 代码库 > 《Prism 5.0源码走读》ModuleCatalog
《Prism 5.0源码走读》ModuleCatalog
概念
ModuleCatalog 是Prism中主要概念之一,主要用来保存应用程序可用的modules(模块),每个module都是用ModuleInfo来定义(包含module的名称、类型和位置)。
功能实现
ModuleCatalog继承自IModuleCatalog,IModuleCatalog声明了以下属性和方法:
- ModuleCatalog保存的所有modules
IEnumerable<ModuleInfo> Modules { get; }
- 获取某一module依赖的modules
IEnumerable<ModuleInfo> GetDependentModules(ModuleInfo moduleInfo);
- 获取包含参数modules及其依赖的所有modules
IEnumerable<ModuleInfo> CompleteListWithDependencies(IEnumerable<ModuleInfo> modules);
- 初始化ModuleCatalog,可在这个方法加载modules和验证modules
void Initialize();
- 添加一个module到ModuleCatalog
void AddModule(ModuleInfo moduleInfo);
ModuleCatalog除了实现IModuleCatalog声明的属性和方法外,还提供了许多其他属性和方法:
- 定义了grouped modules和非grouped modules
public IEnumerable<ModuleInfoGroup> Groups { get { return this.Items.OfType<ModuleInfoGroup>(); } } protected IEnumerable<ModuleInfo> GrouplessModules { get { return this.Items.OfType<ModuleInfo>(); } }
- Modules: 获取所有的modules,包含grouped和非grouped
public virtual IEnumerable<ModuleInfo> Modules { get { return this.GrouplessModules.Union(this.Groups.SelectMany(g => g)); } }
- 提供两个从XAML创建ModuleCatalog的static方法
public static ModuleCatalog CreateFromXaml(Stream xamlStream)public static ModuleCatalog CreateFromXaml(Uri builderResourceUri)
- 对modules的验证:
- 验证module是否重复;
- 验证modules没有循环引用;
- 验证不同的module group里的modules之间没有相互引用;
- 验证InitializationMode是WhenAvailable的module不能依赖于mode是OnDemand的module;(原因是加载的时机不能冲突)
public virtual void Validate() { this.ValidateUniqueModules(); this.ValidateDependencyGraph(); this.ValidateCrossGroupDependencies(); this.ValidateDependenciesInitializationMode(); this.Validated = true; }
- 重载了好几个AddModule方法
- 提供添加Module Group方法
public virtual ModuleCatalog AddGroup(InitializationMode initializationMode, string refValue, params ModuleInfo[] moduleInfos)
ModuleCatalog也可以作为基类来自定义catalog。
应用
在Bootstrapper中有两个Module Catalog相关的方法:创建和配置。
protected virtual IModuleCatalog CreateModuleCatalog() { return new ModuleCatalog(); } protected virtual void ConfigureModuleCatalog() { }
在使用Prism构建WPF应用程序的时候,我们一般会自定义一个bootstrapper继承自prism的UnityBootstrapper或MefBootstrapper (当然亦可以使用其他IoC container的extension bootstrapper)。
在定义的bootstrapper里面需要重写ConfigureModuleCatalog方法,把具体的module加入到module catalog里面。
protected override void ConfigureModuleCatalog() { base.ConfigureModuleCatalog(); ModuleCatalog moduleCatalog = (ModuleCatalog)this.ModuleCatalog; moduleCatalog.AddModule(typeof(HelloWorldModule.HelloWorldModule)); }
总结
ModuleCatalog的总体实现还是比较简单的,很容易看懂。但里面有一个很重要的算法本文暂为提及,会单独写一篇随笔来介绍。
这个算法就是如何验证modules之间的循环引用。
《Prism 5.0源码走读》ModuleCatalog
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。