X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2Fjava%2Forg%2Fmxchange%2Fjjobs%2Fbeans%2FBaseJobsController.java;h=a9f461ab756ed5bbe2cb4c4b700634ff96dfe256;hb=1ba5da9f3e90675e8964f090228405e4f43932f1;hp=6e67552e005f6aa2328b03cce621ecebcc7eb52b;hpb=fc14b0b3ab2183f68beb49225c7e661b05b89f5c;p=jjobs-war.git

diff --git a/src/java/org/mxchange/jjobs/beans/BaseJobsController.java b/src/java/org/mxchange/jjobs/beans/BaseJobsController.java
index 6e67552e..a9f461ab 100644
--- a/src/java/org/mxchange/jjobs/beans/BaseJobsController.java
+++ b/src/java/org/mxchange/jjobs/beans/BaseJobsController.java
@@ -17,6 +17,12 @@
 package org.mxchange.jjobs.beans;
 
 import java.io.Serializable;
+import java.security.Principal;
+import java.text.MessageFormat;
+import java.util.Locale;
+import java.util.MissingResourceException;
+import java.util.ResourceBundle;
+import javax.faces.application.FacesMessage;
 import javax.faces.context.FacesContext;
 
 /**
@@ -31,6 +37,70 @@ public abstract class BaseJobsController implements Serializable {
 	 */
 	private static final long serialVersionUID = 50_837_597_127_567_140L;
 
+	/**
+	 * Determines principal's name or returns null if no principal (security) is
+	 * set.
+	 * <p>
+	 * @return Principal's name or null
+	 */
+	protected String determinePrincipalName () {
+		// Get principal
+		Principal userPrincipal = FacesContext.getCurrentInstance().getExternalContext().getUserPrincipal();
+
+		// Init with null
+		String principalName = null;
+
+		// Is the principal set?
+		if (userPrincipal instanceof Principal) {
+			// Get principal's name
+			principalName = userPrincipal.getName();
+		}
+
+		// Return it
+		return principalName;
+	}
+
+	/**
+	 * Returns given property key or throws an exception if not found.
+	 * <p>
+	 * @param parameterKey Property key
+	 * <p>
+	 * @return Property value
+	 * <p>
+	 * @throws NullPointerException If given key is not found
+	 * @throws NumberFormatException If no number is given in context parameter
+	 */
+	protected int getIntegerContextParameter (final String parameterKey) throws NullPointerException, NumberFormatException {
+		// Get context parameter
+		Integer contextValue = Integer.parseInt(this.getStringContextParameter(parameterKey));
+
+		// Return it
+		return contextValue;
+	}
+
+	/**
+	 * Returns given property key or throws an exception if not found.
+	 * <p>
+	 * @param parameterKey Property key
+	 * <p>
+	 * @return Property value
+	 * <p>
+	 * @throws NullPointerException If given key is not found
+	 */
+	protected String getStringContextParameter (final String parameterKey) throws NullPointerException {
+		// Get context parameter
+		String contextValue = FacesContext.getCurrentInstance().getExternalContext().getInitParameter(parameterKey);
+
+		// Is it null?
+		if (null == contextValue) {
+			// Throw NPE
+			throw new NullPointerException(MessageFormat.format("parameterKey={0} is not set.", parameterKey)); //NOI18N
+		}
+
+		// Return it
+		return contextValue;
+	}
+
 	/**
 	 * Checks whether debug mode is enabled for given controller
 	 * <p>
@@ -49,7 +119,7 @@ public abstract class BaseJobsController implements Serializable {
 		}
 
 		// Try to get context parameter
-		String contextParameter = FacesContext.getCurrentInstance().getExternalContext().getInitParameter(String.format("is_debug_%s_enabled", controllerName)); //NOI18N
+		String contextParameter = this.getStringContextParameter(String.format("is_debug_%s_enabled", controllerName)); //NOI18N
 
 		// Is it set and true?
 		boolean isEnabled = ((contextParameter instanceof String) && (contextParameter.equals("true"))); //NOI18N
@@ -58,4 +128,65 @@ public abstract class BaseJobsController implements Serializable {
 		return isEnabled;
 	}
 
+	/**
+	 * Shows a faces message for given causing exception. The message from the
+	 * exception is being inserted into the message.
+	 * <p>
+	 * @param clientId Client id to send message to
+	 * @param cause Causing exception
+	 */
+	protected void showFacesMessage (final String clientId, final Throwable cause) {
+		// Trace message
+		System.out.println(MessageFormat.format("showFacesMessage: clientId={0},cause={1} - CALLED!", clientId, cause));
+
+		// Get context and add message
+		this.showFacesMessage(clientId, cause.getMessage());
+	}
+
+	/**
+	 * Shows a faces message with given message (i18n) key.
+	 * <p>
+	 * @param clientId Client id to send message to
+	 * @param i18nKey Message key
+	 * <p>
+	 * @throws NullPointerException If clientId or i18nKey is null
+	 * @throws IllegalArgumentException If clientId or i18nKey is empty
+	 */
+	protected void showFacesMessage (final String clientId, final String i18nKey) throws NullPointerException, IllegalArgumentException {
+		// Both parameter must be valid
+		if (null == clientId) {
+			// Throw NPE
+			throw new NullPointerException("clientId is null"); //NOI18N
+		} else if (clientId.isEmpty()) {
+			// Is empty
+			throw new IllegalArgumentException("clientId is null"); //NOI18N
+		} else if (null == i18nKey) {
+			// Throw NPE
+			throw new NullPointerException("i18nKey is null"); //NOI18N
+		} else if (i18nKey.isEmpty()) {
+			// Is empty
+			throw new IllegalArgumentException("i18nKey is null"); //NOI18N
+		}
+
+		// Get current locale
+		Locale locale = FacesContext.getCurrentInstance().getViewRoot().getLocale();
+
+		// Get bundle bundle
+		ResourceBundle bundle = ResourceBundle.getBundle("org.mxchange.localization.bundle", locale);
+
+		// Default is i18nKey
+		String message = i18nKey;
+
+		// Try it
+		try {
+			// Get message
+			message = bundle.getString(i18nKey);
+		} catch (final MissingResourceException ex) {
+			// Did not find it, ignored
+		}
+
+		// Get context and add message
+		FacesContext.getCurrentInstance().addMessage(clientId, new FacesMessage(message));
+	}
+
 }