Java Doc for LoggerAdapter.java in  » GIS » GeoTools-2.4.1 » org » geotools » util » logging » Java Source Code / Java DocumentationJava Source Code and Java Documentation

All LoggerAdapter.log(Level,String) log methods are overriden in order to redirect to one of the above-cited methods. Note that this is the opposite approach than the Java logging framework one, which implemented everything on top of Logger.log(LogRecord) . This adapter is defined in terms of LoggerAdapter.severe(String) severe … LoggerAdapter.finest(String) finest methods instead because external frameworks like Commons-logging don't work with LogRecord , and sometime provides nothing else than convenience methods equivalent to LoggerAdapter.severe(String) severe … LoggerAdapter.finest(String) finest .

Restrictions
Because the configuration is expected to be fully controled by the external logging framework, every configuration methods inherited from Logger are disabled:

• LoggerAdapter.addHandler since the handling is performed by the external framework.
• LoggerAdapter.setUseParentHandlers since this adapter never delegates to the parent handlers. This is consistent with the previous item and avoid mixing loggings from the external framework with Java loggings.
• LoggerAdapter.setParent since this adapter should not inherits any configuration from a parent logger using the Java logging framework.
• LoggerAdapter.setFilter for keeping this LoggerAdapter simple.

Since LoggerAdapter s do not hold any configuration by themself, it is not strictly necessary to . The adapters can be created, garbage-collected and recreated again while preserving their behavior since their configuration is entirely contained in the external logging framework.

Localization
This logger is always created without resource bundles. Localizations must be performed through explicit calls to logrb or LoggerAdapter.log(LogRecord) methods. This is suffisient for GeoTools needs, which performs all localizations through the later. Note that those methods will be slower in this LoggerAdapter than the default Logger because this adapter localizes and formats records immediately instead of letting the performs this work only if needed.

Logging levels
If a log record is not one of the predefined ones, then this class maps to the first level below the specified one. For example if a log record has some level between Level.FINE FINE and Level.FINER FINER , then the LoggerAdapter.finer finer method will be invoked. See LoggerAdapter.isLoggable for implementation tips taking advantage of this rule.
since:
   2.4
version:
   $Id: LoggerAdapter.java 28037 2007-11-24 14:19:24Z aaime $
author:
   Martin Desruisseaux
See Also:   Logging

Implementation tip
Given that Level.intValue for all predefined levels are documented in the Level specification and are multiple of 100, given that integer divisions are rounded toward zero and given rule documented in this class javadoc, then logging levels can be efficiently mapped to predefined levels using switch statements as below.

Implementation tip
Given that Level.intValue for all predefined levels are documented in the Level specification and are multiple of 100, given that integer divisions are rounded toward zero and given rule documented in this class javadoc, then logging levels can be efficiently mapped to predefined levels using switch statements as below. This statement has good chances to be compiled to the tableswitch bytecode rather than lookupswitch (see Compiling Switches in The Java Virtual Machine Specification).

 "fallthrough")
 public boolean isLoggable(Level level) {
 final int n = level.intValue();
 switch (n / 100) {
 default: {
 // MAX_VALUE is a special value for Level.OFF. Otherwise and
 // if positive, fallthrough since we are greater than SEVERE.
 switch (n) {
 case Integer.MIN_VALUE: return true;  // Level.ALL
 case Integer.MAX_VALUE: return false; // Level.OFF
 default: if (n < 0) return false;
 }
 }
 case 10: return isSevereEnabled();
 case  9: return isWarningEnabled();
 case  8: return isInfoEnabled();
 case  7: return isConfigEnabled();
 case  6: // fallthrough
 case  5: return isFineEnabled();
 case  4: return isFinerEnabled();
 case  3: return isFinestEnabled();
 case  2: // fallthrough
 case  1: // fallthrough
 case  0: return false;
 }
 }
 

Note that sourceClass and sourceMethod will be discarted unless the target LoggerAdapter.logp(Level,String,String,String) logp method has been overriden.

Note that sourceClass and sourceMethod will be discarted unless the target LoggerAdapter.logp(Level,String,String,String) logp method has been overriden.