.NET验证组件Fluent Validation使用指南
认识FluentVaidation.
看到NopCommerce项目中用到这个组建是如此的简单,将数据验证从业务实体类中分离出来,真是一个天才的想法,后来才知道这个东西是一个开源的轻量级验证组建。
FluentValidation翻译为:流畅验证
开源Codeplex其主页简介:该组件是一个轻量级的.NET类库,使用流畅的接口定义和lambda表达式为构建一个业务类的验证规则(Asmallvalidationlibraryfor.NETthatusesafluentinterfaceandlambdaexpressionforbuildingvalidationrulesforyoubusinessobjects.)
这个类库不仅仅可以使用的asp.netmvc项目中,普通的类库中也可以使用,当然在asp.netform项目中也支持。
怎么使用:
是不是好用,还要看使用时是否真的像其官网建议描述一样。我比较喜欢其官网上的例子,一眼就能看出用法上的感觉,绝对是如其名,流畅,这个也一种解释型语言常见的的一种用法,无限的对一个类型支持无限度个属性扩展。
业务实体类:
publicclassPerson { publicstringNameField; publicintId{get;set;} publicstringSurname{get;set;} publicstringForename{get;set;} publicList<Person>Children{get;set;} publicstring[]NickNames{get;set;} publicDateTimeDateOfBirth{get;set;} publicint?NullableInt{get;set;} publicPerson() { Children=newList<Person>(); Orders=newList<Order>(); } publicintCalculateSalary() { return20; } publicAddressAddress{get;set;} publicIList<Order>Orders{get;set;} publicstringEmail{get;set;} publicdecimalDiscount{get;set;} publicdoubleAge{get;set;} publicintAnotherInt{get;set;} publicstringCreditCard{get;set;} publicint?OtherNullableInt{get;set;} } publicinterfaceIAddress { stringLine1{get;set;} stringLine2{get;set;} stringTown{get;set;} stringCounty{get;set;} stringPostcode{get;set;} CountryCountry{get;set;} } publicclassAddress:IAddress { publicstringLine1{get;set;} publicstringLine2{get;set;} publicstringTown{get;set;} publicstringCounty{get;set;} publicstringPostcode{get;set;} publicCountryCountry{get;set;} publicintId{get;set;} } publicclassCountry { publicstringName{get;set;} } publicinterfaceIOrder { decimalAmount{get;} } publicclassOrder:IOrder { publicstringProductName{get;set;} publicdecimalAmount{get;set;} }
对Person的指定验证规则:
usingFluentValidation; publicclassCustomerValidator:AbstractValidator<Customer> { publicCustomerValidator() { RuleFor(customer=>customer.Surname).NotEmpty(); RuleFor(customer=>customer.Forename).NotEmpty().WithMessage("Pleasespecifyafirstname"); RuleFor(customer=>customer.Discount).NotEqual(0).When(customer=>customer.HasDiscount); RuleFor(customer=>customer.Address).Length(20,250); RuleFor(customer=>customer.Postcode).Must(BeAValidPostcode).WithMessage("Pleasespecifyavalidpostcode"); } privateboolBeAValidPostcode(stringpostcode) { //custompostcodevalidatinglogicgoeshere } } //手动验证规则 Customercustomer=newCustomer(); CustomerValidatorvalidator=newCustomerValidator(); ValidationResultresults=validator.Validate(customer); boolvalidationSucceeded=results.IsValid; IList<ValidationFailure>failures=results.Errors;
Flentvalidation怎么与asp.netmvc验证库整合?
如果在asp.netmvc中现实中这么用,可能会有很多人不会知道他,我们知道Asp.netMVC项目中有自己的验证机构[企业库VAB(ValidationApplicationBlock),基于Attribute声明式验证],其使用方法,也被我们都一直很认可,但其也有很多不够灵活的,但FluentValidation确实更灵活一点。使用起来多变性,流畅,而且验证规则是一个单独的类,是和业务实体对象分类的,我们不需要翔VAB一样,需要在业务实体类上使用Attribute注册验证规则。
既然其不是ASP.NETMVC的默认验证规则类库,我们就需要注册到ASP.NETMVC的验证规则库中。
//在Global.asax.cs中的Applicaton_Start()函数中注册为asp.netmvc默认的验证规则库。 //fluentvalidation FluentValidationModelValidatorProviderprovider=newFluentValidationModelValidatorProvider(newAttributedValidatorFactory()); ModelValidatorProviders.Providers.Add(provider); DataAnnotationsModelValidatorProvider.AddImplicitRequiredAttributeForValueTypes=false;
注意:
1,)作为FluentValidation验证规则类须继承AbstractValidator<T>;
2,)我们也可以仿照NopCommerce的处理方法,对AttributeValidatorFactory类的Validator(Typetype)函数重写,在特殊的业务环境下支持其他验证规则。
本文适合对.net以及MVC有所了解的读者,这里抛砖引玉,献丑了