在.NET Core 中使用 FluentValidation 進行規則驗證的方法
不用說,規則驗證很重要,無效的引數,可能會導致程式的異常。
如果使用Web API或MVC頁面,那麼可能習慣了自帶的規則驗證,我們的控制器很乾淨:
public class User { [Required] public string FirstName { get; set; } [Required] public string LastName { get; set; } }
這種很常見,但是今天我想給你一個更好的替代方案:FluentValidation, 通過這個庫,您可以流暢地定義用於物件驗證的複雜規則,從而輕鬆構建和理解驗證規則,您可以在 Github 上找到這個專案。
安裝 FluentValidation
我新建了一個很簡單的.NET Core 的Web API 程式,只有一個介面是使用者註冊,入參是一個User類,然後在Nuget中安裝 FluentValidation
。
建立第一個驗證
對於要驗證的每個類,必須建立其自己的驗證器,每個驗證器類都必須繼承AbstractValidator<T>
,其中T是要驗證的類,並且所有驗證規則都在建構函式中定義。
最簡單的驗證是針對空值,如果要指定FirstName和LastName都不能為空,這個驗證器是這樣:
public class UserValidator : AbstractValidator<User> { public UserValidator() { RuleFor(x => x.FirstName).NotEmpty(); RuleFor(x => x.LastName).NotEmpty(); } }
就這些了,您已經建立了第一個驗證器,是不是超級簡單!
還有一些其他的規則,比如 MinimumLength,MaximumLength和Length,用於驗證長度,您可以把多個規則指定到一個欄位,就像這樣:
public class UserValidator : AbstractValidator<User> { public UserValidator() { RuleFor(x => x.FirstName).NotEmpty(); RuleFor(x => x.FirstName).MinimumLength(3); RuleFor(x => x.FirstName).MaximumLength(20); RuleFor(x => x.LastName).NotEmpty(); } }
驗證入參
我們之前已經定義了驗證規則,現在開始使用它,您只需要new 一個UserValidator物件,然後呼叫Validate方法,它會返回一個物件,其中包含了驗證狀態和所有沒有通過驗證的資訊。
[HttpPost] public IActionResult Register(User newUser) { var validator = new UserValidator(); var validationResult = validator.Validate(newUser); if (!validationResult.IsValid) { return BadRequest(validationResult.Errors.First().ErrorMessage); } return Ok(); }
如果我執行程式,然後輸入一個超長的名字:
{ "FirstName": "趙錢孫李周吳鄭王馮陳褚衛蔣沈韓楊朱秦尤許何呂施張","LastName": "張" }
我會收到驗證錯誤:"The length of 'First Name' must be 20 characters or fewer. You entered 24 characters"。
好吧,我不喜歡這個訊息,那麼你可以自定義錯誤訊息,這很簡單,您可以使用 WithMessage 方法。
- RuleFor(x => x.FirstName).MaximumLength(20); + RuleFor(x => x.FirstName).MaximumLength(20).WithMessage("您的名字長度已經超出了限制!");
流利驗證
你可以把驗證規則,改成下邊這樣:
- RuleFor(x => x.FirstName).NotEmpty(); - RuleFor(x => x.FirstName).MinimumLength(3); + RuleFor(x => x.FirstName).NotEmpty().MinimumLength(3);
然後也可以把驗證規則應用於其他的屬性,就像這樣:
public UserValidator() { RuleFor(x => x.FirstName) .MaximumLength(20).WithMessage("您的名字長度已經超出了限制!") .NotEmpty().MinimumLength(3); RuleFor(x => x.LastName).NotEmpty(); }
常見的驗證規則
這個庫有很多現成的基本型別驗證規則,對於字串,您可以使用不同的方法,比如 EmailAddress,IsEnumName(檢查值是否在指定的Enum型別中定義)和 InclusiveBetween,檢查該值是否在定義的範圍內。
現在,我在User類添加了另外兩個欄位,Password 和 ConfirmPassword。
Password欄位是一個字串,有效的長度必須在5到15個字元之間,並且要符合正則,為了定義是否滿足安全規則,我定義了一個HasValidPassword方法,它會返回一個bool值。
private bool HasValidPassword(string pw) { var lowercase = new Regex("[a-z]+"); var uppercase = new Regex("[A-Z]+"); var digit = new Regex("(\\d)+"); var symbol = new Regex("(\\W)+"); return (lowercase.IsMatch(pw) && uppercase.IsMatch(pw) && digit.IsMatch(pw) && symbol.IsMatch(pw)); }
然後在密碼驗證中使用:
RuleFor(x => x.FirstName) .MaximumLength(20).WithMessage("您的名字長度已經超出了限制!") .NotEmpty().MinimumLength(3); RuleFor(x => x.LastName).NotEmpty(); RuleFor(x => x.Password) .Length(5,15) .Must(x => HasValidPassword(x));
還可以簡化一些:
RuleFor(x => x.Password) .Length(5,15) - .Must(x => HasValidPassword(x)); + .Must(HasValidPassword); }
ConfirmPassword欄位的唯一要求是等於Password欄位:
RuleFor(x => x.ConfirmPassword) .Equal(x => x.Password) .WithMessage("2次密碼不一致!");
注入驗證器
修改Startup類中的ConfigureServices方法:
public void ConfigureServices(IServiceCollection services) { services.AddControllers().AddFluentValidation(); services.AddTransient<IValidator<User>,UserValidator>(); }
注意:這個地方的生命週期是 Transient。
這樣,在呼叫註冊介面的時候,會自動進行規則驗證:
[HttpPost] public IActionResult Register(User newUser) { return Ok(); }
然後,我們再嘗試傳入引數來呼叫介面:
{ "FirstName": "趙錢孫李周吳鄭王馮陳褚衛蔣沈韓楊朱秦尤許何呂施張","LastName": "張" }
很明顯,驗證不通過,介面會返回這樣的錯誤資訊:
{ "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1","title": "One or more validation errors occurred.","status": 400,"traceId": "|c4523c02-4899b7f3df86a629.","errors": { "FirstName": [ "您的名字長度已經超出了限制!" ] } }
希望對您有幫助,您可以在官方文件中找到更多的用法。
原文連結: https://www.code4it.dev/blog/fluentvalidation
到此這篇關於在.NET Core 中使用 FluentValidation 進行規則驗證的文章就介紹到這了,更多相關.NET Core 規則驗證內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!