Class ApiLogger

java.lang.Object

java.util.logging.Logger

org.apache.logging.log4j.jul.ApiLogger

Direct Known Subclasses:

CoreLogger

public class ApiLogger
extends 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 final String	FQCN
private final WrappedLogger	logger
private static final Logger	LOGGER
private static final String	MUTATOR_DISABLED

Fields inherited from class Logger

global, GLOBAL_LOGGER_NAME

Constructor Summary

Constructors

Constructor	Description
ApiLogger(ExtendedLogger logger)

Method Summary

Modifier and Type	Method	Description
void	addHandler(Handler handler)
void	config(String msg)
protected void	doSetLevel(Level newLevel)	Provides access to Logger.setLevel(java.util.logging.Level).
void	entering(String sourceClass, String sourceMethod)
void	entering(String sourceClass, String sourceMethod, Object param1)
void	entering(String sourceClass, String sourceMethod, Object[] params)
void	exiting(String sourceClass, String sourceMethod)
void	exiting(String sourceClass, String sourceMethod, Object result)
void	fine(String msg)
void	finer(String msg)
void	finest(String msg)
Level	getLevel()
String	getName()
void	info(String msg)
(package private) boolean	isFiltered(LogRecord logRecord)
boolean	isLoggable(Level level)
void	log(Level level, String msg)
void	log(Level level, String msg, Object param1)
void	log(Level level, String msg, Object[] params)
void	log(Level level, String msg, Throwable thrown)
void	log(LogRecord record)
void	logp(Level level, String sourceClass, String sourceMethod, String msg)
void	logp(Level level, String sourceClass, String sourceMethod, String msg, Object param1)
void	logp(Level level, String sourceClass, String sourceMethod, String msg, Object[] params)
void	logp(Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown)
void	logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg)
void	logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1)
void	logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object[] params)
void	logrb(Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown)
void	removeHandler(Handler handler)
void	setLevel(Level newLevel)
void	setParent(Logger parent)	Unsupported operation.
void	setResourceBundle(ResourceBundle bundle)
void	setUseParentHandlers(boolean useParentHandlers)
void	severe(String msg)
void	throwing(String sourceClass, String sourceMethod, Throwable thrown)
void	warning(String msg)

Methods inherited from class Logger

config, fine, finer, finest, getAnonymousLogger, getAnonymousLogger, getFilter, getGlobal, getHandlers, getLogger, getLogger, getParent, getResourceBundle, getResourceBundleName, getUseParentHandlers, info, log, log, logp, logp, logrb, logrb, logrb, logrb, setFilter, severe, warning

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOGGER

private static final Logger LOGGER

MUTATOR_DISABLED

private static final String MUTATOR_DISABLED

See Also:

• Constant Field Values

logger

private final WrappedLogger logger

FQCN

private static final String FQCN

Constructor Details

ApiLogger

ApiLogger(ExtendedLogger logger)

Method Details

log

public void log(LogRecord record)

Overrides:

log in class Logger

isFiltered

boolean isFiltered(LogRecord logRecord)

isLoggable

public boolean isLoggable(Level level)

Overrides:

isLoggable in class Logger

getName

public String getName()

Overrides:

getName in class Logger

getLevel

public Level getLevel()

Overrides:

getLevel in class Logger

setLevel

public void setLevel(Level newLevel)
              throws SecurityException

Overrides:

setLevel in class Logger

Throws:

SecurityException

doSetLevel

protected void doSetLevel(Level newLevel)
                   throws SecurityException

Provides access to Logger.setLevel(java.util.logging.Level).

This method should be called by all setLevel(Level) implementations to check permissions.

Throws:

SecurityException

See Also:

• Logger.setLevel(java.util.logging.Level)

setUseParentHandlers

public void setUseParentHandlers(boolean useParentHandlers)

Overrides:

setUseParentHandlers in class Logger

addHandler

public void addHandler(Handler handler)
                throws SecurityException

Overrides:

addHandler in class Logger

Throws:

SecurityException

removeHandler

public void removeHandler(Handler handler)
                   throws SecurityException

Overrides:

removeHandler in class Logger

Throws:

SecurityException

setResourceBundle

public void setResourceBundle(ResourceBundle bundle)

Overrides:

setResourceBundle in class Logger

setParent

public void setParent(Logger parent)

Unsupported operation.

Overrides:

setParent in class Logger

Throws:

UnsupportedOperationException - always

log

public void log(Level level,
 String msg)

Overrides:

log in class Logger

log

public void log(Level level,
 String msg,
 Object param1)

Overrides:

log in class Logger

log

public void log(Level level,
 String msg,
 Object[] params)

Overrides:

log in class Logger

log

public void log(Level level,
 String msg,
 Throwable thrown)

Overrides:

log in class Logger

logp

public void logp(Level level,
 String sourceClass,
 String sourceMethod,
 String msg)

Overrides:

logp in class Logger

logp

public void logp(Level level,
 String sourceClass,
 String sourceMethod,
 String msg,
 Object param1)

Overrides:

logp in class Logger

logp

public void logp(Level level,
 String sourceClass,
 String sourceMethod,
 String msg,
 Object[] params)

Overrides:

logp in class Logger

logp

public void logp(Level level,
 String sourceClass,
 String sourceMethod,
 String msg,
 Throwable thrown)

Overrides:

logp in class Logger

logrb

public void logrb(Level level,
 String sourceClass,
 String sourceMethod,
 String bundleName,
 String msg)

Overrides:

logrb in class Logger

logrb

public void logrb(Level level,
 String sourceClass,
 String sourceMethod,
 String bundleName,
 String msg,
 Object param1)

Overrides:

logrb in class Logger

logrb

public void logrb(Level level,
 String sourceClass,
 String sourceMethod,
 String bundleName,
 String msg,
 Object[] params)

Overrides:

logrb in class Logger

logrb

public void logrb(Level level,
 String sourceClass,
 String sourceMethod,
 String bundleName,
 String msg,
 Throwable thrown)

Overrides:

logrb in class Logger

entering

public void entering(String sourceClass,
 String sourceMethod)

Overrides:

entering in class Logger

entering

public void entering(String sourceClass,
 String sourceMethod,
 Object param1)

Overrides:

entering in class Logger

entering

public void entering(String sourceClass,
 String sourceMethod,
 Object[] params)

Overrides:

entering in class Logger

exiting

public void exiting(String sourceClass,
 String sourceMethod)

Overrides:

exiting in class Logger

exiting

public void exiting(String sourceClass,
 String sourceMethod,
 Object result)

Overrides:

exiting in class Logger

throwing

public void throwing(String sourceClass,
 String sourceMethod,
 Throwable thrown)

Overrides:

throwing in class Logger

severe

public void severe(String msg)

Overrides:

severe in class Logger

warning

public void warning(String msg)

Overrides:

warning in class Logger

info

public void info(String msg)

Overrides:

info in class Logger

config

public void config(String msg)

Overrides:

config in class Logger

fine

public void fine(String msg)

Overrides:

fine in class Logger

finer

public void finer(String msg)

Overrides:

finer in class Logger

finest

public void finest(String msg)

Overrides:

finest in class Logger