0x01 - 我的第一个 Object Visitor

原创

newbe36524

修改于 2020-12-15 10:33:13

4480

修改于 2020-12-15 10:33:13

文章被收录于专栏：newbe36524的技术专栏newbe36524的技术专栏

我的第一个 Object Visitor

预演准备

为了顺利的进行测试，你需要确保本地已经安装了以下这些必备的软件：

dotnet 2.1 或者以上版本的 SDK，我们更建议直接安装 dotnet 5 SDK。下载地址：https://dotnet.microsoft.com/download
安装一个趁手的 .net IDE。本演示过程将会使用 Visual Studio Code 作为基础演示 IDE。你也可以选择 Rider 或者 Visual Studio 来完成。

创建测试项目

我们需要一个测试项目来演示如何创建一个属于你的第一个 Object Visitor。

首先，确保本地已经正确安装了 dotnet 2.1 或者以上版本的 sdk，你可以运行以下命令来确认当前安装的版本:

dotnet --info

然后，随便找一个你喜欢的文件夹，运行以下命令来创建用于演示的测试控制台程序:

dotnet new console

最后，继续运行以下命令来安装最新的 Newbe.ObjectVisitor 工具包:

dotnet add package newbe.objectvisitor

这样，用于测试的项目就创建完成了。

创建一个简单的数据模型

我们使用 IDE 打开刚刚创建的项目，添加一个简单的数据模型类 OrderInfo :

public class OrderInfo{ public int OrderId { get; set; } public string Buyer { get; set; } public decimal TotalPrice { get; set; }}

实现一个拼接所有属性的逻辑

我们在 Program.cs 中添加以下代码来完成这些逻辑：

new 一个 OrderInfo order
使用 StringBuilder 将 order 的所有属性名称和值拼接在一起
输出最后的 string

using System;using System.Text;namespace yueluo_dalao_yes{ class Program { static void Main(string[] args) { var order = new OrderInfo { OrderId = 1, Buyer = "yueluo", TotalPrice = 62359.1478M }; var sb = new StringBuilder(); sb.AppendFormat("{0}: {1}{2}", nameof(order.OrderId), order.OrderId, Environment.NewLine); sb.AppendFormat("{0}: {1}{2}", nameof(order.Buyer), order.Buyer, Environment.NewLine); sb.AppendFormat("{0}: {1}{2}", nameof(order.TotalPrice), order.TotalPrice, Environment.NewLine); Console.WriteLine(sb.ToString()); } } public class OrderInfo { public int OrderId { get; set; } public string Buyer { get; set; } public decimal TotalPrice { get; set; } }}

我们使用以下命令来运行写好的逻辑：

dotnet run

就会得到以下这样的结果：

OrderId: 1Buyer: yueluoTotalPrice: 62359.1478

使用 Object Visitor 再次实现上面的逻辑

我们通过 Newbe.ObjectVisitor 来一样实现上面的逻辑：

使用 V() 扩展方法来创建一个 Object Visitor
调用 Object Visitor 的 ForEach 方法来注册 Visit 过程的行为
运行创建好的 Object Visitor

using System;using System.Text;namespace yueluo_dalao_yes{ class Program { static void Main(string[] args) { var order = new OrderInfo { OrderId = 1, Buyer = "yueluo", TotalPrice = 62359.1478M }; var sb2 = new StringBuilder(); var visitor = order.V() .ForEach((name, value) => sb2.AppendFormat("{0}: {1}{2}", name, value, Environment.NewLine)); visitor.Run(); Console.WriteLine(sb2.ToString()); } } public class OrderInfo { public int OrderId { get; set; } public string Buyer { get; set; } public decimal TotalPrice { get; set; } }}

运行这个代码，你将会得到和上一节相同的结果。

那这么做究竟带来了什么好处？

首先，使用 Object Visitor 可以动态的适应模型类的变化，这点好处非常明显。

当 OrderInfo 中的属性增加时，“拼接部分” 的代码可以不用变化，实现动态的适配。

另外，还有一些好处是本示例没有体现的，将会在后续的文档中进行介绍：

它的运行效率很高。根据已有的基准测试，其性能表征和直接硬编码差距很小。
可以使用丰富的方式来对需要访问的属性进行多种方式过滤，例如：基于 Attribute 的过滤。
有了这种方式之后可以很轻松的扩展出基于对象属性的其他功能，例如：对象的属性验证（FluentValidation），对象的映射（AutoMapper）和对象的比较（Comparer）。

那这和直接使用反射有什么区别？

使用反射来实现以上的效果也是可以的，但相较来说，Object Visitor 的实现方式在性能方面根据优势：

根据已有的基准测试，Object Visitor 基于表达式树实现，其运行效率要比直接使用反射相关的读写方法高出许多。
Object Visitor 提供了基于泛型，在一些特定的场景可以完全避免装箱拆箱所带来的开销。

你可以通过点击这里来查看使用反射和使用 object visitor 的基准测试

本篇小结

到这里，你已经初步了解了什么是 Newbe.ObjectVisitor，以及其基本的用法。

不过，这只是演示代码，展现的内容非常有限，因此，你还可以继续阅读下篇来进一步了解更多紧张刺激的特性。

发布说明

使用样例

开发文档可能随版本发生变化，查看最新的开发文档需移步 http://cn.ov.newbe.pro

番外分享

GitHub 项目地址：https://github.com/newbe36524/Newbe.ObjectVisitor

Gitee 项目地址：https://gitee.com/yks/Newbe.ObjectVisitor

------ 本文结束 ------

本文作者： newbe36524
本文链接： https://www.newbe.pro/Newbe.ObjectVisitor/001-my-fisrt-object-visitor/
版权声明： 本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

asp.net

.net

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

asp.net

.net

登录后参与评论

0 条评论

热度