From fc5e9dc5a60281fadef37263969fba1bddffd49b Mon Sep 17 00:00:00 2001
From: =?utf8?q?Roland=20H=C3=A4der?= <roland@mxchange.org>
Date: Thu, 22 Jun 2017 22:50:18 +0200
Subject: [PATCH] Please cherry-pick: - sendEmail() will now accept
 randomPassword parameter. Set to NULL if you   don't want/can set it.
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

Signed-off-by: Roland Häder <roland@mxchange.org>
---
 .../jjobs/database/BaseJobsDatabaseBean.java  | 41 ++++++++++---------
 1 file changed, 22 insertions(+), 19 deletions(-)

diff --git a/src/org/mxchange/jjobs/database/BaseJobsDatabaseBean.java b/src/org/mxchange/jjobs/database/BaseJobsDatabaseBean.java
index 6d60701..3f5eeff 100644
--- a/src/org/mxchange/jjobs/database/BaseJobsDatabaseBean.java
+++ b/src/org/mxchange/jjobs/database/BaseJobsDatabaseBean.java
@@ -113,7 +113,7 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 	/**
 	 * Returns a managed instance from given mobile number
 	 * <p>
-	 * @param mobileNumber Mobile number
+	 * @param mobileNumber  Mobile instance
 	 * @param fetchedNumber Found mobile number in database
 	 * <p>
 	 * @return Managed instance
@@ -156,8 +156,8 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 	/**
 	 * Returns a managed instance from given land-line number
 	 * <p>
-	 * @param landLineNumber Land-line number
-	 * @param fetchedNumber Found land-line number in database
+	 * @param landLineNumber Land-line instance
+	 * @param fetchedNumber  Found land-line number in database
 	 * <p>
 	 * @return Managed instance
 	 */
@@ -199,7 +199,7 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 	/**
 	 * Returns a managed instance from given fax number
 	 * <p>
-	 * @param faxNumber Fax number
+	 * @param faxNumber     Fax instance
 	 * @param fetchedNumber Found fax number in database
 	 * <p>
 	 * @return Managed instance
@@ -432,13 +432,15 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 	 * Sends an email with given subject line, template name to given recipient
 	 * and user data
 	 * <p>
-	 * @param subjectLine Subject line
-	 * @param templateName Template name
-	 * @param emailAddress Recipient's email address
-	 * @param user User instance
-	 * @param baseUrl Base URL
+	 * @param subjectLine    Subject line
+	 * @param templateName   Template name
+	 * @param emailAddress   Recipient's email address
+	 * @param user           User instance
+	 * @param baseUrl        Base URL
+	 * @param randomPassword A randomly-generated password or NULL if user had
+	 *                       to enter it.
 	 */
-	protected void sendEmail (final String subjectLine, final String templateName, final Address emailAddress, final User user, final String baseUrl) {
+	protected void sendEmail (final String subjectLine, final String templateName, final Address emailAddress, final User user, final String baseUrl, final String randomPassword) {
 		// Trace message
 		this.getLoggerBeanLocal().logTrace(MessageFormat.format("sendEmail: subjectLine={0},templateName={1},emailAddress={2},user={3},baseUrl={4} - CALLED!", subjectLine, templateName, emailAddress, user, baseUrl)); //NOI18N
 
@@ -458,7 +460,7 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 		} else if (null == emailAddress) {
 			// Throw NPE
 			throw new NullPointerException("emailAddress is null"); //NOI18N
-		}else if (null == user) {
+		} else if (null == user) {
 			// Throw NPE
 			throw new NullPointerException("user is null"); //NOI18N
 		} else if (user.getUserId() == null) {
@@ -496,8 +498,9 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 		// Set all values
 		Properties variables = UserUtils.getAllUserFields(user);
 
-		// Set base URL
+		// Set base URL and random password
 		variables.put("baseUrl", baseUrl); //NOI18N
+		variables.put("randomPassword", randomPassword); //NOI18N
 
 		// Set all
 		// @TODO Language from message bundle
@@ -528,7 +531,7 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 	 * should be the same.
 	 * <p>
 	 * @param contact Contact to set instances
-	 * @param other Other contact to get instances from
+	 * @param other   Other contact to get instances from
 	 */
 	protected void setAllContactPhoneEntries (final Contact contact, final Contact other) {
 		// Trace message
@@ -607,13 +610,13 @@ public abstract class BaseJobsDatabaseBean extends BaseDatabaseBean {
 	/**
 	 * Updates all contact's phone entry's updated timestamps
 	 * <p>
-	 * @param contact Contact instance to update
-	 * @param isMobileUnlinked Whether a cellphone entry has been unlinked in
-	 * contact instance
+	 * @param contact            Contact instance to update
+	 * @param isMobileUnlinked   Whether a mobile entry has been unlinked in
+	 *                           contact instance
 	 * @param isLandlineUnlinked Whether a land-line entry has been unlinked in
-	 * contact instance
-	 * @param isFaxUnlinked Whether a fax entry has been unlinked in contact
-	 * instance
+	 *                           contact instance
+	 * @param isFaxUnlinked      Whether a fax entry has been unlinked in
+	 *                           contact instance
 	 */
 	protected void setAllContactPhoneEntriesUpdated (final Contact contact, final boolean isMobileUnlinked, final boolean isLandlineUnlinked, final boolean isFaxUnlinked) {
 		// Trace message
-- 
2.39.2