Class ApiLogger

  • Direct Known Subclasses:
    CoreLogger

    public class ApiLogger
    extends java.util.logging.Logger
    Log4j API implementation of the JUL Logger class. Note that this implementation does not use the Handler class. Instead, logging is delegated to the underlying Log4j Logger which may be implemented in one of many different ways. Consult the documentation for your Log4j Provider for more details.

    Note that the methods Logger.getParent() and setLevel(java.util.logging.Level) are not supported by this implementation. If you need support for these methods, then you'll need to use log4j-core. The Logger.getParent() method will not fail (thanks to JUL API limitations), but it won't necessarily be accurate!

    Also note that setParent(java.util.logging.Logger) is explicitly unsupported. Parent loggers are determined using the syntax of the logger name; not through an arbitrary graph of loggers.

    Since:
    2.1
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private static java.lang.String FQCN  
      private WrappedLogger logger  
      • Fields inherited from class java.util.logging.Logger

        global, GLOBAL_LOGGER_NAME
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void config​(java.lang.String msg)  
      protected void doSetLevel​(java.util.logging.Level newLevel)
      Provides access to Logger.setLevel(java.util.logging.Level).
      void entering​(java.lang.String sourceClass, java.lang.String sourceMethod)  
      void entering​(java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.Object param1)  
      void entering​(java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.Object[] params)  
      void exiting​(java.lang.String sourceClass, java.lang.String sourceMethod)  
      void exiting​(java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.Object result)  
      void fine​(java.lang.String msg)  
      void finer​(java.lang.String msg)  
      void finest​(java.lang.String msg)  
      java.lang.String getName()  
      void info​(java.lang.String msg)  
      (package private) boolean isFiltered​(java.util.logging.LogRecord logRecord)  
      boolean isLoggable​(java.util.logging.Level level)  
      void log​(java.util.logging.Level level, java.lang.String msg)  
      void log​(java.util.logging.Level level, java.lang.String msg, java.lang.Object param1)  
      void log​(java.util.logging.Level level, java.lang.String msg, java.lang.Object[] params)  
      void log​(java.util.logging.Level level, java.lang.String msg, java.lang.Throwable thrown)  
      void log​(java.util.logging.LogRecord record)  
      void logp​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String msg)  
      void logp​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String msg, java.lang.Object param1)  
      void logp​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String msg, java.lang.Object[] params)  
      void logp​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String msg, java.lang.Throwable thrown)  
      void logrb​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msg)  
      void logrb​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msg, java.lang.Object param1)  
      void logrb​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msg, java.lang.Object[] params)  
      void logrb​(java.util.logging.Level level, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String bundleName, java.lang.String msg, java.lang.Throwable thrown)  
      void setLevel​(java.util.logging.Level newLevel)  
      void setParent​(java.util.logging.Logger parent)
      Unsupported operation.
      void severe​(java.lang.String msg)  
      void throwing​(java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.Throwable thrown)  
      void warning​(java.lang.String msg)  
      • Methods inherited from class java.util.logging.Logger

        addHandler, config, fine, finer, finest, getAnonymousLogger, getAnonymousLogger, getFilter, getGlobal, getHandlers, getLevel, getLogger, getLogger, getParent, getResourceBundle, getResourceBundleName, getUseParentHandlers, info, log, log, logp, logp, logrb, logrb, logrb, logrb, removeHandler, setFilter, setResourceBundle, setUseParentHandlers, severe, warning
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • FQCN

        private static final java.lang.String FQCN
    • Method Detail

      • log

        public void log​(java.util.logging.LogRecord record)
        Overrides:
        log in class java.util.logging.Logger
      • isFiltered

        boolean isFiltered​(java.util.logging.LogRecord logRecord)
      • isLoggable

        public boolean isLoggable​(java.util.logging.Level level)
        Overrides:
        isLoggable in class java.util.logging.Logger
      • getName

        public java.lang.String getName()
        Overrides:
        getName in class java.util.logging.Logger
      • setLevel

        public void setLevel​(java.util.logging.Level newLevel)
                      throws java.lang.SecurityException
        Overrides:
        setLevel in class java.util.logging.Logger
        Throws:
        java.lang.SecurityException
      • doSetLevel

        protected void doSetLevel​(java.util.logging.Level newLevel)
                           throws java.lang.SecurityException
        Provides access to Logger.setLevel(java.util.logging.Level). This method should only be used by child classes.
        Throws:
        java.lang.SecurityException
        See Also:
        Logger.setLevel(java.util.logging.Level)
      • setParent

        public void setParent​(java.util.logging.Logger parent)
        Unsupported operation.
        Overrides:
        setParent in class java.util.logging.Logger
        Throws:
        java.lang.UnsupportedOperationException - always
      • log

        public void log​(java.util.logging.Level level,
                        java.lang.String msg)
        Overrides:
        log in class java.util.logging.Logger
      • log

        public void log​(java.util.logging.Level level,
                        java.lang.String msg,
                        java.lang.Object param1)
        Overrides:
        log in class java.util.logging.Logger
      • log

        public void log​(java.util.logging.Level level,
                        java.lang.String msg,
                        java.lang.Object[] params)
        Overrides:
        log in class java.util.logging.Logger
      • log

        public void log​(java.util.logging.Level level,
                        java.lang.String msg,
                        java.lang.Throwable thrown)
        Overrides:
        log in class java.util.logging.Logger
      • logp

        public void logp​(java.util.logging.Level level,
                         java.lang.String sourceClass,
                         java.lang.String sourceMethod,
                         java.lang.String msg)
        Overrides:
        logp in class java.util.logging.Logger
      • logp

        public void logp​(java.util.logging.Level level,
                         java.lang.String sourceClass,
                         java.lang.String sourceMethod,
                         java.lang.String msg,
                         java.lang.Object param1)
        Overrides:
        logp in class java.util.logging.Logger
      • logp

        public void logp​(java.util.logging.Level level,
                         java.lang.String sourceClass,
                         java.lang.String sourceMethod,
                         java.lang.String msg,
                         java.lang.Object[] params)
        Overrides:
        logp in class java.util.logging.Logger
      • logp

        public void logp​(java.util.logging.Level level,
                         java.lang.String sourceClass,
                         java.lang.String sourceMethod,
                         java.lang.String msg,
                         java.lang.Throwable thrown)
        Overrides:
        logp in class java.util.logging.Logger
      • logrb

        public void logrb​(java.util.logging.Level level,
                          java.lang.String sourceClass,
                          java.lang.String sourceMethod,
                          java.lang.String bundleName,
                          java.lang.String msg)
        Overrides:
        logrb in class java.util.logging.Logger
      • logrb

        public void logrb​(java.util.logging.Level level,
                          java.lang.String sourceClass,
                          java.lang.String sourceMethod,
                          java.lang.String bundleName,
                          java.lang.String msg,
                          java.lang.Object param1)
        Overrides:
        logrb in class java.util.logging.Logger
      • logrb

        public void logrb​(java.util.logging.Level level,
                          java.lang.String sourceClass,
                          java.lang.String sourceMethod,
                          java.lang.String bundleName,
                          java.lang.String msg,
                          java.lang.Object[] params)
        Overrides:
        logrb in class java.util.logging.Logger
      • logrb

        public void logrb​(java.util.logging.Level level,
                          java.lang.String sourceClass,
                          java.lang.String sourceMethod,
                          java.lang.String bundleName,
                          java.lang.String msg,
                          java.lang.Throwable thrown)
        Overrides:
        logrb in class java.util.logging.Logger
      • entering

        public void entering​(java.lang.String sourceClass,
                             java.lang.String sourceMethod)
        Overrides:
        entering in class java.util.logging.Logger
      • entering

        public void entering​(java.lang.String sourceClass,
                             java.lang.String sourceMethod,
                             java.lang.Object param1)
        Overrides:
        entering in class java.util.logging.Logger
      • entering

        public void entering​(java.lang.String sourceClass,
                             java.lang.String sourceMethod,
                             java.lang.Object[] params)
        Overrides:
        entering in class java.util.logging.Logger
      • exiting

        public void exiting​(java.lang.String sourceClass,
                            java.lang.String sourceMethod)
        Overrides:
        exiting in class java.util.logging.Logger
      • exiting

        public void exiting​(java.lang.String sourceClass,
                            java.lang.String sourceMethod,
                            java.lang.Object result)
        Overrides:
        exiting in class java.util.logging.Logger
      • throwing

        public void throwing​(java.lang.String sourceClass,
                             java.lang.String sourceMethod,
                             java.lang.Throwable thrown)
        Overrides:
        throwing in class java.util.logging.Logger
      • severe

        public void severe​(java.lang.String msg)
        Overrides:
        severe in class java.util.logging.Logger
      • warning

        public void warning​(java.lang.String msg)
        Overrides:
        warning in class java.util.logging.Logger
      • info

        public void info​(java.lang.String msg)
        Overrides:
        info in class java.util.logging.Logger
      • config

        public void config​(java.lang.String msg)
        Overrides:
        config in class java.util.logging.Logger
      • fine

        public void fine​(java.lang.String msg)
        Overrides:
        fine in class java.util.logging.Logger
      • finer

        public void finer​(java.lang.String msg)
        Overrides:
        finer in class java.util.logging.Logger
      • finest

        public void finest​(java.lang.String msg)
        Overrides:
        finest in class java.util.logging.Logger