mirror of https://github.com/qos-ch/slf4j
javadoc fixes
This commit is contained in:
parent
e52fb5ae15
commit
abad55509a
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>integration</artifactId>
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
|
|
|
|||
|
|
@ -20,7 +20,7 @@ package org.apache.commons.logging;
|
|||
* <p>A simple logging interface abstracting logging APIs. In order to be
|
||||
* instantiated successfully by {@link LogFactory}, classes that implement
|
||||
* this interface must have a constructor that takes a single String
|
||||
* parameter representing the "name" of this Log.</p>
|
||||
* parameter representing the "name" of this Log.
|
||||
*
|
||||
* <p> The six logging levels used by <code>Log</code> are (in order):
|
||||
* <ol>
|
||||
|
|
@ -34,27 +34,27 @@ package org.apache.commons.logging;
|
|||
* The mapping of these log levels to the concepts used by the underlying
|
||||
* logging system is implementation dependent.
|
||||
* The implementation should ensure, though, that this ordering behaves
|
||||
* as expected.</p>
|
||||
* as expected.
|
||||
*
|
||||
* <p>Performance is often a logging concern.
|
||||
* By examining the appropriate property,
|
||||
* a component can avoid expensive operations (producing information
|
||||
* to be logged).</p>
|
||||
* to be logged).
|
||||
*
|
||||
* <p> For example,
|
||||
* <code><pre>
|
||||
* <pre>
|
||||
* if (log.isDebugEnabled()) {
|
||||
* ... do something expensive ...
|
||||
* log.debug(theResult);
|
||||
* }
|
||||
* </pre></code>
|
||||
* </p>
|
||||
* </pre>
|
||||
*
|
||||
*
|
||||
* <p>Configuration of the underlying logging system will generally be done
|
||||
* external to the Logging APIs, through whatever mechanism is supported by
|
||||
* that system.</p>
|
||||
* that system.
|
||||
*
|
||||
* <p style="color: #E40; font-weight: bold;">Please note that this interface is identical to that found in JCL 1.1.1.</p>
|
||||
* <p style="color: #E40; font-weight: bold;">Please note that this interface is identical to that found in JCL 1.1.1.
|
||||
*
|
||||
* @author <a href="mailto:sanders@apache.org">Scott Sanders</a>
|
||||
* @author Rod Waldhoff
|
||||
|
|
@ -65,74 +65,74 @@ public interface Log {
|
|||
// ----------------------------------------------------- Logging Properties
|
||||
|
||||
/**
|
||||
* <p> Is debug logging currently enabled? </p>
|
||||
* <p> Is debug logging currently enabled?
|
||||
*
|
||||
* <p> Call this method to prevent having to perform expensive operations
|
||||
* (for example, <code>String</code> concatenation)
|
||||
* when the log level is more than debug. </p>
|
||||
* when the log level is more than debug.
|
||||
*/
|
||||
public boolean isDebugEnabled();
|
||||
|
||||
/**
|
||||
* <p> Is error logging currently enabled? </p>
|
||||
* <p> Is error logging currently enabled?
|
||||
*
|
||||
* <p> Call this method to prevent having to perform expensive operations
|
||||
* (for example, <code>String</code> concatenation)
|
||||
* when the log level is more than error. </p>
|
||||
* when the log level is more than error.
|
||||
*/
|
||||
public boolean isErrorEnabled();
|
||||
|
||||
/**
|
||||
* <p> Is fatal logging currently enabled? </p>
|
||||
* <p> Is fatal logging currently enabled?
|
||||
*
|
||||
* <p> Call this method to prevent having to perform expensive operations
|
||||
* (for example, <code>String</code> concatenation)
|
||||
* when the log level is more than fatal. </p>
|
||||
* when the log level is more than fatal.
|
||||
*/
|
||||
public boolean isFatalEnabled();
|
||||
|
||||
/**
|
||||
* <p> Is info logging currently enabled? </p>
|
||||
* <p> Is info logging currently enabled?
|
||||
*
|
||||
* <p> Call this method to prevent having to perform expensive operations
|
||||
* (for example, <code>String</code> concatenation)
|
||||
* when the log level is more than info. </p>
|
||||
* when the log level is more than info.
|
||||
*
|
||||
* @return true if info enabled, false otherwise
|
||||
*/
|
||||
public boolean isInfoEnabled();
|
||||
|
||||
/**
|
||||
* <p> Is trace logging currently enabled? </p>
|
||||
* <p> Is trace logging currently enabled?
|
||||
*
|
||||
* <p> Call this method to prevent having to perform expensive operations
|
||||
* (for example, <code>String</code> concatenation)
|
||||
* when the log level is more than trace. </p>
|
||||
* when the log level is more than trace.
|
||||
*
|
||||
* @return true if trace enabled, false otherwise
|
||||
*/
|
||||
public boolean isTraceEnabled();
|
||||
|
||||
/**
|
||||
* <p> Is warn logging currently enabled? </p>
|
||||
* <p> Is warn logging currently enabled?
|
||||
*
|
||||
* <p> Call this method to prevent having to perform expensive operations
|
||||
* (for example, <code>String</code> concatenation)
|
||||
* when the log level is more than warn. </p>
|
||||
* when the log level is more than warn.
|
||||
*/
|
||||
public boolean isWarnEnabled();
|
||||
|
||||
// -------------------------------------------------------- Logging Methods
|
||||
|
||||
/**
|
||||
* <p> Log a message with trace log level. </p>
|
||||
* <p> Log a message with trace log level.
|
||||
*
|
||||
* @param message log this message
|
||||
*/
|
||||
public void trace(Object message);
|
||||
|
||||
/**
|
||||
* <p> Log an error with trace log level. </p>
|
||||
* <p> Log an error with trace log level.
|
||||
*
|
||||
* @param message log this message
|
||||
* @param t log this cause
|
||||
|
|
@ -140,14 +140,14 @@ public interface Log {
|
|||
public void trace(Object message, Throwable t);
|
||||
|
||||
/**
|
||||
* <p> Log a message with debug log level. </p>
|
||||
* <p> Log a message with debug log level.
|
||||
*
|
||||
* @param message log this message
|
||||
*/
|
||||
public void debug(Object message);
|
||||
|
||||
/**
|
||||
* <p> Log an error with debug log level. </p>
|
||||
* <p> Log an error with debug log level.
|
||||
*
|
||||
* @param message log this message
|
||||
* @param t log this cause
|
||||
|
|
@ -155,14 +155,14 @@ public interface Log {
|
|||
public void debug(Object message, Throwable t);
|
||||
|
||||
/**
|
||||
* <p> Log a message with info log level. </p>
|
||||
* <p> Log a message with info log level.
|
||||
*
|
||||
* @param message log this message
|
||||
*/
|
||||
public void info(Object message);
|
||||
|
||||
/**
|
||||
* <p> Log an error with info log level. </p>
|
||||
* <p> Log an error with info log level.
|
||||
*
|
||||
* @param message log this message
|
||||
* @param t log this cause
|
||||
|
|
@ -170,14 +170,14 @@ public interface Log {
|
|||
public void info(Object message, Throwable t);
|
||||
|
||||
/**
|
||||
* <p> Log a message with warn log level. </p>
|
||||
* <p> Log a message with warn log level.
|
||||
*
|
||||
* @param message log this message
|
||||
*/
|
||||
public void warn(Object message);
|
||||
|
||||
/**
|
||||
* <p> Log an error with warn log level. </p>
|
||||
* <p> Log an error with warn log level.
|
||||
*
|
||||
* @param message log this message
|
||||
* @param t log this cause
|
||||
|
|
@ -185,14 +185,14 @@ public interface Log {
|
|||
public void warn(Object message, Throwable t);
|
||||
|
||||
/**
|
||||
* <p> Log a message with error log level. </p>
|
||||
* <p> Log a message with error log level.
|
||||
*
|
||||
* @param message log this message
|
||||
*/
|
||||
public void error(Object message);
|
||||
|
||||
/**
|
||||
* <p> Log an error with error log level. </p>
|
||||
* <p> Log an error with error log level.
|
||||
*
|
||||
* @param message log this message
|
||||
* @param t log this cause
|
||||
|
|
@ -200,14 +200,14 @@ public interface Log {
|
|||
public void error(Object message, Throwable t);
|
||||
|
||||
/**
|
||||
* <p> Log a message with fatal log level. </p>
|
||||
* <p> Log a message with fatal log level.
|
||||
*
|
||||
* @param message log this message
|
||||
*/
|
||||
public void fatal(Object message);
|
||||
|
||||
/**
|
||||
* <p> Log an error with fatal log level. </p>
|
||||
* <p> Log an error with fatal log level.
|
||||
*
|
||||
* @param message log this message
|
||||
* @param t log this cause
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ package org.apache.commons.logging;
|
|||
* An exception that is thrown only if a suitable <code>LogFactory</code> or
|
||||
* <code>Log</code> instance cannot be created by the corresponding factory
|
||||
* methods.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* In this version of JCL, this exception will never be thrown in practice.
|
||||
|
|
|
|||
|
|
@ -25,7 +25,7 @@ import org.apache.commons.logging.impl.SLF4JLogFactory;
|
|||
* Factory for creating {@link Log} instances, which always delegates to an
|
||||
* instance of {@link SLF4JLogFactory}.
|
||||
*
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @author Craig R. McClanahan
|
||||
* @author Costin Manolache
|
||||
|
|
@ -170,7 +170,7 @@ public abstract class LogFactory {
|
|||
* <p>
|
||||
* Construct (if necessary) and return a <code>Log</code> instance, using
|
||||
* the factory's current set of configuration attributes.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* <strong>NOTE </strong>- Depending upon the implementation of the
|
||||
|
|
@ -178,7 +178,7 @@ public abstract class LogFactory {
|
|||
* you are returned may or may not be local to the current application, and
|
||||
* may or may not be returned again on a subsequent call with the same name
|
||||
* argument.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param name
|
||||
* Logical name of the <code>Log</code> instance to be
|
||||
|
|
@ -229,7 +229,7 @@ public abstract class LogFactory {
|
|||
* Construct (if necessary) and return a <code>LogFactory</code> instance,
|
||||
* using the following ordered lookup procedure to determine the name of the
|
||||
* implementation class to be loaded.
|
||||
* </p>
|
||||
*
|
||||
* <ul>
|
||||
* <li>The <code>org.apache.commons.logging.LogFactory</code> system
|
||||
* property.</li>
|
||||
|
|
@ -248,7 +248,7 @@ public abstract class LogFactory {
|
|||
* <code>LogFactory</code> implementation class is utilized, all of the
|
||||
* properties defined in this file will be set as configuration attributes on
|
||||
* the corresponding <code>LogFactory</code> instance.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @exception LogConfigurationException
|
||||
* if the implementation class is not available or cannot
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ import org.apache.commons.logging.Log;
|
|||
* <p>
|
||||
* Trivial implementation of Log that throws away all messages. No configurable
|
||||
* system properties are supported.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @author <a href="mailto:sanders@apache.org">Scott Sanders</a>
|
||||
* @author Rod Waldhoff
|
||||
|
|
|
|||
|
|
@ -42,7 +42,7 @@ import java.util.concurrent.ConcurrentMap;
|
|||
*
|
||||
* <p>
|
||||
* This implementation ignores any configured attributes.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @author Rod Waldhoff
|
||||
* @author Craig R. McClanahan
|
||||
|
|
@ -136,7 +136,7 @@ public class SLF4JLogFactory extends LogFactory {
|
|||
* <p>
|
||||
* Construct (if necessary) and return a <code>Log</code> instance, using
|
||||
* the factory's current set of configuration attributes.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param name
|
||||
* Logical name of the <code>Log</code> instance to be returned
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ import org.apache.commons.logging.LogConfigurationException;
|
|||
* Simple implementation of Log that sends all enabled log messages, for all
|
||||
* defined loggers, to System.err. The following system properties are supported
|
||||
* to configure the behavior of this logger:
|
||||
* </p>
|
||||
*
|
||||
* <ul>
|
||||
* <li><code>org.apache.commons.logging.simplelog.defaultlog</code> - Default
|
||||
* logging detail level for all instances of SimpleLog. Must be one of ("trace",
|
||||
|
|
@ -67,7 +67,7 @@ import org.apache.commons.logging.LogConfigurationException;
|
|||
* this implementation also checks for a class loader resource named
|
||||
* <code>"simplelog.properties"</code>, and includes any matching definitions
|
||||
* from this resource (if it exists).
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @author <a href="mailto:sanders@apache.org">Scott Sanders</a>
|
||||
* @author Rod Waldhoff
|
||||
|
|
@ -248,7 +248,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Set logging level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param currentLogLevel
|
||||
* new logging level
|
||||
|
|
@ -262,7 +262,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Get logging level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public int getLevel() {
|
||||
|
||||
|
|
@ -275,7 +275,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
* <p>
|
||||
* Do the actual logging. This method assembles the message and then calls
|
||||
* <code>write()</code> to cause it to be written.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param type
|
||||
* One of the LOG_LEVEL_XXX constants defining the log level
|
||||
|
|
@ -354,7 +354,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
* Write the content of the message accumulated in the specified
|
||||
* <code>StringBuffer</code> to the appropriate output destination. The
|
||||
* default implementation writes to <code>System.err</code>.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param buffer
|
||||
* A <code>StringBuffer</code> containing the accumulated text to be
|
||||
|
|
@ -383,7 +383,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log a message with debug log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void debug(Object message) {
|
||||
|
||||
|
|
@ -395,7 +395,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log an error with debug log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void debug(Object message, Throwable t) {
|
||||
|
||||
|
|
@ -407,7 +407,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log a message with trace log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void trace(Object message) {
|
||||
|
||||
|
|
@ -419,7 +419,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log an error with trace log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void trace(Object message, Throwable t) {
|
||||
|
||||
|
|
@ -431,7 +431,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log a message with info log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void info(Object message) {
|
||||
|
||||
|
|
@ -443,7 +443,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log an error with info log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void info(Object message, Throwable t) {
|
||||
|
||||
|
|
@ -455,7 +455,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log a message with warn log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void warn(Object message) {
|
||||
|
||||
|
|
@ -467,7 +467,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log an error with warn log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void warn(Object message, Throwable t) {
|
||||
|
||||
|
|
@ -479,7 +479,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log a message with error log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void error(Object message) {
|
||||
|
||||
|
|
@ -491,7 +491,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log an error with error log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void error(Object message, Throwable t) {
|
||||
|
||||
|
|
@ -503,7 +503,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log a message with fatal log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void fatal(Object message) {
|
||||
|
||||
|
|
@ -515,7 +515,7 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Log an error with fatal log level.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final void fatal(Object message, Throwable t) {
|
||||
|
||||
|
|
@ -527,12 +527,12 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Are debug messages currently enabled?
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* This allows expensive operations such as <code>String</code> concatenation
|
||||
* to be avoided when the message will be ignored by the logger.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final boolean isDebugEnabled() {
|
||||
|
||||
|
|
@ -542,12 +542,12 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Are error messages currently enabled?
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* This allows expensive operations such as <code>String</code> concatenation
|
||||
* to be avoided when the message will be ignored by the logger.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final boolean isErrorEnabled() {
|
||||
|
||||
|
|
@ -557,12 +557,12 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Are fatal messages currently enabled?
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* This allows expensive operations such as <code>String</code> concatenation
|
||||
* to be avoided when the message will be ignored by the logger.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final boolean isFatalEnabled() {
|
||||
|
||||
|
|
@ -572,12 +572,12 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Are info messages currently enabled?
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* This allows expensive operations such as <code>String</code> concatenation
|
||||
* to be avoided when the message will be ignored by the logger.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final boolean isInfoEnabled() {
|
||||
|
||||
|
|
@ -587,12 +587,12 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Are trace messages currently enabled?
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* This allows expensive operations such as <code>String</code> concatenation
|
||||
* to be avoided when the message will be ignored by the logger.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final boolean isTraceEnabled() {
|
||||
|
||||
|
|
@ -602,12 +602,12 @@ public class SimpleLog implements Log, Serializable {
|
|||
/**
|
||||
* <p>
|
||||
* Are warn messages currently enabled?
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* This allows expensive operations such as <code>String</code> concatenation
|
||||
* to be avoided when the message will be ignored by the logger.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public final boolean isWarnEnabled() {
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>jul-to-slf4j</artifactId>
|
||||
|
|
|
|||
|
|
@ -39,12 +39,12 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
// Based on http://jira.qos.ch/browse/SLF4J-30
|
||||
|
||||
/**
|
||||
* <p>Bridge/route all JUL log records to the SLF4J API.</p>
|
||||
* <p>Bridge/route all JUL log records to the SLF4J API.
|
||||
* <p>Essentially, the idea is to install on the root logger an instance of
|
||||
* <code>SLF4JBridgeHandler</code> as the sole JUL handler in the system. Subsequently, the
|
||||
* SLF4JBridgeHandler instance will redirect all JUL log records are redirected
|
||||
* to the SLF4J API based on the following mapping of levels:
|
||||
* </p>
|
||||
*
|
||||
* <pre>
|
||||
* FINEST -> TRACE
|
||||
* FINER -> DEBUG
|
||||
|
|
@ -52,7 +52,7 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* INFO -> INFO
|
||||
* WARNING -> WARN
|
||||
* SEVERE -> ERROR</pre>
|
||||
* <p><b>Programmatic installation:</b></p>
|
||||
* <p><b>Programmatic installation:</b>
|
||||
* <pre>
|
||||
* // Optionally remove existing handlers attached to j.u.l root logger
|
||||
* SLF4JBridgeHandler.removeHandlersForRootLogger(); // (since SLF4J 1.6.5)
|
||||
|
|
@ -60,12 +60,12 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* // add SLF4JBridgeHandler to j.u.l's root logger, should be done once during
|
||||
* // the initialization phase of your application
|
||||
* SLF4JBridgeHandler.install();</pre>
|
||||
* <p><b>Installation via <em>logging.properties</em> configuration file:</b></p>
|
||||
* <p><b>Installation via <em>logging.properties</em> configuration file:</b>
|
||||
* <pre>
|
||||
* // register SLF4JBridgeHandler as handler for the j.u.l. root logger
|
||||
* handlers = org.slf4j.bridge.SLF4JBridgeHandler</pre>
|
||||
* <p>Once SLF4JBridgeHandler is installed, logging by j.u.l. loggers will be directed to
|
||||
* SLF4J. Example: </p>
|
||||
* SLF4J. Example:
|
||||
* <pre>
|
||||
* import java.util.logging.Logger;
|
||||
* ...
|
||||
|
|
@ -81,10 +81,10 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* statements (20% overall increase).</b> Please note that as of logback-version 0.9.25,
|
||||
* it is possible to completely eliminate the 60 fold translation overhead for disabled
|
||||
* log statements with the help of <a href="http://logback.qos.ch/manual/configuration.html#LevelChangePropagator">LevelChangePropagator</a>.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>If you are concerned about application performance, then use of <code>SLF4JBridgeHandler</code>
|
||||
* is appropriate only if any one the following two conditions is true:</p>
|
||||
* is appropriate only if any one the following two conditions is true:
|
||||
* <ol>
|
||||
* <li>few j.u.l. logging statements are in play</li>
|
||||
* <li>LevelChangePropagator has been installed</li>
|
||||
|
|
@ -118,9 +118,8 @@ public class SLF4JBridgeHandler extends Handler {
|
|||
|
||||
/**
|
||||
* Adds a SLF4JBridgeHandler instance to jul's root logger.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* This handler will redirect j.u.l. logging to SLF4J. However, only logs enabled
|
||||
*
|
||||
* <p>This handler will redirect j.u.l. logging to SLF4J. However, only logs enabled
|
||||
* in j.u.l. will be redirected. For example, if a log statement invoking a
|
||||
* j.u.l. logger is disabled, then the corresponding non-event will <em>not</em>
|
||||
* reach SLF4JBridgeHandler and cannot be redirected.
|
||||
|
|
@ -283,10 +282,10 @@ public class SLF4JBridgeHandler extends Handler {
|
|||
|
||||
/**
|
||||
* Publish a LogRecord.
|
||||
* <p/>
|
||||
* <p>
|
||||
* The logging request was made initially to a Logger object, which
|
||||
* initialized the LogRecord and forwarded it here.
|
||||
* <p/>
|
||||
* <p>
|
||||
* This handler ignores the Level attached to the LogRecord, as SLF4J cares
|
||||
* about discarding log statements.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -54,7 +54,7 @@ public interface Appender {
|
|||
/**
|
||||
* Release any resources allocated within the appender such as file
|
||||
* handles, network connections, etc.
|
||||
* <p/>
|
||||
*
|
||||
* <p>It is a programming error to append to a closed appender.
|
||||
*
|
||||
* @since 0.8.4
|
||||
|
|
@ -119,7 +119,7 @@ public interface Appender {
|
|||
* a layout is not required, then layout configuration will be
|
||||
* skipped even if there is available layout configuration
|
||||
* information at the disposal of the configurator.
|
||||
* <p/>
|
||||
*
|
||||
* <p>In the rather exceptional case, where the appender
|
||||
* implementation admits a layout but can also work without it, then
|
||||
* the appender should return <code>true</code>.
|
||||
|
|
|
|||
|
|
@ -29,7 +29,7 @@ import java.util.Enumeration;
|
|||
* This class is a minimal implementation of the original
|
||||
* <code>org.apache.log4j.Category</code> class (as found in log4j 1.2) by
|
||||
* delegation of all calls to a {@link org.slf4j.Logger} instance.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* Log4j's <code>trace</code>, <code>debug()</code>, <code>info()</code>,
|
||||
|
|
|
|||
|
|
@ -20,7 +20,7 @@ package org.apache.log4j;
|
|||
/**
|
||||
* This class is a minimal implementation of the original Log4J class.
|
||||
*
|
||||
* @author Christian Trutz <christian.trutz@belaso.de>
|
||||
* @author Christian Trutz
|
||||
* */
|
||||
public class Layout {
|
||||
|
||||
|
|
|
|||
|
|
@ -22,12 +22,11 @@ import java.util.Enumeration;
|
|||
import java.util.Vector;
|
||||
|
||||
/**
|
||||
* <p/>
|
||||
* <p>
|
||||
* This class is a minimal implementation of the original
|
||||
* <code>org.apache.log4j.LogManager</code> class (as found in log4j 1.2)
|
||||
* delegating all calls to SLF4J.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* <p>
|
||||
* This implementation does <b>NOT</b> implement the setRepositorySelector(),
|
||||
* getLoggerRepository(), exists(), getCurrentLoggers(), shutdown() and
|
||||
* resetConfiguration() methods which do not have SLF4J equivalents.
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* This class is a minimal implementation of the original
|
||||
* <code>org.apache.log4j.Logger</code> class (as found in log4j 1.2)
|
||||
* delegating all calls to a {@link org.slf4j.Logger} instance.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @author Ceki Gülcü
|
||||
* */
|
||||
|
|
|
|||
|
|
@ -21,8 +21,8 @@ package org.apache.log4j;
|
|||
// Contributors: Kitching Simon <Simon.Kitching@OOOrange.ch>
|
||||
|
||||
/**
|
||||
<font color="#AA4444">Refrain from using this class directly, use
|
||||
the {@link Level} class instead</font>.
|
||||
<b>Refrain from using this class directly, use
|
||||
the {@link Level} class instead</b>.
|
||||
|
||||
@author Ceki Gülcü */
|
||||
public class Priority {
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>osgi-over-slf4j</artifactId>
|
||||
|
|
|
|||
23
pom.xml
23
pom.xml
|
|
@ -6,7 +6,7 @@
|
|||
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
|
||||
<packaging>pom</packaging>
|
||||
<name>SLF4J</name>
|
||||
|
|
@ -47,9 +47,9 @@
|
|||
<log4j.version>1.2.17</log4j.version>
|
||||
<logback.version>1.0.13</logback.version>
|
||||
<junit.version>4.12</junit.version>
|
||||
<maven-site-plugin.version>3.6</maven-site-plugin.version>
|
||||
<maven-site-plugin.version>3.7.1</maven-site-plugin.version>
|
||||
<compiler-plugin.version>3.8.0</compiler-plugin.version>
|
||||
<javadoc.plugin.version>2.10.4</javadoc.plugin.version>
|
||||
<maven-javadoc-plugin.version>3.1.0</maven-javadoc-plugin.version>
|
||||
<maven-source-plugin.version>3.0.1</maven-source-plugin.version>
|
||||
</properties>
|
||||
|
||||
|
|
@ -218,7 +218,7 @@
|
|||
<artifactId>maven-surefire-plugin</artifactId>
|
||||
<version>2.19.1</version>
|
||||
<configuration>
|
||||
<forkCount>2C</forkCount>
|
||||
<forkCount>1</forkCount>
|
||||
<reuseForks>false</reuseForks>
|
||||
<reportFormat>plain</reportFormat>
|
||||
<trimStackTrace>false</trimStackTrace>
|
||||
|
|
@ -272,7 +272,17 @@
|
|||
</executions>
|
||||
</plugin>
|
||||
|
||||
|
||||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-site-plugin</artifactId>
|
||||
<version>${maven-site-plugin.version}</version>
|
||||
</plugin>
|
||||
|
||||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-project-info-reports-plugin</artifactId>
|
||||
<version>3.0.0</version>
|
||||
</plugin>
|
||||
</plugins>
|
||||
|
||||
</build>
|
||||
|
|
@ -292,11 +302,12 @@
|
|||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-javadoc-plugin</artifactId>
|
||||
<version>${javadoc-plugin.version}</version>
|
||||
<version>${maven-javadoc-plugin.version}</version>
|
||||
<configuration>
|
||||
<linkJavadoc>true</linkJavadoc>
|
||||
<linksource>true</linksource>
|
||||
<aggregate>true</aggregate>
|
||||
<additionalparam>-Xdoclint:none</additionalparam>
|
||||
<excludePackageNames>org.slf4j.migrator:org.slf4j.migrator.*</excludePackageNames>
|
||||
<sourceFileExcludes>
|
||||
<sourceFileExclude>**/module-info.java</sourceFileExclude>
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-api</artifactId>
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ import org.slf4j.spi.NOPLoggingEventBuilder;
|
|||
* The org.slf4j.Logger interface is the main user entry point of SLF4J API.
|
||||
* It is expected that logging takes place through concrete implementations
|
||||
* of this interface.
|
||||
* <p/>
|
||||
*
|
||||
* <h3>Typical usage pattern:</h3>
|
||||
* <pre>
|
||||
* import org.slf4j.Logger;
|
||||
|
|
@ -55,7 +55,7 @@ import org.slf4j.spi.NOPLoggingEventBuilder;
|
|||
* oldT = t;
|
||||
* t = temperature;
|
||||
* <span style="color:green">logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT);</span>
|
||||
* if(temperature.intValue() > 50) {
|
||||
* if(temperature.intValue() > 50) {
|
||||
* <span style="color:green">logger.info("Temperature has risen above 50 degrees.");</span>
|
||||
* }
|
||||
* }
|
||||
|
|
@ -67,7 +67,7 @@ import org.slf4j.spi.NOPLoggingEventBuilder;
|
|||
* <a href="../../../faq.html#paramException">presence of an exception/throwable</a>.
|
||||
*
|
||||
* <p>Once you are comfortable using loggers, i.e. instances of this interface, consider using
|
||||
* <a href="MDC.html">MDC</a> as well as <a href="Marker.html">Markers</a>.</p>
|
||||
* <a href="MDC.html">MDC</a> as well as <a href="Marker.html">Markers</a>.
|
||||
*
|
||||
* @author Ceki Gülcü
|
||||
*/
|
||||
|
|
@ -106,9 +106,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the TRACE level according to the specified format
|
||||
* and argument.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the TRACE level. </p>
|
||||
* is disabled for the TRACE level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg the argument
|
||||
|
|
@ -119,9 +119,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the TRACE level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the TRACE level. </p>
|
||||
* is disabled for the TRACE level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg1 the first argument
|
||||
|
|
@ -133,12 +133,12 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the TRACE level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous string concatenation when the logger
|
||||
* is disabled for the TRACE level. However, this variant incurs the hidden
|
||||
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
|
||||
* even if this logger is disabled for TRACE. The variants taking {@link #trace(String, Object) one} and
|
||||
* {@link #trace(String, Object, Object) two} arguments exist solely in order to avoid this hidden cost.</p>
|
||||
* {@link #trace(String, Object, Object) two} arguments exist solely in order to avoid this hidden cost.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arguments a list of 3 or more arguments
|
||||
|
|
@ -255,9 +255,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the DEBUG level according to the specified format
|
||||
* and argument.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the DEBUG level. </p>
|
||||
* is disabled for the DEBUG level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg the argument
|
||||
|
|
@ -267,9 +267,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the DEBUG level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the DEBUG level. </p>
|
||||
* is disabled for the DEBUG level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg1 the first argument
|
||||
|
|
@ -280,13 +280,13 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the DEBUG level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous string concatenation when the logger
|
||||
* is disabled for the DEBUG level. However, this variant incurs the hidden
|
||||
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
|
||||
* even if this logger is disabled for DEBUG. The variants taking
|
||||
* {@link #debug(String, Object) one} and {@link #debug(String, Object, Object) two}
|
||||
* arguments exist solely in order to avoid this hidden cost.</p>
|
||||
* arguments exist solely in order to avoid this hidden cost.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arguments a list of 3 or more arguments
|
||||
|
|
@ -395,9 +395,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the INFO level according to the specified format
|
||||
* and argument.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the INFO level. </p>
|
||||
* is disabled for the INFO level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg the argument
|
||||
|
|
@ -407,9 +407,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the INFO level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the INFO level. </p>
|
||||
* is disabled for the INFO level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg1 the first argument
|
||||
|
|
@ -420,13 +420,13 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the INFO level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous string concatenation when the logger
|
||||
* is disabled for the INFO level. However, this variant incurs the hidden
|
||||
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
|
||||
* even if this logger is disabled for INFO. The variants taking
|
||||
* {@link #info(String, Object) one} and {@link #info(String, Object, Object) two}
|
||||
* arguments exist solely in order to avoid this hidden cost.</p>
|
||||
* arguments exist solely in order to avoid this hidden cost.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arguments a list of 3 or more arguments
|
||||
|
|
@ -534,9 +534,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the WARN level according to the specified format
|
||||
* and argument.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the WARN level. </p>
|
||||
* is disabled for the WARN level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg the argument
|
||||
|
|
@ -546,13 +546,13 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the WARN level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous string concatenation when the logger
|
||||
* is disabled for the WARN level. However, this variant incurs the hidden
|
||||
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
|
||||
* even if this logger is disabled for WARN. The variants taking
|
||||
* {@link #warn(String, Object) one} and {@link #warn(String, Object, Object) two}
|
||||
* arguments exist solely in order to avoid this hidden cost.</p>
|
||||
* arguments exist solely in order to avoid this hidden cost.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arguments a list of 3 or more arguments
|
||||
|
|
@ -562,9 +562,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the WARN level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the WARN level. </p>
|
||||
* is disabled for the WARN level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg1 the first argument
|
||||
|
|
@ -675,9 +675,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the ERROR level according to the specified format
|
||||
* and argument.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the ERROR level. </p>
|
||||
* is disabled for the ERROR level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg the argument
|
||||
|
|
@ -687,9 +687,9 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the ERROR level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous object creation when the logger
|
||||
* is disabled for the ERROR level. </p>
|
||||
* is disabled for the ERROR level.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arg1 the first argument
|
||||
|
|
@ -700,13 +700,13 @@ public interface Logger {
|
|||
/**
|
||||
* Log a message at the ERROR level according to the specified format
|
||||
* and arguments.
|
||||
* <p/>
|
||||
*
|
||||
* <p>This form avoids superfluous string concatenation when the logger
|
||||
* is disabled for the ERROR level. However, this variant incurs the hidden
|
||||
* (and relatively small) cost of creating an <code>Object[]</code> before invoking the method,
|
||||
* even if this logger is disabled for ERROR. The variants taking
|
||||
* {@link #error(String, Object) one} and {@link #error(String, Object, Object) two}
|
||||
* arguments exist solely in order to avoid this hidden cost.</p>
|
||||
* arguments exist solely in order to avoid this hidden cost.
|
||||
*
|
||||
* @param format the format string
|
||||
* @param arguments a list of 3 or more arguments
|
||||
|
|
|
|||
|
|
@ -46,17 +46,15 @@ import org.slf4j.spi.SLF4JServiceProvider;
|
|||
/**
|
||||
* The <code>LoggerFactory</code> is a utility class producing Loggers for
|
||||
* various logging APIs, most notably for log4j, logback and JDK 1.4 logging.
|
||||
* Other implementations such as {@link org.slf4j.impl.NOPLogger NOPLogger} and
|
||||
* {@link org.slf4j.impl.SimpleLogger SimpleLogger} are also supported.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* <code>LoggerFactory</code> is essentially a wrapper around an
|
||||
* Other implementations such as {@link org.slf4j.nop.NOPLogger NOPLogger} and
|
||||
* {@link org.slf4j.simple.SimpleLogger SimpleLogger} are also supported.
|
||||
*
|
||||
* <p><code>LoggerFactory</code> is essentially a wrapper around an
|
||||
* {@link ILoggerFactory} instance bound with <code>LoggerFactory</code> at
|
||||
* compile time.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* Please note that all methods in <code>LoggerFactory</code> are static.
|
||||
*
|
||||
* <p>
|
||||
* Please note that all methods in <code>LoggerFactory</code> are static.
|
||||
*
|
||||
* @author Alexander Dorokhine
|
||||
* @author Robert Elliot
|
||||
|
|
@ -112,8 +110,8 @@ public final class LoggerFactory {
|
|||
/**
|
||||
* It is LoggerFactory's responsibility to track version changes and manage
|
||||
* the compatibility list.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* <p>
|
||||
* <p>
|
||||
* It is assumed that all versions in the 1.6 are mutually compatible.
|
||||
*/
|
||||
static private final String[] API_COMPATIBILITY_LIST = new String[] { "1.8", "1.7" };
|
||||
|
|
@ -124,13 +122,13 @@ public final class LoggerFactory {
|
|||
|
||||
/**
|
||||
* Force LoggerFactory to consider itself uninitialized.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* <p>
|
||||
* <p>
|
||||
* This method is intended to be called by classes (in the same package) for
|
||||
* testing purposes. This method is internal. It can be modified, renamed or
|
||||
* removed at any time without notice.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* <p>
|
||||
* <p>
|
||||
* You are strongly discouraged from calling this method in production code.
|
||||
*/
|
||||
static void reset() {
|
||||
|
|
@ -395,8 +393,8 @@ public final class LoggerFactory {
|
|||
|
||||
/**
|
||||
* Return the {@link ILoggerFactory} instance in use.
|
||||
* <p/>
|
||||
* <p/>
|
||||
* <p>
|
||||
* <p>
|
||||
* ILoggerFactory instance is bound with this class at compile time.
|
||||
*
|
||||
* @return the ILoggerFactory instance in use
|
||||
|
|
|
|||
|
|
@ -2,10 +2,10 @@ package org.slf4j;
|
|||
|
||||
/**
|
||||
* All methods in this class are reserved for internal use, for testing purposes.
|
||||
* <p/>
|
||||
* <p/>They can can be modified, renamed or removed at any time without notice.
|
||||
* <p/>
|
||||
* You are strongly discouraged calling any of the methods of this class.
|
||||
*
|
||||
* <p>They can can be modified, renamed or removed at any time without notice.
|
||||
*
|
||||
* <p>You are strongly discouraged calling any of the methods of this class.
|
||||
*
|
||||
* @since 1.8.0
|
||||
*
|
||||
|
|
@ -14,7 +14,7 @@ package org.slf4j;
|
|||
public class LoggerFactoryFriend {
|
||||
|
||||
/*
|
||||
* Force LoggerFactory to consider itself uninitialized. <p/>
|
||||
* Force LoggerFactory to consider itself uninitialized.
|
||||
*/
|
||||
static public void reset() {
|
||||
LoggerFactory.reset();
|
||||
|
|
|
|||
|
|
@ -37,8 +37,8 @@ import org.slf4j.event.SubstituteLoggingEvent;
|
|||
/**
|
||||
* A logger implementation which logs via a delegate logger. By default, the delegate is a
|
||||
* {@link NOPLogger}. However, a different delegate can be set at any time.
|
||||
* <p/>
|
||||
* See also the <a href="http://www.slf4j.org/codes.html#substituteLogger">relevant
|
||||
*
|
||||
* <p>See also the <a href="http://www.slf4j.org/codes.html#substituteLogger">relevant
|
||||
* error code</a> documentation.
|
||||
*
|
||||
* @author Chetan Mehrotra
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-ext</artifactId>
|
||||
|
|
|
|||
|
|
@ -28,12 +28,12 @@ package org.slf4j.agent;
|
|||
* <p>
|
||||
* All recognized options in the string passed to the java agent. For
|
||||
* "java -javaagent:foo.jar=OPTIONS HelloWorld" this would be "OPTIONS".
|
||||
* </p>
|
||||
*
|
||||
* <p>
|
||||
* It is considered to be a list of options separated by (currently) ";", on the
|
||||
* form "option=value". The interpretation of "value" is specific to each
|
||||
* option.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public class AgentOptions {
|
||||
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ import ch.qos.cal10n.MessageParameterObj;
|
|||
|
||||
/**
|
||||
* A logger specialized in localized logging. Localization is based in the <a
|
||||
* href="http://cal10n.qos.ch">CAL10N project</p>.
|
||||
* href="http://cal10n.qos.ch">CAL10N project</a>.
|
||||
*
|
||||
* @author Ceki Gülcü
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -46,11 +46,11 @@ import org.slf4j.helpers.MessageFormatter;
|
|||
* <p>
|
||||
* LogTransformer does the work of analyzing each class, and if appropriate add
|
||||
* log statements to each method to allow logging entry/exit.
|
||||
* </p>
|
||||
*
|
||||
* <p>
|
||||
* This class is based on the article <a href="http://today.java.net/pub/a/today/2008/04/24/add-logging-at-class-load-time-with-instrumentation.html"
|
||||
* >Add Logging at Class Load Time with Java Instrumentation</a>.
|
||||
* </p>
|
||||
*
|
||||
*/
|
||||
public class LogTransformer implements ClassFileTransformer {
|
||||
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-jdk14</artifactId>
|
||||
|
|
|
|||
|
|
@ -87,7 +87,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for level FINEST.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -108,7 +108,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the FINEST level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -131,7 +131,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the FINEST level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -186,7 +186,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for level FINE.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -207,7 +207,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the FINE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -230,7 +230,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the FINE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -285,7 +285,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the INFO level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -306,7 +306,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the INFO level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -329,7 +329,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the INFO level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -387,7 +387,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the WARNING level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -408,7 +408,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the WARNING level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -431,7 +431,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the WARNING level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -488,7 +488,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the SEVERE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -509,7 +509,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the SEVERE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -532,7 +532,7 @@ public final class JDK14LoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the SEVERE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-log4j12</artifactId>
|
||||
|
|
|
|||
|
|
@ -121,7 +121,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for level TRACE.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -142,7 +142,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the TRACE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -165,7 +165,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the TRACE level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -217,7 +217,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for level DEBUG.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -238,7 +238,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the DEBUG level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -261,7 +261,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the DEBUG level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -311,7 +311,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the INFO level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -332,7 +332,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the INFO level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -355,7 +355,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the INFO level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -408,7 +408,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the WARN level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -429,7 +429,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the WARN level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -452,7 +452,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the WARN level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -505,7 +505,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the ERROR level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -526,7 +526,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the ERROR level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
@ -549,7 +549,7 @@ public final class Log4jLoggerAdapter extends MarkerIgnoringBase implements Loca
|
|||
* <p>
|
||||
* This form avoids superfluous object creation when the logger is disabled
|
||||
* for the ERROR level.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @param format
|
||||
* the format string
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-migrator</artifactId>
|
||||
|
|
|
|||
|
|
@ -229,14 +229,14 @@ public class MigratorFrame extends JFrame implements ActionListener {
|
|||
|
||||
private void createAwareLabel() {
|
||||
awareLabel = new JLabel();
|
||||
awareLabel.setText("<html>" + "<p>I am aware that this tool will directly modify all Java source files</p>"
|
||||
+ "<p>in the selected folder without creating backup files.</p>" + "</html>");
|
||||
awareLabel.setText("<html>" + "<p>I am aware that this tool will directly modify all Java source files"
|
||||
+ "<p>in the selected folder without creating backup files." + "</html>");
|
||||
}
|
||||
|
||||
private void createWarningLabel() {
|
||||
warningLabel = new JLabel();
|
||||
warningLabel.setText("<html>" + "<p><span color=\"red\">WARNING:</span> This SLF4J migration tool will directly modify all Java source files</p>"
|
||||
+ "<p>in the selected project folder without creating a backup of the original files.</p>" + "</html>");
|
||||
warningLabel.setText("<html>" + "<p><span color=\"red\">WARNING:</span> This SLF4J migration tool will directly modify all Java source files"
|
||||
+ "<p>in the selected project folder without creating a backup of the original files." + "</html>");
|
||||
}
|
||||
|
||||
private void createMigrateButton() {
|
||||
|
|
@ -341,7 +341,7 @@ public class MigratorFrame extends JFrame implements ActionListener {
|
|||
buf.append(i);
|
||||
buf.append(". ");
|
||||
buf.append(msg);
|
||||
buf.append("</p>");
|
||||
buf.append("");
|
||||
i++;
|
||||
}
|
||||
buf.append("</html>");
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-nop</artifactId>
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-simple</artifactId>
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* Simple implementation of {@link Logger} that sends all enabled log messages,
|
||||
* for all defined loggers, to the console ({@code System.err}). The following
|
||||
* system properties are supported to configure the behavior of this logger:
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <ul>
|
||||
* <li><code>org.slf4j.simpleLogger.logFile</code> - The output target which can
|
||||
|
|
@ -103,17 +103,17 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* this implementation also checks for a class loader resource named
|
||||
* <code>"simplelogger.properties"</code>, and includes any matching definitions
|
||||
* from this resource (if it exists).
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <p>
|
||||
* With no configuration, the default output includes the relative time in
|
||||
* milliseconds, thread name, the level, logger name, and the message followed
|
||||
* by the line separator for the host. In log4j terms it amounts to the "%r [%t]
|
||||
* %level %logger - %m%n" pattern.
|
||||
* </p>
|
||||
*
|
||||
* <p>
|
||||
* Sample output follows.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* <pre>
|
||||
* 176 [main] INFO examples.Sort - Populating an array of 2 elements in reverse order.
|
||||
|
|
@ -132,7 +132,7 @@ import org.slf4j.spi.LocationAwareLogger;
|
|||
* This implementation is heavily inspired by
|
||||
* <a href="http://commons.apache.org/logging/">Apache Commons Logging</a>'s
|
||||
* SimpleLog.
|
||||
* </p>
|
||||
*
|
||||
*
|
||||
* @author Ceki Gülcü
|
||||
* @author Scott Sanders
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@
|
|||
<parent>
|
||||
<groupId>org.slf4j</groupId>
|
||||
<artifactId>slf4j-parent</artifactId>
|
||||
<version>2.0.0-alpha0-SNAPSHOT</version>
|
||||
<version>2.0.0-alpha0</version>
|
||||
</parent>
|
||||
|
||||
<artifactId>slf4j-site</artifactId>
|
||||
|
|
|
|||
Loading…
Reference in New Issue