org.eclipse.jetty.util.log.Logger Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ehcache Show documentation
Show all versions of ehcache Show documentation
Ehcache is an open source, standards-based cache used to boost performance,
offload the database and simplify scalability. Ehcache is robust, proven and full-featured and
this has made it the most widely-used Java-based cache.
//
// ========================================================================
// Copyright (c) 1995-2013 Mort Bay Consulting Pty. Ltd.
// ------------------------------------------------------------------------
// All rights reserved. This program and the accompanying materials
// are made available under the terms of the Eclipse Public License v1.0
// and Apache License v2.0 which accompanies this distribution.
//
// The Eclipse Public License is available at
// http://www.eclipse.org/legal/epl-v10.html
//
// The Apache License v2.0 is available at
// http://www.opensource.org/licenses/apache2.0.php
//
// You may elect to redistribute this code under either of these licenses.
// ========================================================================
//
package org.eclipse.jetty.util.log;
/**
* A simple logging facade that is intended simply to capture the style of logging as used by Jetty.
*/
public interface Logger
{
/**
* @return the name of this logger
*/
public String getName();
/**
* Formats and logs at warn level.
* @param msg the formatting string
* @param args the optional arguments
*/
public void warn(String msg, Object... args);
/**
* Logs the given Throwable information at warn level
* @param thrown the Throwable to log
*/
public void warn(Throwable thrown);
/**
* Logs the given message at warn level, with Throwable information.
* @param msg the message to log
* @param thrown the Throwable to log
*/
public void warn(String msg, Throwable thrown);
/**
* Formats and logs at info level.
* @param msg the formatting string
* @param args the optional arguments
*/
public void info(String msg, Object... args);
/**
* Logs the given Throwable information at info level
* @param thrown the Throwable to log
*/
public void info(Throwable thrown);
/**
* Logs the given message at info level, with Throwable information.
* @param msg the message to log
* @param thrown the Throwable to log
*/
public void info(String msg, Throwable thrown);
/**
* @return whether the debug level is enabled
*/
public boolean isDebugEnabled();
/**
* Mutator used to turn debug on programmatically.
* @param enabled whether to enable the debug level
*/
public void setDebugEnabled(boolean enabled);
/**
* Formats and logs at debug level.
* @param msg the formatting string
* @param args the optional arguments
*/
public void debug(String msg, Object... args);
/**
* Logs the given Throwable information at debug level
* @param thrown the Throwable to log
*/
public void debug(Throwable thrown);
/**
* Logs the given message at debug level, with Throwable information.
* @param msg the message to log
* @param thrown the Throwable to log
*/
public void debug(String msg, Throwable thrown);
/**
* @param name the name of the logger
* @return a logger with the given name
*/
public Logger getLogger(String name);
/**
* Ignore an exception.
* This should be used rather than an empty catch block.
*/
public void ignore(Throwable ignored);
}