RecordValidator 2.0.0

RecordValidator

RecordValidator is a .NET library for validating data against predefined rules.

public class Student{

        [Mandatory(validateForDefaultValue:true)]
        public  int  Id { get; set; }
        [Mandatory]
        public  string  Name { get; set; }
        [Mandatory(errorMessage:"Email is mandatory")]
        [Email]
        public  string  Email { get; set; }
        [Date(minDate:"2000-01-01")]
        public  DateTime  Doj { get; set; }
        [Mandatory]
        [RegularExpression(pattern: "^(?:(?:\\+|0{0,2})91(\\s*[\\-]\\s*)?|[0]?)?[6789]\\d{9}$")]
        public  string  Mobile { get; set; }
        public  bool  IActive { get; set; }
        [Length(min:10, max:100)]
        public  string  Address { get; set; }
        [RegularExpression(pattern: "^[1-9][0-9]{5}$")]
        public  string  Pincode { get; set; }
        [DataRange(min: 0, max: 100)]
        public int Age { get; set; }

    }

Now call the Validate with throwException parameter value as true function

try
{
    var std=new Student()
    {
        Name="",
        Address="TH",
        Doj=new DateTime(1999,01,01),
        Email="Vishal",
        IActive=true,
        Id=0,
        Mobile="3949132",
        Pincode="0002345",
        Age=10
    };
    std.Validate(throwException:true);
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Or you can use ValidateValueAndReturnListOfExceptions() to get the exceptions in case if you don't want to break your flow

try
{
    var std=new Student()
    {
        Name="",
        Address="TH",
        Doj=new DateTime(1999,01,01),
        Email="Vishal",
        IActive=true,
        Id=0,
        Mobile="3949132",
        Pincode="0002345",
        Age=10

    };
    
    var result=std.Validate(throwException:false);
    //you can now use the list to log the errors 
    foreach(var exception in result)
    {
        Console.WriteLine($"Error - {exception.ErrorMessage} against {exception.Param}");
    }
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Single value validations can also be done

//Throws exception if mandatory validation fails
var name = "";
name.ValidateValue(new ValidationBuilder().ValidateMandatory(), throwException: true, paramName: "name");

// Returns RecordValidatorException object with error details if mandatory validation fails
var name = "";
var error = name.ValidateValue(new ValidationBuilder().ValidateMandatory(errorMessage:"Please provide name "), paramName: "name");

// passing multiple validation rules in the single line to validate for all the given rules and resturns the list of RecordValidatorException object with error details 
var name = "";
var validationBuilder= new ValidationBuilder().ValidateMandatory().ValidateLength(min:3,max:20);
var errors = name.ValidateValue(validationBuilder, paramName: "name");

public class Company
{
   public List<EmployeeData> Employees { get; set; }
}

public class EmployeeData
{
    [Mandatory]
    [Length(max: 100)]
    public string Name { get; set; }
    [Mandatory]
    [Length(min:4,max: 6)]
    public string Gender { get; set; }

}

var company=new Company();
company.Employees=new List<EmployeeData>()
{
     new EmployeeData()
    {
        Name="Vishal",
        Gender="Male"
    },
    new EmployeeData()
    {
        Name=string.Empty,
        Gender=string.Empty
    }

};


//it will validate Employee data also against the given Record Validator attribute.
company.Validate(throwException:true)

List of validations supported in the latest version

• Mandatory
• Range(DataRange)
• Date
• Email
• Length
• Regular Expression(RegularExpression)
• more will be added in the coming versions

New Changes in 2.0.0

• Custom validation attribute
  • Now you can create custom validation attribute.
• Performance improvement

//Inherit RecordValidatorBase class 
[AttributeUsage(AttributeTargets.Property)]
public class CustomValidationAttribute : RecordValidatorBase
{
    public CustomValidationAttribute(string errorMessage = "") : base(errorMessage)
    {
    }

    //Override the Validate method and put your validation logic inside this method
    public override RecordValidatorException Validate(object value, string param)
    {

        var errroMessage = ErrorMessage;
        if (string.IsNullOrEmpty(errroMessage))
        {
            errroMessage = $"Invalid data ";
            // in case validation fails then always return RecordValidatorException class object
            return new RecordValidatorException() { ErrorMessage = errroMessage, Param = param };
        }
           
        return null;
    }

    
}

Features

• Support for various validation rules and will be added more in coming versions.
• Easy to use
• Custom error message can be set, if it is not given then default will be taken.
• Custom validation attribute support

License

This project is licensed under the MIT License - see the LICENSE file for details.