LogFactory API,
providing just the common Log lookup methods. This is inspired
by the JCL-over-SLF4J bridge and should be source as well as binary
compatible with all common use of the Commons Logging API (in particular:
with LogFactory.getLog(Class/String) field initializers).
This implementation does not support Commons Logging's original provider
detection. It rather only checks for the presence of the Log4j 2.x API
and the SLF4J 1.7 API in the Spring Framework classpath, falling back to
java.util.logging if none of the two is available. In that sense,
it works as a replacement for the Log4j 2 Commons Logging bridge as well as
the JCL-over-SLF4J bridge, both of which become irrelevant for Spring-based
setups as a consequence (with no need for manual excludes of the standard
Commons Logging API jar anymore either). Furthermore, for simple setups
without an external logging provider, Spring does not require any extra jar
on the classpath anymore since this embedded log factory automatically
delegates to java.util.logging in such a scenario.
Note that this Commons Logging variant is only meant to be used for infrastructure logging purposes in the core framework and in extensions. It also serves as a common bridge for third-party libraries using the Commons Logging API, e.g. Apache HttpClient, and HtmlUnit, bringing them into the same consistent arrangement without any extra bridge jars.
For logging need in application code, prefer direct use of Log4j 2.x
or SLF4J or java.util.logging. Simply put Log4j 2.x or Logback
(or another SLF4J provider) onto your classpath, without any extra bridges,
and let the framework auto-adapt to your choice.
spring-jcl variant)
| Access | Constructor and Description |
|---|---|
| public |
| Modifier and Type | Method and Description |
|---|---|
| public abstract Object | |
| public abstract String[] | |
| public static LogFactory | getFactory()
Deprecated
in favor of
getLog(Class)/getLog(String)
This method only exists for compatibility with unusual Commons Logging API
usage like e.g. |
| public Log | getInstance(Class<?>
containing Class from which a log name will be derived clazz)
Deprecated
in favor of
getLog(Class)
Convenience method to return a named logger. |
| public Log | getInstance(String
logical name of the name)Log instance to be returned
Deprecated
in favor of
getLog(String)
Convenience method to return a named logger. |
| public static Log | |
| public static Log | |
| public static String | |
| public abstract void | |
| public static void | |
| public static void | |
| public abstract void | |
| public abstract void |
| LogFactory | back to summary |
|---|---|
| public LogFactory() | |
| getAttribute | back to summary |
|---|---|
| public abstract Object getAttribute(String name)
Deprecated
| |
| getAttributeNames | back to summary |
|---|---|
| public abstract String[] getAttributeNames()
Deprecated
| |
| getFactory | back to summary |
|---|---|
| public static LogFactory getFactory()
Deprecated in favor of This method only exists for compatibility with unusual Commons Logging API
usage like e.g.
| |
| getInstance | back to summary |
|---|---|
| public Log getInstance(Class<?> clazz)
Deprecated in favor of Convenience method to return a named logger. This variant just dispatches straight to
| |
| getInstance | back to summary |
|---|---|
| public Log getInstance(String name)
Deprecated in favor of Convenience method to return a named logger. This variant just dispatches straight to
| |
| getLog | back to summary |
|---|---|
| public static Log getLog(Class<?> clazz) Convenience method to return a named logger.
| |
| getLog | back to summary |
|---|---|
| public static Log getLog(String name) Convenience method to return a named logger.
| |
| objectId | back to summary |
|---|---|
| public static String objectId(Object o)
Deprecated
| |
| release | back to summary |
|---|---|
| public abstract void release()
Deprecated
| |
| release | back to summary |
|---|---|
| public static void release(ClassLoader classLoader)
Deprecated
| |
| releaseAll | back to summary |
|---|---|
| public static void releaseAll()
Deprecated
| |
| removeAttribute | back to summary |
|---|---|
| public abstract void removeAttribute(String name)
Deprecated
| |
| setAttribute | back to summary |
|---|---|
| public abstract void setAttribute(String name, Object value)
Deprecated
| |