net.spy.memcached.compat.log.Logger Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of spymemcached Show documentation
A client library for memcached.
There is a newer version: 2.8.4
// Copyright (c) 2002  SPY internetworking 

package net.spy.memcached.compat.log;

/**
 * Abstract mechanism for dealing with logs from various objects.
 *
 * Implementations are expected to have a constructor that takes a single
 * String representing the name of the logging item, or an empty constructor.
 *
 * @see LoggerFactory
 */
public interface Logger {

	/**
	 * Get the name of this logger.
	 */
	String getName();

	/**
	 * True if debug is enabled for this logger.
	 *
	 * @return true if debug messages would be displayed
	 */
	boolean isDebugEnabled();

	/**
	 * True if info is enabled for this logger.
	 *
	 * @return true if info messages would be displayed
	 */
	boolean isInfoEnabled();

	/**
	 * Log a message at the specified level.
	 *
	 * @param level the level at which to log
	 * @param message the message to log
	 * @param exception an exception that caused the message
	 */
	void log(Level level, Object message, Throwable exception);

	/**
	 * Log a message at the specified level.
	 *
	 * @param level the level at which to log
	 * @param message the message to log
	 */
	void log(Level level, Object message);

	/**
	 * Log a message at debug level.
	 *
	 * @param message the message to log
	 * @param exception the exception that caused the message to be generated
	 */
	void debug(Object message, Throwable exception);
	/**
	 * Log a message at debug level.
	 *
	 * @param message the message to log
	 */
	void debug(Object message);
	/**
	 * Log a formatted message at debug level.
	 *
	 * @param message the message to log
	 * @param args the arguments for that message
	 */
	void debug(String message, Object... args);

	/**
	 * Log a message at info level.
	 *
	 * @param message the message to log
	 * @param exception the exception that caused the message to be generated
	 */
	void info(Object message, Throwable exception);
	/**
	 * Log a message at info level.
	 *
	 * @param message the message to log
	 */
	void info(Object message);
	/**
	 * Log a formatted message at info level.
	 *
	 * @param message the message to log
	 * @param args the arguments for that message
	 */
	void info(String message, Object... args);

	/**
	 * Log a message at warning level.
	 *
	 * @param message the message to log
	 * @param exception the exception that caused the message to be generated
	 */
	void warn(Object message, Throwable exception);
	/**
	 * Log a message at warning level.
	 *
	 * @param message the message to log
	 */
	void warn(Object message);
	/**
	 * Log a formatted message at debug level.
	 *
	 * @param message the message to log
	 * @param args the arguments for that message
	 */
	void warn(String message, Object... args);

	/**
	 * Log a message at error level.
	 *
	 * @param message the message to log
	 * @param exception the exception that caused the message to be generated
	 */
	void error(Object message, Throwable exception);
	/**
	 * Log a message at error level.
	 *
	 * @param message the message to log
	 */
	void error(Object message);
	/**
	 * Log a formatted message at debug level.
	 *
	 * @param message the message to log
	 * @param args the arguments for that message
	 */
	void error(String message, Object... args);

	/**
	 * Log a message at fatal level.
	 *
	 * @param message the message to log
	 * @param exception the exception that caused the message to be generated
	 */
	void fatal(Object message, Throwable exception);
	/**
	 * Log a message at fatal level.
	 *
	 * @param message the message to log
	 */
	void fatal(Object message);
	/**
	 * Log a formatted message at debug level.
	 *
	 * @param message the message to log
	 * @param args the arguments for that message
	 */
	void fatal(String message, Object... args);
}