caliburn,解析Caliburn.Micro(二)

书接前文,前篇文章简略了介绍了一下Caliburn.Micro(简称CM),这篇文章来走入CM,看看它最有意思的Action。

运行CM

下载Caliburn.Micro,打开Template,拷贝Caliburn_Micro_WPF.zip到%userprofile%\Documents\Visual Studio 2010\Templates\ProjectTemplates\Visual C#\Windows,在Visual Studio 2010中新建工程,选择Visual C#—Windows,可以看到Caliburn.Micro的模板,新建工程CaliburnMicroWPF1,如下:
Capturecaliburn,解析Caliburn.Micro(二)
Framework文件夹下就是Caliburn.Micro的源码,ShellView是主Window,ShellViewModel是ShellView的DataContext,这是一个标准的View-ViewModel模式。AppBootstrapper是启动加载器,可以配置CM的加载策略。

Bootstrapper

Bootstrapper的构造函数如下:
1: public Bootstrapper()
2: {
3: if (IsInDesignMode)
4: StartDesignTime();
5: else StartRuntime();
6: }
可以重载StartDesignTime来为Blend等配置Design时的数据,程序运行时,StartRunTime被调用,
1: protected virtual void StartRuntime()
2: {
3: Execute.InitializeWithDispatcher();
4: AssemblySource.Instance.AddRange(SelectAssemblies());
5:
6: Application = Application.Current;
7: PrepareApplication();
8:
9: Configure();
10: IoC.GetInstance = GetInstance;
11: IoC.GetAllInstances = GetAllInstances;
12: IoC.BuildUp = BuildUp;
13: }
可以重载PrepareApplication监听Application的事件,或者重载Configure函数来设置IOC(Inversion of control/控制反转)容器。比较有意思的是后三个IoC的静态字段:
1: public static class IoC
2: {
3: public static Func GetInstance;
4: public static Func> GetAllInstances;
5: public static Action BuildUp;
6:
7: public static T Get()
8: {
9: return (T)GetInstance(typeof(T), null);
10: }
11:
12: public static T Get(string key)
13: {
14: return (T)GetInstance(typeof(T), key);
15: }
16: }
IoC是一个静态类,用来提供IOC的支持,其中的Get方法通过类型来查询注册的实例。通常的做法一般是把IoC定义为虚基类,子类通过重载其中的Get方法来实现自己IoC逻辑。IoC类通过3个静态Func来实现多态,AppBootstrapper使用了MEF作为I默认的IOC实现。可以重载Bootstrapper来使用其他的IOC,如Unity等。

MEF

MEF(Managed Extensibility Framework),在.net4.0后被正式引入.net framework中,通过简单的附加Export,Import标签,表明组件之间的“消费”和“提供”关系,MEF在底层动态的完成组件识别,装配工作。MEF的出现,使开发基于插件架构的应用系统变得更加简单,本文不是详细介绍MEF的,作为默认的IoC实现,Caliburn.Micro使用了MEF。
这里的使用,只是默认采用了MEF,具体说是使用了其中的CompositionContainer作为IoC容器,CM本身和MEF并没有什么联系,让我们把目光集中到CM上,从一个最简单的应用开始,走入Caliburn.Micro。

第一个应用程序

在ShellView中加入一个Button,从Blend—Assets中加入ActionMessage到Button,设置Trigger的EventName为Click。切换到ShellViewModel中,加入Show函数
1: public void Show()
2: {
3: MessageBox.Show("Hello");
4: }
回到ShellView中,设置ActionMessage的MethodName为Show,如图:
CaptureCapturecaliburn,解析Caliburn.Micro(二)
程序运行后,点击Button,Show函数被调用。
这是一个最简单的ActionMessage用法,让我们来分析一下这个过程。
简单来说是Button点击后方法被执行,最原始的做法应该是在Button的XAML中加入Click=”HandleBtnClick”把事件绑定到后台处理函数。后来MVVM开始流行,设置ShellViewModel作为ShellView的DataContext,在ShellViewModel中提供ICommand--ShowCommand,然后把Button的Command设置为Command=“{Binding ShowCommand}”。
这里ActionMessage处理的事情有二:
  1. 通过名字匹配自动把ShellViewModel设置为ShellView的DataContext。
  2. 通过反射用名字取到对应的方法,Invoke该方法。
这个思路是很清晰的,第一步的匹配是CM中的一个特色Convention,自动匹配XXViewModel和XXView。第二步会在前面查到的XXViewModel中查询名字为Show的MethodInfo,然后反射调用。

ActionMessage

ActionMessage的设计思路并不复杂,它继承自TriggerAction,可以作用于FrameworkElement。程序运行后,TriggerAction会被Attach到其对应的FrameworkElement上,ActionMessage有两个重要的属性:MethodName和Parameters,前者是需要执行方法的名字,后者是一个集合,表示传入的参数。MethodName前面已经介绍过了,让我们来看一下Parameters的用法。
最简单的应用,可以修改前面ViewModel中的Show()方法为Show(string message),然后在Parameters里传入Show方法的参数,如
1:
2:
3:

Show方法执行后,woo~参数被传入,Parameters也可以传入多个参数,当找不到匹配参数的方法时会抛出异常。CM对Parameter的Value参数进行了扩展:
  1. Value支持绑定,可以写成Value={Binding ElementName=XX, Path=XX}的方式
  2. CM提供了MessageBinder类对Message进行解析,可以指定$eventArgs传入执行方法的arg,指定$source传入绑定的UI,$dataContext传入对应的DataContext等。可以扩展MessageBinder的SpecialValues向其中加入更多的解析规则,默认的这些特殊解析都是以$为开头的。

Message.Attach

前面ActionMessage的写法是
1:
借助于Blend中的Interaction,把路由事件Click与ActionMessage连接起来,CM为ActionMessage提供了更为强大的Attach功能,可以把前面的代码改写成
1: