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

发布时间 2023-09-27 00:24:28作者: bcbr_wang

【Github源码】


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


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

// 人员数据实体定义
public class Person
{
    public string Name { get; set; } = null;
    public int Age { get; set; } = 0;
}

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

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

除了这种基本能力之外,扩展对象中还提供了丰富的方法,用于对动态对象进行更多的判断和控制,使之能够满足各种各样的应用场景。

this属性

TrySetValue方法

TryGetValue方法

GetValue方法

GetValueByPath方法

SetValue方法

SetValueByPath方法

Has方法

HasPath方法

Remove方法

RemovePath方法

ToString方法

ToXMLString方法

1. this属性

说明:根据指定属性名称获取属性值。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
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:多层级属性路径,中间用“.”连接。

dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
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:属性值内容。

dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
person.SetValueByPath("Pet.Name", "Chika");
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:多层级属性路径,中间用“.”连接。

dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
if (person.HasPath("Pet.Name"))
{
    // TODO
}

10. Remove方法

public bool Remove(string key)
说明:从对象上删除指定的属性。
参数:

key:属性名称。

11. RemovePath方法

public bool RemovePath(string path)
说明:Remove方法的扩展,RemovePath能删除多层级属性。
参数:

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

dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
person.Pet = Xmtool.DynamicObject();
person.Pet.Name = "Tom";
person.Pet.Kind = "Cat";
person.RemovePath("Pet.Kind");
if (person.HasPath("Pet.Kind")) // 将返回false
{
	// TODO   
}

12. ToString方法

public override string ToString()
说明:将对象序列化为JSON字符串并返回;常用于API接口结果返回。
dynamic person = Xmtool.DynamicObject();
person.Name = "softwaiter";
person.Age = 18;
string json = person.ToString();
Console.WriteLine(json);	// 输出{"Name":"softwaiter","Age":18}

13. ToXMLString方法

public string ToXMLString(string defaultNS = "")
说明:将对象序列化为XML字符串并返回。
参数:

defaultNS:默认命名空间。

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


【Github源码】