ایجاد ویژگی‌های اعتبارسنجی سفارشی در ASP.NET Core 3.1 به همراه اعتبارسنجی سمت کلاینت آن‌ها
اندازه‌ی قلم متن
تخمین مدت زمان مطالعه‌ی مطلب: پنج دقیقه

اگر بخواهیم یک Attribute سفارشی را برای اعتبارسنجی ایجاد کنیم، معمولا یک کلاس را ایجاد کرده و از ValidationAttribute ارث بری می‌کنیم و سپس متد IsValid آن‌را override میکنیم؛ با توجه به نیازی که به آن Attribute داریم. به عنوان مثال در ادامه یک Attribute را ایجاد کرده‌ایم که عمل مقایسه‌ی دو خاصیت را انجام میدهد و اگر مقدار خاصیتی که ویژگی LowerThan بر روی آن قرار دارد، از مقدار خاصیت دیگری که باید با آن مقایسه شود، کمتر نباشد، یک خطا را به ModelState اضافه میکنیم:
public class LowerThanAttribute : ValidationAttribute
{
    public LowerThanAttribute(string dependentPropertyName)
    {
        DependentPropertyName = dependentPropertyName;
    }

    public string DependentPropertyName { get; set; }
    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        int? currentPropertyValue = value as int?;
        currentPropertyValue ??= 0;
        var typeInfo = validationContext.ObjectInstance.GetType();
        var dependentPropertyValue = Convert.ToInt32(typeInfo.GetProperty(DependentPropertyName)
                                        .GetValue(validationContext.ObjectInstance, null));

        var displayDependentProperyName = typeInfo.GetProperty(DependentPropertyName)
                                        .GetCustomAttributes(typeof(DisplayAttribute), false)
                                        .Cast<DisplayAttribute>()
                                        .FirstOrDefault()?.Name;

        if (!(currentPropertyValue.Value < dependentPropertyValue))
        {
            return new ValidationResult("مقدار {0} باید کمتر باشد از " + displayDependentProperyName);
        }
        return ValidationResult.Success;
    }
}
ابتدا مقدار خاصیت مورد نظر را که میخواهیم با آن مقایسه شود، با استفاده از رفلکشن گرفته‌ایم و آن را در متغییر dependentPropertyValue ذخیره میکنیم. در ادامه مقدار Name را با استفاده از رفلکشن از DisplayAttribute میخوانیم و سپس عمل مقایسه را انجام میدهیم که اگر مقدار خاصیتی که ویژگی LowerThan بر روی آن قرار دارد، از مقدار خاصیت مورد نظر که مقدار آن را با استفاده از رفلکشن خوانده‌ایم، کمتر نباشد، یک خطا را به ModelState اضافه میکنیم.

اما یک مشکل! این عمل فقط در سمت سرور بررسی میشود و هنگامیکه ModelState.IsValid را در اکشن متد فراخوانی میکنیم، عمل اعتبارسنجی انجام میشود. یعنی همه‌ی داده‌ها به سمت سرور ارسال میشوند و اگر خطایی در ModelState وجود داشته باشد، کاربر مجددا باید داده‌ها را ارسال کند.

اما میتوان با استفاده از اینترفیس IClientModelValidator، عمل اعتبارسنجی را برای این ویژگی در سمت کلاینت انجام داد. برای انجام این کار ابتدا باید از اینترفیس IClientModelValidator ارث بری کنیم و متد AddValidation آن را پیاده سازی کنیم.
public class LowerThanAttribute : ValidationAttribute, IClientModelValidator
{
    public LowerThanAttribute(string dependentPropertyName)
    {
        DependentPropertyName = dependentPropertyName;
    }

    public string DependentPropertyName { get; set; }

    public void AddValidation(ClientModelValidationContext context)
    {
        var displayCurrentProperyName = context.ModelMetadata.ContainerMetadata
                                            .ModelType.GetProperty(context.ModelMetadata.PropertyName)
                                            .GetCustomAttributes(typeof(DisplayAttribute), false)
                                            .Cast<DisplayAttribute>()
                                            .FirstOrDefault()?.Name;

        var displayDependentProperyName = context.ModelMetadata.ContainerMetadata
                                            .ModelType.GetProperty(DependentPropertyName)
                                            .GetCustomAttributes(typeof(DisplayAttribute), false)
                                            .Cast<DisplayAttribute>()
                                            .FirstOrDefault()?.Name;


        MergeAttribute(context.Attributes, "data-val", "true");
        MergeAttribute(context.Attributes, "data-val-lowerthan", $"{displayCurrentProperyName} باید کمتر باشد از {displayDependentProperyName}");
        MergeAttribute(context.Attributes, "data-val-dependentpropertyname", "#" + DependentPropertyName);
    }
    private  bool MergeAttribute(IDictionary<string, string> attributes, string key, string value)
    {
        if (attributes.ContainsKey(key))
        {
            return false;
        }
        attributes.Add(key, value);
        return true;
    }

    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        int? currentPropertyValue = value as int?;
        currentPropertyValue ??= 0;
        var typeInfo = validationContext.ObjectInstance.GetType();
        var dependentPropertyValue = Convert.ToInt32(typeInfo.GetProperty(DependentPropertyName)
                                        .GetValue(validationContext.ObjectInstance, null));

        var displayCurrentProperyName = typeInfo.GetProperty(DependentPropertyName)
                                        .GetCustomAttributes(typeof(DisplayAttribute), false)
                                        .Cast<DisplayAttribute>()
                                        .FirstOrDefault()?.Name;

        if (!(currentPropertyValue.Value < dependentPropertyValue))
        {
            return new ValidationResult("مقدار {0} باید کمتر باشد از " + displayCurrentProperyName);
        }
        return ValidationResult.Success;
    }
}
اینترفیس IClientModelValidator، یک متد به نام AddValidation دارد که این امکان را فراهم میکند تا بتوانیم اعتبارسنجی را در سمت کلاینت انجام دهیم. در ادامه باید با استفاده از JQuery اعتبارسنجی مخصوص این ویژگی را در سمت کلاینت پیاده سازی کنیم. در متد AddValidation فقط اسم تابع و پارامتر‌های مورد نیاز در سمت کلاینت را مشخص میکنیم. به عنوان مثال در مثال بالا یک تابع را معرفی کرده‌ایم به نام lowerthan که بعدا باید آنرا در سمت کلاینت پیاده سازی کنیم و نام خاصیتی را که باید با آن مقایسه شود، با نام data-val-dependentpropertyname معرفی کرده‌ایم. در کد زیر، این اعتبار سنجی سمت کلاینت را پیاده سازی کرده ایم. lowerthan نام متدی است که آنرا در متد AddValidation اضافه کردیم. مقدار value همان مقدار خاصیتی است که ویژگی LowerThan بر روی آن قرار دارد و otherPropId نام خاصیتی است که باید با آن مقایسه شود که آنرا از element خوانده‌ایم:
jQuery.validator.addMethod("lowerthan", function (value, element, param) {
    var otherPropId = $(element).data('val-dependentpropertyname');
    if (otherPropId) {
        var otherProp = $(otherPropId);
        if (otherProp) {
            var otherVal = otherProp.val();
            if (parseInt(otherVal) > parseInt(value)) {
                return true;
            }
            return false;
        }
    }
    return true;
});
jQuery.validator.unobtrusive.adapters.addBool("lowerthan");
کدهای جاواسکریپتی بالا را در یک فایل جدید به نام LowerThan.js ذخیره کرده‌ایم که باید آن را به صفحه خود اضافه کنیم:
<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>
<script src="~/js/LowerThan.js"></script>
سپس برای استفاده، باید ویژگی LowerThan را بر روی خاصیت مورد نظر قرار دهیم؛ مانند زیر:
public class User
{
    [Required]
    [Display(Name ="نام کاربری")]
    public string Username { get; set; }
    [Required]
    [Display(Name = "سن")]
    public int Age { get; set; }
    [LowerThan(nameof(Age))]
    [Required]
    [Display(Name = "سابقه کار")]
    public int Experience { get; set; }
}
و در نهایت اگر مقدار خاصیت Experience که ویژگی LowerThan بر روی آن قرار دارد، از مقدار خاصیت Age که باید با آن مقایسه شود، کمتر باشد، true برگردانده میشود؛ اما اگر بزرگتر یا مساوی باشد، متن خطایی را که در متد AddValidation اضافه کردیم، نشان داده خواهد شد.
 

  • #
    ‫۴ سال و ۳ ماه قبل، شنبه ۲۷ اردیبهشت ۱۳۹۹، ساعت ۰۱:۰۷
    ممنون بابت مطلب ارزشمندتون
    به عنوان یک نکته تکمیلی:
    کتابخانه  FoolProof.Core (مخزن آن) Attribute‌های زیادی برای بحث اعتبار سنجی دارد که همگی علاوه بر Server-side از Client-side Validation هم پشتیبانی میکنن. نسخه قدیمی آن (foolproof) برای ASP.NET MVC سابق است (قبلا مقاله آموزش آن در سایت ثبت شده)  ولی این نسخه از ASP.NET Core پیشتیبانی میکنه
    لیست Attribute های پشتیبانی شده:
    • Is
    • EqualTo
    • NotEqualTo
    • GreaterThan
    • LessThan
    • GreaterThanOrEqualTo
    • LessThanOrEqualTo
    • Improved required validators:
    • RequiredIf
    • RequiredIfNot
    • RequiredIfTrue
    • RequiredIfFalse
    • RequiredIfEmpty
    • RequiredIfNotEmpty
    • RequiredIfRegExMatch
    • RequiredIfNotRegExMatch
    • In
    • NotIn 
    • #
      ‫۴ سال و ۳ ماه قبل، یکشنبه ۲۸ اردیبهشت ۱۳۹۹، ساعت ۰۳:۰۹
      اینم در نظرداشته باشید(FluentValidation  ) . البته من از سمت کلاینتش استفاده نکردم و فکر نکنم داشته باشه. اما شرایط خوبی پوشش میده.
      using FluentValidation;
      
      public class CustomerValidator: AbstractValidator<Customer> {
        public CustomerValidator() {
          RuleFor(x => x.Surname).NotEmpty();
          RuleFor(x => x.Forename).NotEmpty().WithMessage("Please specify a first name");
          RuleFor(x => x.Discount).NotEqual(0).When(x => x.HasDiscount);
          RuleFor(x => x.Address).Length(20, 250);
          RuleFor(x => x.Postcode).Must(BeAValidPostcode).WithMessage("Please specify a valid postcode");
        }
      
        private bool BeAValidPostcode(string postcode) {
          // custom postcode validating logic goes here
        }
      }
      
      var customer = new Customer();
      var validator = new CustomerValidator();
      ValidationResult results = validator.Validate(customer);
      
      bool success = results.IsValid;
      IList<ValidationFailure> failures = results.Errors;

      • #
        ‫۴ سال و ۳ ماه قبل، یکشنبه ۲۸ اردیبهشت ۱۳۹۹، ساعت ۰۹:۰۲
        کتابخانه FluentValidation ،  این قابلیت رو داره در سمت کلاینت اعتبار سنجی انجام بده و شما میتونید از تمامی شروطی که برای مدل خود در نظر گرفتید به همراه بخش کلاینتش رو باهم استفاده کنید. به عنوان مثال میخواهید کد ملی رو اعتبار سنجی کنید؛ مانند خالی نبودن فیلد. ابتدا از کلاس ClientValidationBase ارث بری می‌کنید
        public class NationalCodeClientValidator : ClientValidatorBase
            {
                #region Fields
        
                private NationalCodeValidator NationalCodeValidator => (NationalCodeValidator)Validator;
        
                #endregion Fields
        
                #region Methods
        
                #region Constructors
        
                public NationalCodeClientValidator(PropertyRule rule, IPropertyValidator validator) : base(rule, validator)
                {
                }
        
                #endregion Constructors
        
                #region Override
        
                public override void AddValidation(ClientModelValidationContext context)
                {
                    MergeAttribute(context.Attributes, "data-val", "true");
                    MergeAttribute(context.Attributes, "data-val-nationalcode", GetErrorMessage());
                }
        
                #endregion Override
        
                #region Utility
        
                private string GetErrorMessage()
                {
                    var formatter = ValidatorOptions.MessageFormatterFactory().AppendPropertyName(Rule.GetDisplayName());
                    string messageTemplate;
                    try
                    {
                        messageTemplate = Validator.Options.ErrorMessageSource.GetString(null);
                    }
                    catch (FluentValidationMessageFormatException)
                    {
                        messageTemplate = ValidatorOptions.LanguageManager.GetStringForValidator<NotEmptyValidator>();
                    }
                    var message = formatter.BuildMessage(messageTemplate);
                    return message;
                }
        
                #endregion Utility
        
                #endregion Methods
            }

        سپس کلاسی دیگر تعریف کرده و از PropertyValidator ارث بری می‌کنید:
        public class NationalCodeValidator : PropertyValidator
            {
                #region Methods
        
                #region Constructors
        
                public NationalCodeValidator() : base(new LanguageStringSource(nameof(NationalCodeValidator)))
                {
                }
        
                #endregion Constructors
        
                #region Override
        
                protected override bool IsValid(PropertyValidatorContext context)
                {
                    return true;
                }
        
                #endregion Override
        
                #endregion Methods
            }

        سپس باید کلاس‌های تعریف شده رو به FluentValidation معرفی کرد:
        .AddFluentValidation(option =>
                    {
                        option.RegisterValidatorsFromAssemblyContaining<CreateBankValidation>();
                        option.ConfigureClientsideValidation(AddFluentValidationClientModelValidatorProvider());
                    })

         private static Action<FluentValidationClientModelValidatorProvider> AddFluentValidationClientModelValidatorProvider()
                {
                    return clientSideValidation =>
                    {
                        clientSideValidation.Add(typeof(NationalCodeValidator), (context, rule, validator) => new NationalCodeClientValidator(rule, validator));
                    };
                }

        حال فقط مانده استفاده ساختار Validation در سمت کلاینت:
        // بررسی تایید کد ملی
        
        function setCustomValidator() {
            $.validator.unobtrusive.adapters.add('nationalcode', [], function (options) {
                options.rules['nationalcode'] = {};
                options.messages['nationalcode'] = options.message;
            });
            $.validator.addMethod('nationalcode', function (value, element, parameters) {
                if (isValidIranianNationalCode(value)) return true;
                return false;
            });
        }