#483: provide API to clear the list too (needed for junit tests as well) [skip ci]

Author: bbottema

Diff for: modules/core-module/src/main/java/org/simplejavamail/api/email/EmailPopulatingBuilder.java

@@ -1532,6 +1532,13 @@ public interface EmailPopulatingBuilder {
 	@SuppressWarnings("unused")
 	EmailPopulatingBuilder clearRecipients();
 
+	/**
+	 * Resets <em>overrideReceivers</em> to empty.
+	 *
+	 * @see #withOverrideReceivers(List)
+	 */
+	EmailPopulatingBuilder clearOverrideReceivers();
+
 	/**
 	 * Resets base dir for embedded images to {@code null}.
 	 */

Diff for: modules/core-module/src/main/java/org/simplejavamail/api/email/EqualsHelper.java

@@ -55,10 +55,12 @@ public static boolean equalsEmail(final Email email1, final Email email2) {
         if (!fieldIsEqual(email1.getSubject(), email2.getSubject(), "subject")) {
             return false;
         }
-
         if (!isEqualRecipientList(email1.getRecipients(), email2.getRecipients())) {
             return false;
         }
+        if (!isEqualRecipientList(email1.getOverrideReceivers(), email2.getOverrideReceivers())) {
+            return false;
+        }
         if (!email1.getEmbeddedImages().containsAll(email2.getEmbeddedImages()) || !email2.getEmbeddedImages().containsAll(email1.getEmbeddedImages())) {
             return false;
         }

Diff for: modules/simple-java-mail/src/main/java/org/simplejavamail/email/internal/EmailPopulatingBuilderImpl.java

@@ -2232,6 +2232,15 @@ public EmailPopulatingBuilder clearRecipients() {
 		return this;
 	}
 
+	/**
+	 * @see EmailPopulatingBuilder#clearOverrideReceivers()
+	 */
+	@Override
+	public EmailPopulatingBuilder clearOverrideReceivers() {
+		this.overrideReceivers.clear();
+		return this;
+	}
+
 	/**
 	 * @see EmailPopulatingBuilder#clearEmbeddedImageBaseDir()
 	 */

Diff for: modules/simple-java-mail/src/test/java/org/simplejavamail/mailer/MailerLiveTest.java

@@ -467,6 +467,9 @@ private Email assertSendingEmail(final EmailPopulatingBuilder originalEmailPopul
 				.withHeader("governanceOverrideTest1", "overridden", true)
 				.withHeader("governanceOverrideTest2", "also overridden", true);
 
+		// envelope-level receivers would have been lost in the received Message, so we need to compensate for that
+		originalEmailPopulatingBuilder.clearOverrideReceivers();
+
 		if (!skipChecksDueToSmime) { // reading a signed mail is different from building a new one
 			assertThat(receivedEmail).isEqualTo(originalEmailPopulatingBuilder.buildEmail());
 		} else {