开源.NetCore通用工具库Xmtool使用连载 - 扩展动态对象篇

裺鎵裡哆個寳

【Github源码】


《上一篇》 介绍了Xmtool工具库中的图形验证码类库，今天我们继续为大家介绍其中的扩展动态对象类库。

扩展动态对象是整个工具库中最重要的一个设计。在软件开发过程中，我们经常需要定义各种各样的数据对象；例如：用于参数传递的数据实体类、用于接口返回结果的Json对象等等。

1. // 人员数据实体定义
2. public class Person
3. {
4.     public string Name { get; set; } = null;
5.     public int Age { get; set; } = 0;
6. }

复制代码

当我们遇到的场景越多、越复杂，我们需要定义和维护的这种类也会更多；这无疑是一种负担，且这个过程相当枯燥和乏味。在编译型编程语言Javascript中，变量是没有强制指定类型的，用户使用时可以随意赋值；这让开发人员在使用过程中会非常灵活且方便；参考这种特性，并基于系统DynamicMetaObject对象，我们封装了DynamicObjectExt对象，我们称之为扩展动态对象，它实现了无需定义直接赋值的形式使用数据对象，像Javascript中一样简单和灵活，帮我们简化了大量的定义过程。

1. // 直接创建对象，并根据实际数据对象结构进行赋值即可
2. dynamic person = Xmtool.DynamicObject();
3. person.Name = "softwaiter";
4. person.Age = 18;
5. // TODO

复制代码

除了这种基本能力之外，扩展对象中还提供了丰富的方法，用于对动态对象进行更多的判断和控制，使之能够满足各种各样的应用场景。
this属性
TrySetValue方法
TryGetValue方法
GetValue方法
GetValueByPath方法
SetValue方法
SetValueByPath方法
Has方法
HasPath方法
Remove方法
RemovePath方法
ToString方法
ToXMLString方法
1. this属性

说明：根据指定属性名称获取属性值。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. Console.WriteLine(pernson["Name"]);        // 打印Name属性值，输出softwaiter

复制代码

2. TrySetValue方法

public bool TrySetValue(string name, object value)

说明：尝试为指定name的属性赋值，赋值成功返回true；否则返回false。

参数：

name：准备赋值的属性名称。
value：属性赋值内容。
3. TryGetValue方法

public bool TryGetValue(string name, out object result)

说明：尝试从指定name的属性获取值，获取成功返回true；否则返回false。

参数：

name：准备取值的属性名称。
result：获取到的属性值；为获取到将返回null。
4. GetValue方法

public object GetValue(string name)

说明：返回指定name的属性值；不存在找到则返回null。

参数：

name：属性名称。
5. GetValueByPath方法

public object GetValueByPath(string path)

说明：GetValue方法的扩展，GetValueByPath能获取多层级属性的值。

参数：

path：多层级属性路径，中间用“.”连接。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. person.Pet = Xmtool.DynamicObject();
5. person.Pet.Name = "Tom";
6. person.Pet.Kind = "Cat";
7. Console.WriteLine(pernson.GetValueByPath("Pet.Name"));        // 打印宠物名称，输出Tom

复制代码

6. SetValue方法

public object SetValue(string name, object value)

说明：为指定name的属性设置值。

参数：

name：准备设置值得属性名称。
value：属性值内容。
7. SetValueByPath方法

public bool SetValueByPath(string path, object value)

说明：SetValue方法的扩展，SetValueByPath能设置多层级属性的值。

参数：

path：多层级属性路径，中间用“.”连接。
value：属性值内容。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. person.Pet = Xmtool.DynamicObject();
5. person.Pet.Name = "Tom";
6. person.Pet.Kind = "Cat";
7. person.SetValueByPath("Pet.Name", "Chika");
8. Console.WriteLine(pernson.GetValueByPath("Pet.Name"));        // 打印宠物名称，输出Chika

复制代码

8. Has方法

public bool Has(string key)

说明：判断是否包含指定属性。

参数：

key：属性名称。
9. HasPath方法

public bool HasPath(string path)

说明：Has方法的扩展，HasPath能判断多层级属性是否存在。

参数：

path：多层级属性路径，中间用“.”连接。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. person.Pet = Xmtool.DynamicObject();
5. person.Pet.Name = "Tom";
6. person.Pet.Kind = "Cat";
7. if (person.HasPath("Pet.Name"))
8. {
9.     // TODO
10. }

复制代码

10. Remove方法

public bool Remove(string key)

说明：从对象上删除指定的属性。

参数：

key：属性名称。
11. RemovePath方法

public bool RemovePath(string path)

说明：Remove方法的扩展，RemovePath能删除多层级属性。

参数：

path：多层级属性路径，中间用“.”连接。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. person.Pet = Xmtool.DynamicObject();
5. person.Pet.Name = "Tom";
6. person.Pet.Kind = "Cat";
7. person.RemovePath("Pet.Kind");
8. if (person.HasPath("Pet.Kind")) // 将返回false
9. {
10.         // TODO   
11. }

复制代码

12. ToString方法

public override string ToString()

说明：将对象序列化为JSON字符串并返回；常用于API接口结果返回。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. string json = person.ToString();
5. Console.WriteLine(json);        // 输出{"Name":"softwaiter","Age":18}

复制代码

13. ToXMLString方法

public string ToXMLString(string defaultNS = "")

说明：将对象序列化为XML字符串并返回。

参数：

defaultNS：默认命名空间。

1. dynamic person = Xmtool.DynamicObject();
2. person.Name = "softwaiter";
3. person.Age = 18;
4. string xml = person.ToXMLString();
5. Console.WriteLine(xml);        //输出<xml><Name>softwaiter</Name><Age>18</Age></xml>
6. string xml2 = person.ToXMLString("http://www.xmltool.com");
7. Console.WriteLine(xml2); //输出<xml xmlns="http://www.xmltool.com"><Name>softwaiter</Name><Age>18</Age></xml>

复制代码

【Github源码】


来源:https://www.cnblogs.com/bcbr/archive/2023/09/27/17731652.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！