使用 MVVM Toolkit Source Generators
关于 MVVM Toolkit
最近 .NET Community Toolkit 发布了 8.0.0 preview1,它包含了从 Windows Community Toolkit 迁移过来的以下组件:
CommunityToolkit.Common
CommunityToolkit.Mvvm
CommunityToolkit.Diagnostics
CommunityToolkit.HighPerformance
其中 CommunityToolkit.Mvvm 又名 MVVM Toolkit ,它是一个现代化、快速以及模块化的 MVVM 库。Nuget 安装脚本为:
Install-Package CommunityToolkit.Mvvm -Version 8.0.0-preview1
MVVM Toolkit source generators
Source Generators 是一项 C# 编译器功能,使 C# 开发人员能够在编译用户代码时进行检查,并动态生成新的 C# 源文件,以添加到用户的编译中。 通过这种方式,你的代码可以在编译过程中运行并检查你的程序以生成与其余代码一起编译的其他源文件。
新版本的 MVVM Toolkit 包含一个全新的 source generators,现在它是一个增量生成器,性能将会提升很多。这篇文章将简单介绍一下它的功能。
命令
在 MVVM 模式中,命令的写法让人有点烦恼。这是 MVVM Toolkit 中的通常写法:
private IRelayCommand _displayCommand;
IRelayCommand DisplayCommand => _displayCommand ??= new RelayCommand(new Action(Display), () => HasName);
private void Display()
{
}
首先,代码就不少。另外,_displayCommand
和 DisplayCommand
、Display()
是写在一起好呢,还是按字段、属性、函数的排序分别放在代码里的不同位置呢?又或者索性用 Partial 类分别放在不同的文件?
用 source generators 就没这些烦恼了,命令的定义可以简化成这样:
[ICommand(CanExecute = nameof(HasName))]
private void Display()
{
}
通过添加 ICommandAttribute,source generators 可以根据 Display()
这个函数名正确地生成 DisplayCommand
及对应的初始化代码。此外,还可以通过它的 CanExecute
属性指定将 ICommand 的 CanExecute 关联到对应的属性。
属性
属性也有和命令一样的烦恼,通常来说 MVVM 模式中的属性的写法如下:
private string name;
public string Name
{
get => name;
set => SetProperty(ref name, value);
}
其实还好,不会太多。但如果是这样呢:
private string _surname;
public string Surname
{
get
{
return _surname;
}
set
{
if (!EqualityComparer<string>.Default.Equals(_surnam
{
_surname = value;
OnPropertyChanged();
OnPropertyChanged(nameof(FullName));
OnPropertyChanged(nameof(HasName));
DisplayCommand.NotifyCanExecuteChanged();
}
}
}
public string FullName => $"{Name} {Surname}";
public bool HasName => !string.IsNullOrWhiteSpace(FullName);
这时候 source generators 的作用就可以很明显,因为它只需要下面的代码就可以自动产生与上面等价的代码:
[ObservableProperty]
[AlsoNotifyChangeFor(nameof(FullName), nameof(HasName))]
[AlsoNotifyCanExecuteFor(nameof(DisplayCommand))]
private string _surname;
public string FullName => $"{Name} {Surname}";
public bool HasName => !string.IsNullOrWhiteSpace(FullName);
从这段代码可以看到有三个 Attribute 起了作用:
ObservableProperty:自动为 _name
属性生成对应的属性。
AlsoNotifyChangeFor:属性值修改时同时触发 FullName
和 HasName
这两个属性的 PropertyChanged
事件。
AlsoNotifyCanExecuteFor:属性值修改时同时通知 DisplayCommand
执行它的 NotifyCanExecuteChanged()
。
注入到现有类
一般来说,MVVM Toolkit source generators 需要在 ObservableObject
的派生类中使用,例如:
public partial class TestModel: ObservableObject
但如果你的类已经继承了其它类,MVVM Toolk source generators 也允许你使用它的功能,方法是添加上 INotifyPropertyChangedAttribute
,代码如下:
[INotifyPropertyChanged]
public partial class TestModel: Behaviour
INotifyPropertyChangedAttribute
会自动生成实现 INotifyPropertyChanged 的代码,而无需更改基类。不过遗憾的是,INotifyPropertyChangedAttribute
目前只能在未实现 INotifyPropertyChanged
接口的类中使用,即下面这种代码不能编译通过:
[INotifyPropertyChanged]
public partial class TestModel: ObservableObject
成果
使用了 source generators 可以大幅减少代码,下面这图直观展示了减少的代码量。
如果需要查看自动生成的代码,可以在分析器的 CommunityToolkit.Mvvm.SourceGenerators 节点里找到:
一些小问题
MVVM Toolkit source generators 可以重构你的代码,但代价是什么?
首先,部分功能需要 C# 8.0 以上,所以编译时可能会看到这条错误:
The source generator features from the MVVM Toolkit require consuming projects to set the C# language version to at least C# 8.0
解决方法是在项目文件的 PropertyGroup 节点里添加这段指明 C# 的版本:
<LangVersion>9.0</LangVersion>
另外,MVVM Toolkit source generators 还需要 Visual Studio 2022 才可以使用。
还有一点,我还没找到为生成的属性添加注释的方法,这对一些难以理解的属性来说十分致命,只好用回传统方法来处理这种属性。
最后,没有 CodeLens,没法直观看到属性的引用、修改等信息,用起来不是很顺手。
最后
从上面的例子来看,无论从代码量、可维护性、可阅读性来看,source generators 都有巨大的优势,但在现阶段,MVVM Toolkit source generators 用起来还是有不少小问题,不能完全代替原生写法。不过这是个很符合 80/20 原则的工具:它可以让用户用 20% 的投入解决了 80% 的问题。
其它更多的内容,请参考 Github 或其它文档:
https://github.com/CommunityToolkit/dotnet
https://github.com/CommunityToolkit/dotnet/releases/tag/v8.0.0-preview1
https://docs.microsoft.com/zh-cn/windows/communitytoolkit/mvvm/introduction
最新文章
- 卷积神经网络提取特征并用于SVM
- 在Linux下配置多线路ADSL的方法
- 【Python②】python之首秀
- 高斯模糊算法的 C++ 实现
- AASM rule of scoring sleep stages using EEG signal
- 安装MySQL软件
- 在js中使用json
- directive和controller如何通信
- java编程思想笔记(第一章)
- gulp基于seaJs模块化项目打包实践【原创】
- [国嵌攻略][151][nandflash驱动程序设计]
- JSPWiki安装配置及FCKEditor的集成
- 【踩坑】iconfont使用异常bug
- springboot的拦截器Interceptor的性质
- python 连接 oracle 统计指定表格所有字段的缺失值数
- JavaScript基础视频教程总结(041-050章)
- CentOS 用挂了dev/sda1:UNEXPECTED INCONSISTENCY;RUN fsck MANUALLY .
- nodejs + ts 配置
- <;Yarn>;<;Node Labels>;
- Jmeter(十)检查点
热门文章
- 【LeetCode】1023. Binary String With Substrings Representing 1 To N 解题报告(Python)
- Robin Hood
- GCD - Extreme (II)(UVA11426)
- JSP的数据从数据库中获取导入type=date的input标签中
- Java集合与数组的联系和区别
- css 快速入门 系列 —— 浮动
- [Atcoder Regular Contest 071 F &; JZOJ5450]Neutral
- CSS基础-3 文字知识
- STC8H开发(二): 在Linux VSCode中配置和使用FwLib_STC8封装库(图文详解)
- 【Python+Django+Pytest】数据库异常pymysql.err.InterfaceError: (0, &#39;&#39;) 解决方案