Merge pull request #339 from hassanhabib/users/cjdutoit/coderub-validation-engine

CODE RUB: Update to validation engine to allow injection of message

Author: hassanhabib

2. Services/2.1 Foundations/2.1 Foundations.md

@@ -387,16 +387,17 @@ Our dynamic rule now can offer more input parameters and more helpful informatio
 Now that we have the advanced exceptions and the dynamic validation rules. It's time to put it all together in terms of accepting infinite number of validation rules, examining their condition results and finally break the circuit when all the continuous validations are done. Here's how to do that:
 
 ```csharp
-private void Validate(params (dynamic Rule, string Parameter)[] validations)
+private void Validate(
+	string message,
+	params (dynamic Rule, string Parameter)[] validations)
 {
-    var invalidStudentException = new InvalidStudentException(
-        message: "Student is invalid. Please fix the errors and try again.");
+    var invalidStudentException = new InvalidStudentException(message);
 
     foreach((dynamic rule, string parameter) in validations)
     {
         if(rule.Condition)
         {
-            invalidStudentException.UpsertDataList(parameter, rule.Message);
+            invalidStudentException.UpsertDataList(key: parameter, value: rule.Message);
         }
     }
 
@@ -412,6 +413,7 @@ private static void ValidateStudentOnAdd(Student student)
 	......
 
 	Validate(
+		message: "Student is invalid. Please fix the errors and try again.",
 		(Rule: IsInvalid(student.Id), Parameter: nameof(Student.Id)),
 		(Rule: IsInvalid(student.Name), Parameter: nameof(Student.Name)),
 		(Rule: IsInvalid(student.Grade), Parameter: nameof(Student.Grade))
@@ -456,6 +458,7 @@ private async ValueTask ValidateStudentOnAddAsync(Student student)
 	......
 
 	Validate(
+		message: "Student is invalid. Please fix the errors and try again.",
 		(Rule: IsInvalid(student.Id), Parameter: nameof(Student.Id)),
 		(Rule: IsInvalid(student.Name), Parameter: nameof(Student.Name)),
 		(Rule: IsInvalid(student.Address), Parameter: nameof(Student.Address))
@@ -464,6 +467,7 @@ private async ValueTask ValidateStudentOnAddAsync(Student student)
 	......
 
 	Validate(
+		message: "Student address is invalid. Please fix the errors and try again.",
 		(Rule: IsInvalid(student.Address.Street), Parameter: nameof(StudentAddress.Street)),
 		(Rule: IsInvalid(student.Address.City), Parameter: nameof(StudentAddress.City)),
 		(Rule: IsInvalid(student.Address.ZipCode), Parameter: nameof(StudentAddress.ZipCode))
@@ -631,7 +635,9 @@ private static void ValidateStudentOnAdd(Student student)
 {
 	......
 
-    Validate((Rule: IsInvalid(student.Id), Parameter: nameof(Student.Id)));
+    Validate(
+		message: "Student is invalid. Please fix the errors and try again.",
+		(Rule: IsInvalid(student.Id), Parameter: nameof(Student.Id)));
 }
 
 private static dynamic IsInvalid(Guid id) => new
@@ -640,16 +646,15 @@ private static dynamic IsInvalid(Guid id) => new
     Message = "Id is invalid"
 };
 
-private void Validate(params (dynamic Rule, string Parameter)[] validations)
+private void Validate(string message, params (dynamic Rule, string Parameter)[] validations)
 {
-    var invalidStudentException = new InvalidStudentException(
-        message: "Student is invalid. Please fix the errors and try again.");
+    var invalidStudentException = new InvalidStudentException(message);
 
     foreach((dynamic rule, string parameter) in validations)
     {
         if(rule.Condition)
         {
-            invalidStudentException.UpsertDataList(parameter, rule.Message);
+            invalidStudentException.UpsertDataList(key: parameter, value: rule.Message);
         }
     }
 
@@ -902,6 +907,7 @@ Just like we did in the structural validations section, we are going to validate
     ValidateStudentIsNotNull(student);
 
     Validate(
+        message: "Student is invalid. Please fix the errors and try again.",
         (Rule: IsInvalid(student.Id), Parameter: nameof(Student.Id)),
         (Rule: IsInvalid(student.Name), Parameter: nameof(Student.Name)),
         (Rule: IsInvalid(student.CreatedBy), Parameter: nameof(Student.CreatedBy)),
@@ -1012,11 +1018,9 @@ private async ValueTask<(bool IsNotRecent, DateTimeOffset StartDate, DateTimeOff
 ```
 #### Finally our `Validate` method would look like this:
 ```csharp
-private static void Validate(params (dyanamic Rule, string Parameter)[] validations)
+private static void Validate(string message, params (dynamic Rule, string Parameter)[] validations)
 {
-	var invalidStudentException =
-		new InvalidStudentException(
-			message: "Student is invalid. Please fix the errors and try again.");
+	var invalidStudentException = new InvalidStudentException(message);
 
 	foreach((dynamic rule, string parameter) in validations)
 	{