【WPF】运用MEF实现窗口的动态扩展

若干年前,老周写了几篇有关MEF的烂文,简单地说,MEF是一种动态扩展技术,比如可以指定以某个程序集或某个目录为搜索范围,应用程序在运行时会自动搜索符合条件的类型,并自动完成导入,这样做的好处是,主程序的代码不用改来改去,只需要把扩展的程序集放到对应的目录下就可以了。

MEF不仅可以用于“看不见”的类型扩展上,对于“看得见”的类型照样适用,比如窗口、控件之属,你要是够牛逼的话,甚至可以把它用到ASP.NET上,不过这个玩意儿估计要配合重写路由规则才能实现,根据URL传的参数来跳转到具体的页面。

较为简单的,像Windows Forms中的窗口,WPF中的窗口或控件,就可以直接运用MEF来完成扩展,主应用程序界面可以动态生成菜单项或按钮来打开窗口就可以了。而各个窗口的实现代码可以写在一个类库项目中。

 

下面,咱们用一个实实在在的例子来说明一下。

新建一个类库项目,然后在里面做三个WPF窗口,XAML文档如何与代码类关联,这个不要问我,问MSDN姐姐去。

因为这是做测试,窗口的UI布局你可以随便设计。

 

给大家一个提示吧,XAML文件和窗口类的代码文件的关联方法,和ASP.NET中.aspx文件与代码文件的关联方法一样。例如XAML文件名叫 test.xaml,那么对应的代码文件名就是test.xaml.cs(VB语言的话,是test.xaml.vb)。

对窗口来说,一般是从Window类派生,所以,XAML文档的根元素要写Window,比如

<Window>
   ……
</Window>

XAML中有两个必备的命名空间要引入:

<Window x:Class="wpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

…………

.../xaml/presentation 表示的WPF中的UI类型,比如Button、Canvas等;而那个带x前缀的.../xaml表示的是XAML语法本身特有的东西,比如x:Class,这个特性就是联合XAML文件和代码文件的关键,用它来指定窗口类的名字,类名要包括命名空间名。

 

下面的步骤相当重要,不然就无法MEF了。

打开窗口的代码文件,在窗口类声明上添加导出声明。如下

    [Export(typeof(Window))]
    [ExportMetadata("name", "窗口 A")]
    public partial class DemoWindow1 : Window
    {
        public DemoWindow1()
        {
            InitializeComponent();
            Title = $"演示窗体 -- {nameof(DemoWindow1)}";
        }
    }

 声明导出需要一个协定,因为类型是可以动态扩展的,所以这些扩展的类型必须要向运行时表明它们有一个共同点,以便让MEF能够找到它,这就是类型协定。我们知道,所有窗口类都有一个共同点——从Window类派生,故而在声明ExportAttribute时,用Window类的Type来标注协定。

ExportMetadataAttribute表示的是元数据,它是可选的,指定方式和字典的key - value形式差不多,name是字符串,value是Object类型,虽然可以指任何类型的value,但最好是可序列化的类型或者基础类型(byte,string,int等),这样方便传递。在接收扩展的代码中,可以用IDictionary<string, object>类型来接收元数据,也可以自定义一个类型(接口、类)来接收,只要属性/字段的名字和ExportMetadataAttribute中的name相等就行了,这样元数据就会自动填充到类型的属性/字段成员中。

比如,如果你指定元数据的name为“Age”,value为25,那么你自定义的类型只要公开一个名为Age的属性或字段即可,获取时会自动填充数据。

 

这里我一口气做了三个窗口,最后,可以定义一个类,把上面的N个窗口批量导入这个类的一个属性中,随后导出这个类的这个属性。

    class WindowsCompos
    {
        [Export("extWindows")]
        [ImportMany(typeof(Window))]
        public IEnumerable<ExportFactory<Window, IDictionary<string,object>>> ExtWindows { get; set; }
    }

 ImportMany可以一次性导入多个类型,因为扩展的窗口有N个,所以要使用这个特性来批量导入,还记得吧,前面的窗口都是以Window的Type作为协定来导出的,所以在导入时,一定指定匹配的协定,不然无法导入。

因为类型有多个,所以要用IEnumerable<T>(协变)来存放,而其中的T为ExportFactory<T, TMetadata>,本来用ExportFactory<T>就可以了,但由于我为每个窗口的导出定义了元数据,所以要使用支持获取元数据的工厂类型。

这个类可以不定义为public,因为导出的是它的属性,而且对于MEF来说,非public的成员都可以导出,只要你指定导出协定即可。

对于ExtWindows属性,导出声明就不必使用Type作为协定了,直接指定一个名字来做协定就可以了,本例是extWindows,注意这个协定名是区分大小写的,ext和Ext被视为不同的协定。

通常,接收扩展类型用的是Lazy<T>,以达到延迟实例化,但是,这个项目比较特殊,不能用Lazy来承载类型。WPF的窗口类有个特点,就是每次显示窗口必须使用新的实例,因为窗口一旦Close之后,就不能再次Show了,只能重新new一个实例才能Show。基于这原因,用ExportFactory类最好,这个类每次访问都能重新创建实例,调用CreateExport方法能创建一个ExportLifetimeContext<T>实例,再通过这个ExportLifetimeContext<T>实例的Value属性来得到窗口实例。

ExportLifetimeContext<T>实现了IDisposable接口,可以写在using语句中,用完后释放掉。

 

现在回到主应用程序项目,开始导入扩展窗口。

主窗口用一个菜单就行了,每个导入的窗口类型将作为菜单项。

    <Grid>
        <Menu VerticalAlignment="Top">
            <MenuItem Header="窗口" Name="menuWindows">
                <!-- ****** -->
            </MenuItem>
        </Menu>
    </Grid>

 

下面代码将获取导出对象,由于刚才用IEnumable<T>来导入了窗口类型,所以此处只需要获取这个属性的值即可。

        IEnumerable<ExportFactory<Window, IDictionary<string, object>>> ext_windowslist;
        CompositionContainer container = null;
        public MainWindow()
        {
            InitializeComponent();

            Assembly extAss = Assembly.Load(nameof(ExtWindowLib));
            AssemblyCatalog catelog = new AssemblyCatalog(extAss);

            container = new CompositionContainer(catelog);

            CompositionExtWindows();
            AddExtToMenuitems();

            menuWindows.AddHandler(MenuItem.ClickEvent, new RoutedEventHandler(OnMenuItemClicked));
        }

 CompositionContainer是个容器,用它可以组合所有获取到的扩展类型,实例化容器时,要指定一个搜索范围,这里我指定它从刚才那个类库项目中搜索。因为我已经引用了这个类库项目,所以调用Assembly.Load(程序集名)就可以直接加载了。

CompositionExtWindows方法负责从容器中获取导出的IEnumrable<T>对象,代码如下:

        private void CompositionExtWindows()
        {
            if (container == null) return;

            ext_windowslist = container.GetExportedValue<IEnumerable<ExportFactory<Window, IDictionary<string, object>>>>("extWindows");
        }

 直接调用GetExportedValue方法就可以获取到导出的属性值,参数是刚刚给ExtWindows属性指定的协定名。

 

AddExtToMenuitems方法把获取到的扩展窗口类型添加到子菜单项,这样一来,有多少个扩展窗口,就有多少个菜单项。

        private void AddExtToMenuitems()
        {
            foreach (var factory in ext_windowslist)
            {
                // 元数据
                IDictionary<string, object> metadata = factory.Metadata;
                string hd = metadata["name"] as string;
                MenuItem mnitem = new MenuItem();
                mnitem.Header = hd;
                mnitem.Tag = factory;
                menuWindows.Items.Add(mnitem);
            }
        }

让菜单项的Tag属性引用 ExportFactory实例,以便在Click事件处理方法中访问。

 

菜单项的Click事件处理如下:

        private void OnMenuItemClicked(object sender, RoutedEventArgs e)
        {
            MenuItem item = e.Source as MenuItem;
            ExportFactory<Window> fact = item.Tag as ExportFactory<Window>;
            if (fact != null)
            {
                using (var lifeobj = fact.CreateExport())
                {
                    Window w = lifeobj.Value;
                    w.Show();
                }
            }
        }

 从Value属性中获取窗口实例,就可以调用Show方法来显示窗口了。

 

来,运行一下,看看如何。运行后,会自动添加三个菜单项,因为我刚刚做了三个窗口。

 

点击对应的菜单,就能打开对应窗口。

 

 

现在,不妨往类库项目中再添加一个窗口。

    [Export(typeof(Window))]
    [ExportMetadata("name", "窗口 D")]
    public partial class DemoWindow4 : Window
    {
        public DemoWindow4()
        {
            InitializeComponent();
            Title = $"演示窗体 -- {nameof(DemoWindow4)}";
        }
    }

 

主应用程序的代码不用做任何改动,然后直接运行。

此时,你会看到,第4个窗口也自动加进来了。

 

有没有发现,这几个菜单项的排序好像不太好看,要是能按一定顺序排列多好。这个实现起来不难,老周就不实现了,你自己试着干吧。

老周可以给个提示,还记得在ExportAttribute声明导出类型时,可以指定元数据,例子中,老周指定了一个叫name的元数据,你可以指定一个叫order的元数据,值为数值,比如第一个窗口为1,第二个窗口为2……

然后,在主程序项目中获取组合扩展时,可以用IEnumerable<T>的扩展方法进行排序,也可以用LinQ语法来排序。

 

好了,文章就写到这里吧,See you.

示例代码下载

 

===================================================================

有热心朋友给老周留言,问老周,为什么你的博文的右下角,老有人点“反对”,老周你是不是得罪人了。

谢谢朋友,你不说我还真没注意,因为老周从来不在意那些虚的东西,故一直没注意到这个。实话说,老周从来不得罪人,老周只会得罪妖魔鬼怪,所以朋友多虑了。

至于说右下角那两个按钮,可能是一些没文化的人,本来是想点击左边的,由于不认识汉字,错点了右边的按钮。

总之,大家不要在意这些无关紧要的东西,如果你觉得老周写的烂文对你有用,那你就姑且当娱乐新闻看看吧,毕竟老周的写作水平不高,老周已经在努力优化了,争取多读点经典名著和大师著作,提升水平。

 

posted @ 2016-09-06 11:03  东邪独孤  阅读(5142)  评论(2编辑  收藏  举报