.NET中特性+反射 实现数据校验
在.NET中,我们可以使用特性+反射来实现数据校验。特性是一种用于为程序中的代码添加元数据的机制。元数据是与程序中的代码相关联的数据,但不直接成为代码的一部分。通过特性,我们可以为类、方法、属性等添加额外的信息,这些信息可以在运行时通过反射获取和使用。
对反射不太熟悉的小伙伴可以去看我以前的文章 .NET中的反射
为了实现数据校验,我们可以定义一个自定义特性,并将其应用于需要校验的属性或参数上。然后,我们可以编写代码来检查这些特性,并根据特性的配置执行相应的校验逻辑。
示例代码
定义自定义特性
using System;
using System.ComponentModel.DataAnnotations;
[AttributeUsage(AttributeTargets.Property, Inherited = true, AllowMultiple = false)]
public class ValidationAttribute : Attribute
{
public string ErrorMessage { get; set; }
public ValidationAttribute(string errorMessage)
{
ErrorMessage = errorMessage;
}
}
定义具体的校验特性
[AttributeUsage(AttributeTargets.Property, Inherited = true, AllowMultiple = false)]
public class RequiredAttribute : ValidationAttribute
{
public RequiredAttribute() : base("该字段是必填项。") { }
}
[AttributeUsage(AttributeTargets.Property, Inherited = true, AllowMultiple = false)]
public class RangeAttribute : ValidationAttribute
{
public int Minimum { get; set; }
public int Maximum { get; set; }
public RangeAttribute(int minimum, int maximum, string errorMessage = "该字段的值必须在 {0} 和 {1} 之间。")
: base(errorMessage)
{
Minimum = minimum;
Maximum = maximum;
}
}
在模型类中使用这些特性
public class Person
{
[Required]
public string Name { get; set; }
[Range(18, 100, ErrorMessage = "年龄必须在 18 到 100 之间。")]
public int Age { get; set; }
}
编写验证方法
public class Validator
{
public static bool Validate<T>(T obj, out string errorMessage)
{
errorMessage = null;
var type = typeof(T);
var properties = type.GetProperties();
foreach (var property in properties)
{
var validationAttributes = property.GetCustomAttributes(typeof(ValidationAttribute), true);
foreach (var attribute in validationAttributes)
{
var value = property.GetValue(obj);
switch (attribute)
{
case RequiredAttribute required:
if (value == null || (value is string str && string.IsNullOrWhiteSpace(str)))
{
errorMessage = required.ErrorMessage;
return false;
}
break;
case RangeAttribute range:
if (value is IComparable comparable)
{
if (comparable.CompareTo(range.Minimum) < 0 || comparable.CompareTo(range.Maximum) > 0)
{
errorMessage = string.Format(range.ErrorMessage, range.Minimum, range.Maximum);
return false;
}
}
break;
// 可以添加更多校验特性类型
}
}
}
return true;
}
}
使用Validator类来校验Person对象
class Program
{
static void Main(string[] args)
{
var person = new Person { Name = "张三", Age = 15 };
string errorMessage;
bool isValid = Validator.Validate(person, out errorMessage);
if (!isValid)
{
Console.WriteLine(errorMessage); // 输出:该字段是必填项。
}
Console.ReadLine();
}
}
说明
这个示例演示了如何使用特性和反射实现基本的数据校验。在实际应用中,你可能需要处理更复杂的校验逻辑和更多的校验类型。
此外,还可以使用现有的数据特性(如System.ComponentModel.DataAnnotations命名空间中的特性)来简化校验过程。
以下是该命名空间中一些常用的特性(Attribute),以及它们的用途:
特性名称 | 用途 |
---|---|
[Required] |
确保属性值不为空(不为 null 且对于字符串不是空字符串)。 |
[StringLength] |
限制字符串属性的最大长度。 |
[Range] |
确保数值型属性在指定的范围内。 |
[Minimum] |
确保数值型属性不小于指定的最小值。 |
[Maximum] |
确保数值型属性不大于指定的最大值。 |
[RegularExpression] |
通过正则表达式验证属性值的格式。 |
[EmailAddress] |
验证属性值是否为有效的电子邮件地址。 |
[Url] |
验证属性值是否为有效的 URL。 |
[Phone] |
验证属性值是否为有效的电话号码。 |
[CreditCard] |
验证属性值是否为有效的信用卡号。 |
[Compare] |
比较两个属性值是否相等,常用于密码和确认密码的字段。 |
[DataType] |
指定数据的类型,例如日期、时间、电话号码等,并不验证数据,而是提供给数据绑定机制。 |
[CustomValidation] |
允许指定自定义验证逻辑。 |
[EnumDataType] |
验证属性值是否为指定枚举类型中的有效成员。 |
[StringLength] |
验证字符串长度是否在指定的范围内。 |
这些特性通常与ASP.NET Core或是ASP.NET MVC、Entity Framework等框架结合使用。
使用这些特性可以大大简化数据验证的代码,并且使验证逻辑与业务逻辑分离,提高代码的可维护性和可读性。