All Downloads are FREE. Search and download functionalities are using the official Maven repository.

jadex.platform.service.cms.LoggerWrapper Maven / Gradle / Ivy

Go to download

The Jadex platform package contains implementations of platform services as well as the platform component itself.

There is a newer version: 3.0.117
Show newest version
package jadex.platform.service.cms;

import java.util.Locale;
import java.util.MissingResourceException;
import java.util.ResourceBundle;
import java.util.logging.Filter;
import java.util.logging.Handler;
import java.util.logging.Level;
import java.util.logging.LogRecord;
import java.util.logging.Logger;

import jadex.bridge.service.types.clock.IClockService;
import jadex.commons.SNonAndroid;
import jadex.commons.SReflect;


/**
 *  The logger wrapper is used to encapsulate
 *  a logger and redirect messages to the logger with
 *  the correct time (according to a clock service).
 *  
 *  Overrides the log methods and always sets the log
 *  record time to the value of the clock service.
 *  Then delegates the calls to the original logger.
 */
public class LoggerWrapper extends Logger
{
	//-------- attributes --------
	
	/** The original logger. */
	protected Logger logger;
	
	/** The clock service. */
	protected IClockService clock;

	// Need to be declared again because they are private in Logger :-((
	protected static final int offValue = Level.OFF.intValue();
	protected ResourceBundle catalog;	// Cached resource bundle
	protected String catalogName;    	// name associated with catalog
	protected Locale catalogLocale;   	// locale associated with catalog

	//-------- constructors --------
	
	/**
	 *  Create a new logger wrapper.
	 */
	public LoggerWrapper(Logger logger, IClockService clock)
	{
		super(logger.getName(), logger.getResourceBundleName());
		this.logger = logger;
		this.clock = clock;
	}

	//-------- methods --------
	
	/**
	 * 
	 */
	public LogRecord createLogRecord(Level level, String msg, long time)
	{
		LogRecord lr = new CustomLogRecord(level, msg);
		lr.setMillis(time);
		return lr;
	}
	
	/**
	 * Retrieve the localization resource bundle for this logger for the current
	 * default locale. Note that if the result is null, then the Logger will use
	 * a resource bundle inherited from its parent.
	 * 
	 * @return localization bundle (may be null)
	 */
	public ResourceBundle getResourceBundle()
	{
		return logger.getResourceBundle();
	}

	/**
	 * Retrieve the localization resource bundle name for this logger. Note that
	 * if the result is null, then the Logger will use a resource bundle name
	 * inherited from its parent.
	 * 
	 * @return localization bundle name (may be null)
	 */
	public String getResourceBundleName()
	{
		return logger.getResourceBundleName();
	}

	/**
	 * Set a filter to control output on this Logger.
	 * 

* After passing the initial "level" check, the Logger will call this Filter * to check if a log record should really be published. * * @param newFilter a filter object (may be null) * @exception SecurityException if a security manager exists and if the * caller does not have LoggingPermission("control"). */ public void setFilter(Filter newFilter) throws SecurityException { logger.setFilter(newFilter); } /** * Get the current filter for this Logger. * * @return a filter object (may be null) */ public Filter getFilter() { return logger.getFilter(); } /** * Log a LogRecord. *

* All the other logging methods in this class call through this method to * actually perform any logging. Subclasses can override this single method * to capture all log activity. * * @param record the LogRecord to be published */ public void log(LogRecord record) { logger.log(record); } /** * Log a message, with no arguments. *

* If the logger is currently enabled for the given message level then the * given message is forwarded to all the registered output Handler objects. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param msg The string message (or a key in the message catalog) */ public void log(Level level, String msg) { if(logger.getLevel()!=null && level.intValue()>=logger.getLevel().intValue() && logger.getLevel().intValue()!=offValue) { LogRecord lr = createLogRecord(level, msg, getTime()); log(lr); } } /** * Log a message, with one object parameter. *

* If the logger is currently enabled for the given message level then a * corresponding LogRecord is created and forwarded to all the registered * output Handler objects. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param msg The string message (or a key in the message catalog) * @param param1 parameter to the message */ public void log(Level level, String msg, Object param1) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); Object params[] = {param1}; lr.setParameters(params); log(lr); } /** * Log a message, with an array of object arguments. *

* If the logger is currently enabled for the given message level then a * corresponding LogRecord is created and forwarded to all the registered * output Handler objects. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param msg The string message (or a key in the message catalog) * @param params array of parameters to the message */ public void log(Level level, String msg, Object params[]) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setParameters(params); log(lr); } /** * Log a message, with associated Throwable information. *

* If the logger is currently enabled for the given message level then the * given arguments are stored in a LogRecord which is forwarded to all * registered output handlers. *

* Note that the thrown argument is stored in the LogRecord thrown property, * rather than the LogRecord parameters property. Thus is it processed * specially by output Formatters and is not treated as a formatting * parameter to the LogRecord message property. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param msg The string message (or a key in the message catalog) * @param thrown Throwable associated with log message. */ public void log(Level level, String msg, Throwable thrown) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setThrown(thrown); log(lr); } /** * Log a message, specifying source class and method, with no arguments. *

* If the logger is currently enabled for the given message level then the * given message is forwarded to all the registered output Handler objects. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param msg The string message (or a key in the message catalog) */ public void logp(Level level, String sourceClass, String sourceMethod, String msg) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); log(lr); } /** * Log a message, specifying source class and method, with a single object * parameter to the log message. *

* If the logger is currently enabled for the given message level then a * corresponding LogRecord is created and forwarded to all the registered * output Handler objects. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param msg The string message (or a key in the message catalog) * @param param1 Parameter to the log message. */ public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); Object params[] = {param1}; lr.setParameters(params); log(lr); } /** * Log a message, specifying source class and method, with an array of * object arguments. *

* If the logger is currently enabled for the given message level then a * corresponding LogRecord is created and forwarded to all the registered * output Handler objects. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param msg The string message (or a key in the message catalog) * @param params Array of parameters to the message */ public void logp(Level level, String sourceClass, String sourceMethod, String msg, Object params[]) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); lr.setParameters(params); log(lr); } /** * Log a message, specifying source class and method, with associated * Throwable information. *

* If the logger is currently enabled for the given message level then the * given arguments are stored in a LogRecord which is forwarded to all * registered output handlers. *

* Note that the thrown argument is stored in the LogRecord thrown property, * rather than the LogRecord parameters property. Thus is it processed * specially by output Formatters and is not treated as a formatting * parameter to the LogRecord message property. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param msg The string message (or a key in the message catalog) * @param thrown Throwable associated with log message. */ public void logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); lr.setThrown(thrown); log(lr); } // ========================================================================= // Start of convenience methods WITH className, methodName and bundle name. // ========================================================================= // Private support method for logging for "logrb" methods. // We fill in the logger name, resource bundle name, and // resource bundle and then call "void log(LogRecord)". private void doLog(LogRecord lr, String rbname) { lr.setLoggerName(getName()); if(rbname != null) { lr.setResourceBundleName(rbname); lr.setResourceBundle(findResourceBundle(rbname)); } log(lr); } /** * Log a message, specifying source class, method, and resource bundle name * with no arguments. *

* If the logger is currently enabled for the given message level then the * given message is forwarded to all the registered output Handler objects. *

* The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid then the msg * string is not localized. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param bundleName name of resource bundle to localize msg, can be null * @param msg The string message (or a key in the message catalog) */ public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); doLog(lr, bundleName); } /** * Log a message, specifying source class, method, and resource bundle name, * with a single object parameter to the log message. *

* If the logger is currently enabled for the given message level then a * corresponding LogRecord is created and forwarded to all the registered * output Handler objects. *

* The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid then the msg * string is not localized. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param bundleName name of resource bundle to localize msg, can be null * @param msg The string message (or a key in the message catalog) * @param param1 Parameter to the log message. */ public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); Object params[] = {param1}; lr.setParameters(params); doLog(lr, bundleName); } /** * Log a message, specifying source class, method, and resource bundle name, * with an array of object arguments. *

* If the logger is currently enabled for the given message level then a * corresponding LogRecord is created and forwarded to all the registered * output Handler objects. *

* The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid then the msg * string is not localized. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param bundleName name of resource bundle to localize msg, can be null. * @param msg The string message (or a key in the message catalog) * @param params Array of parameters to the message */ public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object params[]) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); lr.setParameters(params); doLog(lr, bundleName); } /** * Log a message, specifying source class, method, and resource bundle name, * with associated Throwable information. *

* If the logger is currently enabled for the given message level then the * given arguments are stored in a LogRecord which is forwarded to all * registered output handlers. *

* The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid then the msg * string is not localized. *

* Note that the thrown argument is stored in the LogRecord thrown property, * rather than the LogRecord parameters property. Thus is it processed * specially by output Formatters and is not treated as a formatting * parameter to the LogRecord message property. *

* * @param level One of the message level identifiers, e.g. SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request * @param bundleName name of resource bundle to localize msg, can be null * @param msg The string message (or a key in the message catalog) * @param thrown Throwable associated with log message. */ public void logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown) { if(level.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(level, msg, getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); lr.setThrown(thrown); doLog(lr, bundleName); } // ====================================================================== // Start of convenience methods for logging method entries and returns. // ====================================================================== // /** // * Log a method entry. // *

// * This is a convenience method that can be used to log entry to a method. A // * LogRecord with message "ENTRY", log level FINER, and the given // * sourceMethod and sourceClass is logged. // *

// * // * @param sourceClass name of class that issued the logging request // * @param sourceMethod name of method that is being entered // */ // public void entering(String sourceClass, String sourceMethod) // { // if(Level.FINER.intValue() < levelValue) // { // return; // } // logp(Level.FINER, sourceClass, sourceMethod, "ENTRY"); // } // /** // * Log a method entry, with one parameter. // *

// * This is a convenience method that can be used to log entry to a method. A // * LogRecord with message "ENTRY {0}", log level FINER, and the given // * sourceMethod, sourceClass, and parameter is logged. // *

// * // * @param sourceClass name of class that issued the logging request // * @param sourceMethod name of method that is being entered // * @param param1 parameter to the method being entered // */ // public void entering(String sourceClass, String sourceMethod, Object param1) // { // if(Level.FINER.intValue() < levelValue) // { // return; // } // Object params[] = {param1}; // logp(Level.FINER, sourceClass, sourceMethod, "ENTRY {0}", params); // } // /** // * Log a method entry, with an array of parameters. // *

// * This is a convenience method that can be used to log entry to a method. A // * LogRecord with message "ENTRY" (followed by a format {N} indicator for // * each entry in the parameter array), log level FINER, and the given // * sourceMethod, sourceClass, and parameters is logged. // *

// * // * @param sourceClass name of class that issued the logging request // * @param sourceMethod name of method that is being entered // * @param params array of parameters to the method being entered // */ // public void entering(String sourceClass, String sourceMethod, // Object params[]) // { // if(Level.FINER.intValue() < levelValue) // { // return; // } // String msg = "ENTRY"; // if(params == null) // { // logp(Level.FINER, sourceClass, sourceMethod, msg); // return; // } // for(int i = 0; i < params.length; i++) // { // msg = msg + " {" + i + "}"; // } // logp(Level.FINER, sourceClass, sourceMethod, msg, params); // } // /** // * Log a method return. // *

// * This is a convenience method that can be used to log returning from a // * method. A LogRecord with message "RETURN", log level FINER, and the given // * sourceMethod and sourceClass is logged. // *

// * // * @param sourceClass name of class that issued the logging request // * @param sourceMethod name of the method // */ // public void exiting(String sourceClass, String sourceMethod) // { // if(Level.FINER.intValue() < levelValue) // { // return; // } // logp(Level.FINER, sourceClass, sourceMethod, "RETURN"); // } // /** // * Log a method return, with result object. // *

// * This is a convenience method that can be used to log returning from a // * method. A LogRecord with message "RETURN {0}", log level FINER, and the // * gives sourceMethod, sourceClass, and result object is logged. // *

// * // * @param sourceClass name of class that issued the logging request // * @param sourceMethod name of the method // * @param result Object that is being returned // */ // public void exiting(String sourceClass, String sourceMethod, Object result) // { // if(Level.FINER.intValue() < levelValue) // { // return; // } // Object params[] = {result}; // logp(Level.FINER, sourceClass, sourceMethod, "RETURN {0}", result); // } /** * Log throwing an exception. *

* This is a convenience method to log that a method is terminating by * throwing an exception. The logging is done using the FINER level. *

* If the logger is currently enabled for the given message level then the * given arguments are stored in a LogRecord which is forwarded to all * registered output handlers. The LogRecord's message is set to "THROW". *

* Note that the thrown argument is stored in the LogRecord thrown property, * rather than the LogRecord parameters property. Thus is it processed * specially by output Formatters and is not treated as a formatting * parameter to the LogRecord message property. *

* * @param sourceClass name of class that issued the logging request * @param sourceMethod name of the method. * @param thrown The Throwable that is being thrown. */ public void throwing(String sourceClass, String sourceMethod, Throwable thrown) { if(Level.FINER.intValue() < logger.getLevel().intValue() || logger.getLevel().intValue() == offValue) return; LogRecord lr = createLogRecord(Level.FINER, "THROW", getTime()); lr.setSourceClassName(sourceClass); lr.setSourceMethodName(sourceMethod); lr.setThrown(thrown); doLog(lr, null); // todo: was doLog(lr); } // ======================================================================= // Start of simple convenience methods using level names as method names // ======================================================================= // /** // * Log a SEVERE message. // *

// * If the logger is currently enabled for the SEVERE message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void severe(String msg) // { // if(Level.SEVERE.intValue() < levelValue) // { // return; // } // log(Level.SEVERE, msg); // } // // /** // * Log a WARNING message. // *

// * If the logger is currently enabled for the WARNING message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void warning(String msg) // { // if(Level.WARNING.intValue() < levelValue) // { // return; // } // log(Level.WARNING, msg); // } // // /** // * Log an INFO message. // *

// * If the logger is currently enabled for the INFO message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void info(String msg) // { // if(Level.INFO.intValue() < levelValue) // { // return; // } // log(Level.INFO, msg); // } // // /** // * Log a CONFIG message. // *

// * If the logger is currently enabled for the CONFIG message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void config(String msg) // { // if(Level.CONFIG.intValue() < levelValue) // { // return; // } // log(Level.CONFIG, msg); // } // // /** // * Log a FINE message. // *

// * If the logger is currently enabled for the FINE message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void fine(String msg) // { // if(Level.FINE.intValue() < levelValue) // { // return; // } // log(Level.FINE, msg); // } // // /** // * Log a FINER message. // *

// * If the logger is currently enabled for the FINER message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void finer(String msg) // { // if(Level.FINER.intValue() < levelValue) // { // return; // } // log(Level.FINER, msg); // } // // /** // * Log a FINEST message. // *

// * If the logger is currently enabled for the FINEST message level then the // * given message is forwarded to all the registered output Handler objects. // *

// * // * @param msg The string message (or a key in the message catalog) // */ // public void finest(String msg) // { // if(Level.FINEST.intValue() < levelValue) // { // return; // } // log(Level.FINEST, msg); // } /** * Set the log level specifying which message levels will be logged by this * logger. Message levels lower than this value will be discarded. The level * value Level.OFF can be used to turn off logging. *

* If the new level is null, it means that this node should inherit its * level from its nearest ancestor with a specific (non-null) level value. * * @param newLevel the new value for the log level (may be null) * @exception SecurityException if a security manager exists and if the * caller does not have LoggingPermission("control"). */ public void setLevel(Level newLevel) throws SecurityException { logger.setLevel(newLevel); } /** * Get the log Level that has been specified for this Logger. The result may * be null, which means that this logger's effective level will be inherited * from its parent. * * @return this Logger's level */ public Level getLevel() { return logger.getLevel(); } /** * Check if a message of the given level would actually be logged by this * logger. This check is based on the Loggers effective level, which may be * inherited from its parent. * * @param level a message logging level * @return true if the given message level is currently being logged. */ public boolean isLoggable(Level level) { return logger.isLoggable(level); } /** * Get the name for this logger. * * @return logger name. Will be null for anonymous Loggers. */ public String getName() { return logger.getName(); } /** * Add a log Handler to receive logging messages. *

* By default, Loggers also send their output to their parent logger. * Typically the root Logger is configured with a set of Handlers that * essentially act as default handlers for all loggers. * * @param handler a logging Handler * @exception SecurityException if a security manager exists and if the * caller does not have LoggingPermission("control"). */ public synchronized void addHandler(Handler handler) throws SecurityException { logger.addHandler(handler); } /** * Remove a log Handler. *

* Returns silently if the given Handler is not found or is null * * @param handler a logging Handler * @exception SecurityException if a security manager exists and if the * caller does not have LoggingPermission("control"). */ public synchronized void removeHandler(Handler handler) throws SecurityException { logger.removeHandler(handler); } /** * Get the Handlers associated with this logger. *

* * @return an array of all registered Handlers */ public synchronized Handler[] getHandlers() { return logger.getHandlers(); } /** * Specify whether or not this logger should send its output to it's parent * Logger. This means that any LogRecords will also be written to the * parent's Handlers, and potentially to its parent, recursively up the * namespace. * * @param useParentHandlers true if output is to be sent to the logger's * parent. * @exception SecurityException if a security manager exists and if the * caller does not have LoggingPermission("control"). */ public synchronized void setUseParentHandlers(boolean useParentHandlers) { logger.setUseParentHandlers(useParentHandlers); } /** * Discover whether or not this logger is sending its output to its parent * logger. * * @return true if output is to be sent to the logger's parent */ public synchronized boolean getUseParentHandlers() { return logger.getUseParentHandlers(); } // Private utility method to map a resource bundle name to an // actual resource bundle, using a simple one-entry cache. // Returns null for a null name. // May also return null if we can't find the resource bundle and // there is no suitable previous cached value. private synchronized ResourceBundle findResourceBundle(String name) { // Return a null bundle for a null name. if(name == null) { return null; } Locale currentLocale = Locale.getDefault(); // Normally we should hit on our simple one entry cache. if(catalog != null && currentLocale == catalogLocale && name == catalogName) { return catalog; } // Use the thread's context ClassLoader. If there isn't one, // use the SystemClassloader. ClassLoader cl = Thread.currentThread().getContextClassLoader(); if(cl == null) { cl = ClassLoader.getSystemClassLoader(); } try { catalog = ResourceBundle.getBundle(name, currentLocale, cl); catalogName = name; catalogLocale = currentLocale; return catalog; } catch(MissingResourceException ex) { // Woops. We can't find the ResourceBundle in the default // ClassLoader. Drop through. } if (!SReflect.isAndroid()) { ResourceBundle cat = SNonAndroid.findResourceBundle(name, currentLocale, cl); if (cat != null) { catalog = cat; catalogName = name; catalogLocale = currentLocale; } } if(name.equals(catalogName)) { // Return the previous cached value for that name. // This may be null. return catalog; } // Sorry, we're out of luck. return null; } // // Private utility method to initialize our one entry // // resource bundle cache. // // Note: for consistency reasons, we are careful to check // // that a suitable ResourceBundle exists before setting the // // ResourceBundleName. // private synchronized void setupResourceInfo(String name) // { // if(name == null) // { // return; // } // ResourceBundle rb = findResourceBundle(name); // if(rb == null) // { // // We've failed to find an expected ResourceBundle. // throw new MissingResourceException( // "Can't find " + name + " bundle", name, ""); // } // resourceBundleName = name; // } /** * Return the parent for this Logger. *

* This method returns the nearest extant parent in the namespace. Thus if a * Logger is called "a.b.c.d", and a Logger called "a.b" has been created * but no logger "a.b.c" exists, then a call of getParent on the Logger * "a.b.c.d" will return the Logger "a.b". *

* The result will be null if it is called on the root Logger in the * namespace. * * @return nearest existing parent Logger */ public Logger getParent() { return logger.getParent(); } /** * Set the parent for this Logger. This method is used by the LogManager to * update a Logger when the namespace changes. *

* It should not be called from application code. *

* * @param parent the new parent logger * @exception SecurityException if a security manager exists and if the * caller does not have LoggingPermission("control"). */ public void setParent(Logger parent) { logger.setParent(parent); } // // Private method to do the work for parenting a child // // Logger onto a parent logger. // private void doSetParent(Logger newParent) // { // // // System.err.println("doSetParent \"" + getName() + "\" \"" // // + newParent.getName() + "\""); // // synchronized(treeLock) // { // // // Remove ourself from any previous parent. // if(parent != null) // { // // assert parent.kids != null; // for(Iterator iter = parent.kids.iterator(); iter.hasNext();) // { // WeakReference ref = (WeakReference)iter.next(); // Logger kid = (Logger)ref.get(); // if(kid == this) // { // iter.remove(); // break; // } // } // // We have now removed ourself from our parents' kids. // } // // // Set our new parent. // parent = newParent; // if(parent.kids == null) // { // parent.kids = new ArrayList(2); // } // parent.kids.add(new WeakReference(this)); // // // As a result of the reparenting, the effective level // // may have changed for us and our children. // updateEffectiveLevel(); // // } // } // // // Recalculate the effective level for this node and // // recursively for our children. // // private void updateEffectiveLevel() // { // // assert Thread.holdsLock(treeLock); // // // Figure out our current effective level. // int newLevelValue; // if(levelObject != null) // { // newLevelValue = levelObject.intValue(); // } // else // { // if(parent != null) // { // newLevelValue = parent.levelValue; // } // else // { // // This may happen during initialization. // newLevelValue = Level.INFO.intValue(); // } // } // // // If our effective value hasn't changed, we're done. // if(levelValue == newLevelValue) // { // return; // } // // levelValue = newLevelValue; // // // System.err.println("effective level: \"" + getName() + "\" := " + // // level); // // // Recursively update the level on each of our kids. // if(kids != null) // { // for(int i = 0; i < kids.size(); i++) // { // WeakReference ref = (WeakReference)kids.get(i); // Logger kid = (Logger)ref.get(); // if(kid != null) // { // kid.updateEffectiveLevel(); // } // } // } // } // // Private method to get the potentially inherited // // resource bundle name for this Logger. // // May return null // private String getEffectiveResourceBundleName() // { // Logger target = this; // while(target != null) // { // String rbn = target.getResourceBundleName(); // if(rbn != null) // { // return rbn; // } // target = target.getParent(); // } // return null; // } /** * Get the time. */ protected long getTime() { try { return clock!=null ? clock.getTime() : System.currentTimeMillis(); } catch(Exception e) { return System.currentTimeMillis(); } } /** * Log a SEVERE message. *

* If the logger is currently enabled for the SEVERE message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void severe(String msg) { if (Level.SEVERE.intValue() < logger.getLevel().intValue()) { return; } log(Level.SEVERE, msg); } /** * Log a WARNING message. *

* If the logger is currently enabled for the WARNING message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void warning(String msg) { // Hack!!! Happens on VM shutdown as log manager sets all log levels to null. if(logger.getLevel()==null) { return; } if (Level.WARNING.intValue() < logger.getLevel().intValue()) { return; } log(Level.WARNING, msg); } /** * Log an INFO message. *

* If the logger is currently enabled for the INFO message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void info(String msg) { // Hack!!! Happens on VM shutdown as log manager sets all log levels to null. if(logger.getLevel()==null) { return; } if(Level.INFO.intValue() < logger.getLevel().intValue()) { return; } log(Level.INFO, msg); } /** * Log a CONFIG message. *

* If the logger is currently enabled for the CONFIG message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void config(String msg) { if (Level.CONFIG.intValue() < logger.getLevel().intValue()) { return; } log(Level.CONFIG, msg); } /** * Log a FINE message. *

* If the logger is currently enabled for the FINE message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void fine(String msg) { if (Level.FINE.intValue() < logger.getLevel().intValue()) { return; } log(Level.FINE, msg); } /** * Log a FINER message. *

* If the logger is currently enabled for the FINER message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void finer(String msg) { if (Level.FINER.intValue() < logger.getLevel().intValue()) { return; } log(Level.FINER, msg); } /** * Log a FINEST message. *

* If the logger is currently enabled for the FINEST message * level then the given message is forwarded to all the * registered output Handler objects. *

* @param msg The string message (or a key in the message catalog) */ public void finest(String msg) { if (Level.FINEST.intValue() < logger.getLevel().intValue()) { return; } log(Level.FINEST, msg); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy