b60e0b6a51
- Borrow SLF4J API which is the best of the best - InternalLoggerFactory now automatically detects the logging framework using static class loading. It tries SLF4J, Log4J, and then falls back to java.util.logging. - Remove OsgiLogger because it is very likely that OSGi container already provides a bridge for existing logging frameworks - Remove JBossLogger because the latest JBossLogger implementation seems to implement SLF4J binding - Upgrade SLF4J to 1.7.2 - Remove tests for the untestable logging frameworks - Remove TestAny
445 lines
15 KiB
Java
445 lines
15 KiB
Java
/*
|
|
* Copyright 2012 The Netty Project
|
|
*
|
|
* The Netty Project licenses this file to you under the Apache License,
|
|
* version 2.0 (the "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at:
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*/
|
|
/**
|
|
* Copyright (c) 2004-2011 QOS.ch
|
|
* All rights reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
*/
|
|
package io.netty.logging;
|
|
|
|
/**
|
|
* <em>Internal-use-only</em> logger used by Netty. <strong>DO NOT</strong>
|
|
* access this class outside of Netty.
|
|
*/
|
|
public interface InternalLogger {
|
|
|
|
/**
|
|
* Return the name of this {@link InternalLogger} instance.
|
|
*
|
|
* @return name of this logger instance
|
|
*/
|
|
String name();
|
|
|
|
/**
|
|
* Is the logger instance enabled for the TRACE level?
|
|
*
|
|
* @return True if this Logger is enabled for the TRACE level,
|
|
* false otherwise.
|
|
*/
|
|
boolean isTraceEnabled();
|
|
|
|
/**
|
|
* Log a message at the TRACE level.
|
|
*
|
|
* @param msg the message string to be logged
|
|
*/
|
|
void trace(String msg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arg the argument
|
|
*/
|
|
void trace(String format, Object arg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param argA the first argument
|
|
* @param argB the second argument
|
|
*/
|
|
void trace(String format, Object argA, Object argB);
|
|
|
|
/**
|
|
* 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[]} 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arguments a list of 3 or more arguments
|
|
*/
|
|
void trace(String format, Object... arguments);
|
|
|
|
/**
|
|
* Log an exception (throwable) at the TRACE level with an
|
|
* accompanying message.
|
|
*
|
|
* @param msg the message accompanying the exception
|
|
* @param t the exception (throwable) to log
|
|
*/
|
|
void trace(String msg, Throwable t);
|
|
|
|
/**
|
|
* Is the logger instance enabled for the DEBUG level?
|
|
*
|
|
* @return True if this Logger is enabled for the DEBUG level,
|
|
* false otherwise.
|
|
*/
|
|
boolean isDebugEnabled();
|
|
|
|
/**
|
|
* Log a message at the DEBUG level.
|
|
*
|
|
* @param msg the message string to be logged
|
|
*/
|
|
void debug(String msg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arg the argument
|
|
*/
|
|
void debug(String format, Object arg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param argA the first argument
|
|
* @param argB the second argument
|
|
*/
|
|
void debug(String format, Object argA, Object argB);
|
|
|
|
/**
|
|
* 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[]} 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arguments a list of 3 or more arguments
|
|
*/
|
|
void debug(String format, Object... arguments);
|
|
|
|
/**
|
|
* Log an exception (throwable) at the DEBUG level with an
|
|
* accompanying message.
|
|
*
|
|
* @param msg the message accompanying the exception
|
|
* @param t the exception (throwable) to log
|
|
*/
|
|
void debug(String msg, Throwable t);
|
|
|
|
/**
|
|
* Is the logger instance enabled for the INFO level?
|
|
*
|
|
* @return True if this Logger is enabled for the INFO level,
|
|
* false otherwise.
|
|
*/
|
|
boolean isInfoEnabled();
|
|
|
|
/**
|
|
* Log a message at the INFO level.
|
|
*
|
|
* @param msg the message string to be logged
|
|
*/
|
|
void info(String msg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arg the argument
|
|
*/
|
|
void info(String format, Object arg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param argA the first argument
|
|
* @param argB the second argument
|
|
*/
|
|
void info(String format, Object argA, Object argB);
|
|
|
|
/**
|
|
* 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[]} 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arguments a list of 3 or more arguments
|
|
*/
|
|
void info(String format, Object... arguments);
|
|
|
|
/**
|
|
* Log an exception (throwable) at the INFO level with an
|
|
* accompanying message.
|
|
*
|
|
* @param msg the message accompanying the exception
|
|
* @param t the exception (throwable) to log
|
|
*/
|
|
void info(String msg, Throwable t);
|
|
|
|
/**
|
|
* Is the logger instance enabled for the WARN level?
|
|
*
|
|
* @return True if this Logger is enabled for the WARN level,
|
|
* false otherwise.
|
|
*/
|
|
boolean isWarnEnabled();
|
|
|
|
/**
|
|
* Log a message at the WARN level.
|
|
*
|
|
* @param msg the message string to be logged
|
|
*/
|
|
void warn(String msg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arg the argument
|
|
*/
|
|
void warn(String format, Object arg);
|
|
|
|
/**
|
|
* 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[]} 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arguments a list of 3 or more arguments
|
|
*/
|
|
void warn(String format, Object... arguments);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param argA the first argument
|
|
* @param argB the second argument
|
|
*/
|
|
void warn(String format, Object argA, Object argB);
|
|
|
|
/**
|
|
* Log an exception (throwable) at the WARN level with an
|
|
* accompanying message.
|
|
*
|
|
* @param msg the message accompanying the exception
|
|
* @param t the exception (throwable) to log
|
|
*/
|
|
void warn(String msg, Throwable t);
|
|
|
|
/**
|
|
* Is the logger instance enabled for the ERROR level?
|
|
*
|
|
* @return True if this Logger is enabled for the ERROR level,
|
|
* false otherwise.
|
|
*/
|
|
boolean isErrorEnabled();
|
|
|
|
/**
|
|
* Log a message at the ERROR level.
|
|
*
|
|
* @param msg the message string to be logged
|
|
*/
|
|
void error(String msg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arg the argument
|
|
*/
|
|
void error(String format, Object arg);
|
|
|
|
/**
|
|
* 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>
|
|
*
|
|
* @param format the format string
|
|
* @param argA the first argument
|
|
* @param argB the second argument
|
|
*/
|
|
void error(String format, Object argA, Object argB);
|
|
|
|
/**
|
|
* 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[]} 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>
|
|
*
|
|
* @param format the format string
|
|
* @param arguments a list of 3 or more arguments
|
|
*/
|
|
void error(String format, Object... arguments);
|
|
|
|
/**
|
|
* Log an exception (throwable) at the ERROR level with an
|
|
* accompanying message.
|
|
*
|
|
* @param msg the message accompanying the exception
|
|
* @param t the exception (throwable) to log
|
|
*/
|
|
void error(String msg, Throwable t);
|
|
|
|
/**
|
|
* Is the logger instance enabled for the specified {@code level}?
|
|
*
|
|
* @return True if this Logger is enabled for the specified {@code level},
|
|
* false otherwise.
|
|
*/
|
|
boolean isEnabled(InternalLogLevel level);
|
|
|
|
/**
|
|
* Log a message at the specified {@code level}.
|
|
*
|
|
* @param msg the message string to be logged
|
|
*/
|
|
void log(InternalLogLevel level, String msg);
|
|
|
|
/**
|
|
* Log a message at the specified {@code level} according to the specified format
|
|
* and argument.
|
|
* <p/>
|
|
* <p>This form avoids superfluous object creation when the logger
|
|
* is disabled for the specified {@code level}. </p>
|
|
*
|
|
* @param format the format string
|
|
* @param arg the argument
|
|
*/
|
|
void log(InternalLogLevel level, String format, Object arg);
|
|
|
|
/**
|
|
* Log a message at the specified {@code level} according to the specified format
|
|
* and arguments.
|
|
* <p/>
|
|
* <p>This form avoids superfluous object creation when the logger
|
|
* is disabled for the specified {@code level}. </p>
|
|
*
|
|
* @param format the format string
|
|
* @param argA the first argument
|
|
* @param argB the second argument
|
|
*/
|
|
void log(InternalLogLevel level, String format, Object argA, Object argB);
|
|
|
|
/**
|
|
* Log a message at the specified {@code level} according to the specified format
|
|
* and arguments.
|
|
* <p/>
|
|
* <p>This form avoids superfluous string concatenation when the logger
|
|
* is disabled for the specified {@code level}. However, this variant incurs the hidden
|
|
* (and relatively small) cost of creating an {@code Object[]} before invoking the method,
|
|
* even if this logger is disabled for the specified {@code level}. The variants taking
|
|
* {@link #log(InternalLogLevel, String, Object) one} and
|
|
* {@link #log(InternalLogLevel, String, Object, Object) two} arguments exist solely
|
|
* in order to avoid this hidden cost.</p>
|
|
*
|
|
* @param format the format string
|
|
* @param arguments a list of 3 or more arguments
|
|
*/
|
|
void log(InternalLogLevel level, String format, Object... arguments);
|
|
|
|
/**
|
|
* Log an exception (throwable) at the specified {@code level} with an
|
|
* accompanying message.
|
|
*
|
|
* @param msg the message accompanying the exception
|
|
* @param t the exception (throwable) to log
|
|
*/
|
|
void log(InternalLogLevel level, String msg, Throwable t);
|
|
}
|