前言
在Web系统开发时,往往会有存在大量的交互操作,交互就必须校验数据的准确性啊,且不说一个字段可能存在多种校验,若一个表单提交有10个字段难道我们要对这10个字段分别写代码去校验吗?如果是这样,那每一个表单都要单独去写一份校验岂不是太痛苦了?
为了解决这个问题,聪明的程序员们开始了“偷懒”!
今天我们介绍一位在.NET平台下偷懒的——“FluentValidation”,正如其名,流利的验证,他将我们的验证开发工作变得流利甚至优美了起来。
接下来我们就来看看如何使用它吧。
首先我们使用nuget安装 FluentValidation
Nuget安装命令:Install-Package FluentValidation -Version 7.6.104
由于FluentValidation的验证是基于模型的,所以,我们先来建立一个Person
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
public class Person
{
/// <summary>
/// 姓名
/// </summary>
public string Name { get ; set ; }
/// <summary>
/// 年龄
/// </summary>
public int Age { get ; set ; }
/// <summary>
/// 性别
/// </summary>
public bool Sex { get ; set ; }
}
|
有了模型,要想验证模型,肯定得有验证器才行,于是我们在创建一个Person的验证器
1
2
3
4
5
6
7
8
9
10
11
12
|
public class PersonValidator : AbstractValidator<Person>
{
public PersonValidator()
{
this .RuleFor(p => p.Name)
.NotEmpty()
.WithMessage( "名字不能为空" );
this .RuleFor(p => p.Age)
.NotEmpty()
.WithMessage( "年龄不能为空!!" );
}
}
|
验证器必须继承自AbstractValidator<T>
,泛型T表示该验证器验证的实体,在构造函数里通过this.RuleFor
为指定的属性设置验证,在上述配置中为Person的Name和Age属性都设置了非空,并且给出了相应的错误消息。
现在实体有了,验证器也有了,就差东风了。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
class Program
{
static void Main( string [] args)
{
Server( new Person { });
Console.ReadKey( true );
}
private static void Server(Person model)
{
var validator = new PersonValidator();
ValidationResult result = validator.Validate(model);
if (!result.IsValid)
{
foreach (var failure in result.Errors)
{
//失败的属性名称,如错误信息
Console.WriteLine( "Property " + failure.PropertyName + " failed validation. Error was: " + failure.ErrorMessage);
}
}
Console.WriteLine( "验证完成!!" );
}
}
|
在Server方法中需要一个参数Person,Person是个对象,里面有3个属性Name、Age、Sex,在Server内部我们创建了一个Person验证器对象,用它来验证我们的参数model, 验证后会返回一个验证结果。这个结果有2个重要的参数,第一是IsValid,验证通过的时候返回True,第二个是Errors,他里面存放的是所有验证失败的信息,在验证失败的时候通过遍历Errors即可获取到所有错误信息,如上所示通过错误信息的PropertyName就能知道是哪个对象出错了,而ErrorMessage自然就对应这个Property所出错内容的WithMessage了。下面是运行结果
至此,我们能够使用基本验证了。
但在我们实际应用中不一定会像上述案例一样一帆风顺,也许我们的Person里会有一个Address属性,他的类型不是一个String,而是一个对象Address,如下所示
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
public class Person
{
/// <summary>
/// 姓名
/// </summary>
public string Name { get ; set ; }
/// <summary>
/// 年龄
/// </summary>
public int Age { get ; set ; }
/// <summary>
/// 性别
/// </summary>
public bool Sex { get ; set ; }
/// <summary>
/// 地址
/// </summary>
public Address Address { get ; set ; }
}
|
1
2
3
4
5
6
7
8
9
10
11
12
|
public class Address
{
/// <summary>
/// 家庭地址
/// </summary>
public string Home { get ; set ; }
/// <summary>
/// 家庭电话
/// </summary>
public string Phone { get ; set ; }
}
|
假如Address也有一个验证器
1
2
3
4
5
6
7
8
9
10
11
12
13
|
public class AddressValidator : AbstractValidator<Address>
{
public AddressValidator()
{
this .RuleFor(m => m.Home)
.NotEmpty()
.WithMessage( "家庭住址不能为空" );
this .RuleFor(m => m.Phone)
.Length(11, 12)
.WithMessage( "电话必须是11-12位之间" );
}
}
|
现在需求变了,在Person实体的要求里不仅要求Name、Age不能为空,并且还要求Address下的Home和Phone满足AddressValidator的要求,这可怎么办呢?
当然你可以像这样做
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
public class PersonValidator : AbstractValidator<Person>
{
public PersonValidator()
{
this .RuleFor(p => p.Name)
.NotEmpty()
.WithMessage( "名字不能为空" );
this .RuleFor(p => p.Age)
.NotEmpty()
.WithMessage( "年龄不能为空!!" );
this .RuleFor(p => p.Address.Home)
.MinimumLength(5)
.WithMessage( "家庭住址最短长度为5" );
}
}
|
通过Person.Address去给每一个属性配置校验,这并不是不能完成,但如果Address属性比较比较多,在配置起来的时候重复工作量大大提高,并且人家AddressValidator已经完成配置了,你再来配置一遍,可以算是在浪费生命吗?
幸好,FluentValidation提供了一种为属性设置验证器的机制。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
public class PersonValidator : AbstractValidator<Person>
{
public PersonValidator()
{
this .RuleFor(p => p.Name)
.NotEmpty()
.WithMessage( "名字不能为空" );
this .RuleFor(p => p.Age)
.NotEmpty()
.WithMessage( "年龄不能为空!!" );
this .RuleFor(p => p.Address)
.NotNull()
.WithMessage( "地址不能为空" )
.SetValidator( new AddressValidator());
}
}
|
通过这样我们就将Address下的Home和Phome的验证追加到Person的Address属性上去了。
初步认识和使用就先到这儿了。感谢各位看官。后续会持续更新,直到搭建完系统架构。
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对服务器之家的支持。
原文链接:https://www.cnblogs.com/Gxqsd/p/9326918.html