Package org.apache.cxf.common.logging
Class LogUtils
- java.lang.Object
-
- org.apache.cxf.common.logging.LogUtils
-
public final class LogUtils extends Object
A container for static utility methods related to logging. By default, CXF logs to java.util.logging. An application can change this. To log to another system, the application must provide an object that extendsAbstractDelegatingLogger
, and advertise that class via one of the following mechanisms:- Create a file, in the classpath, named META-INF/cxf/org.apache.cxf.Logger. This file should contain the fully-qualified name of the class, with no comments, on a single line.
- Call
setLoggerClass(Class)
with a Class> reference to the logger class.
Slf4jLogger
to use slf4j instead of java.util.logging.
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description protected static Logger
createLogger(Class<?> cls, String name, String loggerName)
Create a loggerstatic Logger
getL7dLogger(Class<?> cls)
Get a Logger with the associated default resource bundle for the class.static Logger
getL7dLogger(Class<?> cls, String resourcename)
Get a Logger with an associated resource bundle.static Logger
getL7dLogger(Class<?> cls, String resourcename, String loggerName)
Get a Logger with an associated resource bundle.static Logger
getLogger(Class<?> cls)
Get a Logger with the associated default resource bundle for the class.static Logger
getLogger(Class<?> cls, String resourcename)
Get a Logger with an associated resource bundle.static Logger
getLogger(Class<?> cls, String resourcename, String loggerName)
Get a Logger with an associated resource bundle.static void
log(Logger logger, Level level, String message)
Checks log level and logsstatic void
log(Logger logger, Level level, String message, Object parameter)
Checks log level and logsstatic void
log(Logger logger, Level level, String message, Object[] parameters)
Checks log level and logsstatic void
log(Logger logger, Level level, String message, Throwable throwable)
Checks log level and logsstatic void
log(Logger logger, Level level, String message, Throwable throwable, Object parameter)
Allows both parameter substitution and a typed Throwable to be logged.static void
log(Logger logger, Level level, String message, Throwable throwable, Object... parameters)
Allows both parameter substitution and a typed Throwable to be logged.static void
setLoggerClass(Class<? extends AbstractDelegatingLogger> cls)
Specify a logger class that inherits fromAbstractDelegatingLogger
.
-
-
-
Method Detail
-
setLoggerClass
public static void setLoggerClass(Class<? extends AbstractDelegatingLogger> cls)
Specify a logger class that inherits fromAbstractDelegatingLogger
. Enable users to use their own logger implementation.
-
getLogger
public static Logger getLogger(Class<?> cls)
Get a Logger with the associated default resource bundle for the class.- Parameters:
cls
- the Class to contain the Logger- Returns:
- an appropriate Logger
-
getLogger
public static Logger getLogger(Class<?> cls, String resourcename)
Get a Logger with an associated resource bundle.- Parameters:
cls
- the Class to contain the Loggerresourcename
- the resource name- Returns:
- an appropriate Logger
-
getLogger
public static Logger getLogger(Class<?> cls, String resourcename, String loggerName)
Get a Logger with an associated resource bundle.- Parameters:
cls
- the Class to contain the Logger (to find resources)resourcename
- the resource nameloggerName
- the full name for the logger- Returns:
- an appropriate Logger
-
getL7dLogger
public static Logger getL7dLogger(Class<?> cls)
Get a Logger with the associated default resource bundle for the class.- Parameters:
cls
- the Class to contain the Logger- Returns:
- an appropriate Logger
-
getL7dLogger
public static Logger getL7dLogger(Class<?> cls, String resourcename)
Get a Logger with an associated resource bundle.- Parameters:
cls
- the Class to contain the Loggerresourcename
- the resource name- Returns:
- an appropriate Logger
-
getL7dLogger
public static Logger getL7dLogger(Class<?> cls, String resourcename, String loggerName)
Get a Logger with an associated resource bundle.- Parameters:
cls
- the Class to contain the Logger (to find resources)resourcename
- the resource nameloggerName
- the full name for the logger- Returns:
- an appropriate Logger
-
createLogger
protected static Logger createLogger(Class<?> cls, String name, String loggerName)
Create a logger
-
log
public static void log(Logger logger, Level level, String message, Throwable throwable, Object parameter)
Allows both parameter substitution and a typed Throwable to be logged.- Parameters:
logger
- the Logger the log tolevel
- the severity levelmessage
- the log messagethrowable
- the Throwable to logparameter
- the parameter to substitute into message
-
log
public static void log(Logger logger, Level level, String message, Throwable throwable, Object... parameters)
Allows both parameter substitution and a typed Throwable to be logged.- Parameters:
logger
- the Logger the log tolevel
- the severity levelmessage
- the log messagethrowable
- the Throwable to logparameters
- the parameters to substitute into message
-
log
public static void log(Logger logger, Level level, String message)
Checks log level and logs- Parameters:
logger
- the Logger the log tolevel
- the severity levelmessage
- the log message
-
log
public static void log(Logger logger, Level level, String message, Throwable throwable)
Checks log level and logs- Parameters:
logger
- the Logger the log tolevel
- the severity levelmessage
- the log messagethrowable
- the Throwable to log
-
log
public static void log(Logger logger, Level level, String message, Object parameter)
Checks log level and logs- Parameters:
logger
- the Logger the log tolevel
- the severity levelmessage
- the log messageparameter
- the parameter to substitute into message
-
-