MvvmCross 框架中 ViewModel 之间的导航以及生命周期

介绍 MvvmCross (Mvx) 框架中的 ViewModel 之间的导航以及 ViewModel 的生命周期。

在 ViewModel 之间导航

Mvx 框架中，用一个页面跳转到另一个页面，对应的也会从一个 ViewModel 跳转到另外的 ViewModel ，页面间的跳转由 ViewModel 发起，通常会调用 ShowViewModel 方法来完成 ViewModel 之间的导航，这个方法提供了一下几个重载版本：

protected bool ShowViewModel<TViewModel>(
    IMvxBundle parameterBundle = null,
    MvxBundle presentationBundle = null,
    MvxRequestedBy requestedBy = null
) where TViewModel : IMvxViewModel { ... };

这个重载版本所有的参数的默认值都是 null ，可以不提供任何参数。

protected bool ShowViewModel<TViewModel>(
    object parameterValuesObject,
    MvxBundle presentationBundle = null,
    MvxRequestedBy requestedBy = null
) where TViewModel : IMvxViewModel { ... };

这个重载版本需要提供一个类型为 object 的对象，通常会使用匿名对象或者一个复杂类型对象，其它参数为可选。

protected bool ShowViewModel<TViewModel>(
    IDictionary<string, string> parameterValues,
    MvxBundle presentationBundle = null,
    MvxRequestedBy requestedBy = null
) where TViewModel : IMvxViewModel { ... };

这是使用字典参数的重载版本，可以传入一个 Key 和 Value 均为字符串的字典。

当然，还有一些非泛型的版本没有列出来，值得一提的是，虽然有这么多重载版本的导航函数，在项目中推荐使用统一一种风格的版本。

ViewModel 的生命周期

基于依赖注入的创建 (Construct)

Mvx 提供了一个依赖注入容器，它在初始化 ViewModel 时就使用了依赖注入，比如 ViewModel 的构造函数是这样的：

public MyViewModel(IEmailService service) { ... }

如果 IEmailService 已经在 Mvx 容器中注册过了， IEmailService 对应的实例就会自动注入给 MyViewModel ，如果在程序中需要手工初始化一个对象，也可以通过 Mvx.IocConstruct<T>() 方法来初始化指定的 ViewModel 。

构造函数与不使用上面 ShowViewModel 方法中传递的参数，参数会传递给下面要介绍的 Init 方法。

基于约定的初始化 (Init)

ViewModel 的构造函数执行完成之后， Mvx 接下来会调用 ViewModel 的 Init 方法，这个方法接收 ShowViewModel 传递的参数， Init 方法的参数可以有以下几种形式：

多个简单类型的参数

使用多个简单类型的参数，签名如下所示：

public void Init(int a, string b, float c)

要调用这种签名类型的参数，需要在 ShowViewModel 方法的参数中使用匿名类 (anonymous class) ，并且匿名类的属性名称必须和 Init 函数的各个参数名称相同。

一个复杂类型的参数

Init 方法还可以使用一个复杂类型的参数，并且只能有一个参数，参数的成员只能包含简单类型，如下所示：

public void Init(Parameter param)

要调用这种类型的参数，需要在 ShowViewModel 方法的参数中使用对应类型的实例。

使用 IMvxBundle 参数

如果上面的两种形式都不能满足需要，则还可以使用 IMvxBundle 参数，如下所示：

public void init(IMvxBundle)

IMvxBundle 是 Mvx 提供的类型，类似于字典，可以自己读写需要的类型，要调用到这个方法，需要在 ShowViewModel 方法中提供 IMvxBundle 的实例，不过很少用到这种类型的 Init 方法。

上面的三种形式的 Init 方法可以同时出现在一个 ViewModel 中，不过推荐的是在一个应用中只是用一种风格的 Init 方法。

简单类型是指是指 int , long , double , string , Guid, enum 。

ReloadState

如果 ViewModel 是从墓碑状态中恢复的，将会调用 ReloadState 方法，否则不会调用这个方法。这个方法支持的参数形式和 Init 相同，一般 Mvx 期待的形式如下所示：

public class DetailViewModel : MvxViewModel {
  // ...

  public class SavedState {
  
    public string Name {get;set;}
    public int Position {get;set;}
  }

  public void ReloadState(SavedState savedState) {
    // use savedState
  }

  // ...
}

既然有 ReloadState ，就肯定会有 SaveState ， SaveState 也有两种实现形式：

使用无参数的方法返回强类型的对象

public class DetailViewModel : MvxViewModel {

  public class SavedState {
    public string Name {get;set;}
    public int Position {get;set;}
  }

  public SavedState SaveState() {
    return new SavedState() {
      Name = _name,
      Position = _position
    };
  }

}

重写 SavedStateToBundle(IMvxBundle bundle) 方法

public class DetailViewModel : MvxViewModel {

  protected override void SaveStateToBundle(IMvxBundle bundle) {
    bundle.Data["Name"] = _name;
    bundle.Data["Position"] = _position.ToString();
  }

}

Start

调用完 Construction 、 Init 和 ReloadState 之后，会调用 ViewModel 的 Start 方法，如下所示：

public class DetailViewModel : MvxViewModel {
  // ...

  public override void Start() {
    // do any start
  }

  // ...
}

在安卓系统下使用了 MvxFragment 可以在 Fragment 的 OnStart 方法中调用 ViewModel 的 Start 方法。

程序员浪费生命的几种方式

SQL Server 中的 ROW_NUMBER 函数