17ba0605dc97fb81bde8311510d27b3ccba170008Ceki Gulcu/** 27ba0605dc97fb81bde8311510d27b3ccba170008Ceki Gulcu * Copyright (c) 2004-2011 QOS.ch 388c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * All rights reserved. 47ba0605dc97fb81bde8311510d27b3ccba170008Ceki Gulcu * 588c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * Permission is hereby granted, free of charge, to any person obtaining 688c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * a copy of this software and associated documentation files (the 788c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * "Software"), to deal in the Software without restriction, including 888c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * without limitation the rights to use, copy, modify, merge, publish, 988c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * distribute, sublicense, and/or sell copies of the Software, and to 1088c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * permit persons to whom the Software is furnished to do so, subject to 1188c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * the following conditions: 127ba0605dc97fb81bde8311510d27b3ccba170008Ceki Gulcu * 1388c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * The above copyright notice and this permission notice shall be 1488c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * included in all copies or substantial portions of the Software. 157ba0605dc97fb81bde8311510d27b3ccba170008Ceki Gulcu * 1688c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 1788c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 1888c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 1988c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 2088c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 2188c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 2288c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 237ba0605dc97fb81bde8311510d27b3ccba170008Ceki Gulcu * 2488c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu */ 2588c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu 2688c4c456766193e012eb890e2208473d99b91f83Ceki Gulcupackage org.slf4j; 2788c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu 2888c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu/** 29255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * The org.slf4j.Logger interface is the main user entry point of SLF4J API. 30255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * It is expected that logging takes place through concrete implementations 3188c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * of this interface. 32255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * <p/> 3388c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * <h3>Typical usage pattern:</h3> 3488c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * <pre> 3588c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * import org.slf4j.Logger; 3688c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * import org.slf4j.LoggerFactory; 37255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * 3888c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * public class Wombat { 3988c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * 4088c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * <span style="color:green">final static Logger logger = LoggerFactory.getLogger(Wombat.class);</span> 4188c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * Integer t; 4288c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * Integer oldT; 4388c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * 4488c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * public void setTemperature(Integer temperature) { 45255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * oldT = t; 4688c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * t = temperature; 4788c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * <span style="color:green">logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT);</span> 4888c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * if(temperature.intValue() > 50) { 4988c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * <span style="color:green">logger.info("Temperature has risen above 50 degrees.");</span> 5088c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * } 5188c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * } 5288c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * } 53255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * </pre> 54255def2278b87df16f24ad119a865b0ce5cb71d1Ceki Gulcu * 553b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * Be sure to read the FAQ entry relating to <a href="../../../faq.html#logging_performance">parameterized 563b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * logging</a>. Note that logging statements can be parameterized in 573b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * <a href="../../../faq.html#paramException">presence of an exception/throwable</a>. 583b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * 593b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * <p>Once you are comfortable using loggers, i.e. instances of this interface, consider using 603b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * <a href="MDC.html">MDC</a> as well as <a href="Marker.html">Markers</a>.</p> 613b040e36ff55b7e98fe16e09a4c813d3dab524d6Ceki Gulcu * 6288c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu * @author Ceki Gülcü 6388c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu */ 6488c4c456766193e012eb890e2208473d99b91f83Ceki Gulcupublic interface Logger { 6588c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu 6631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 6731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Case insensitive String constant used to retrieve the name of the root logger. 6831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 6931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.3 7031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 7131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu final public String ROOT_LOGGER_NAME = "ROOT"; 7231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 7331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 7431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Return the name of this <code>Logger</code> instance. 7531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return name of this logger instance 7631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 7731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public String getName(); 7831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 7931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 8031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Is the logger instance enabled for the TRACE level? 8131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 8231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the TRACE level, 8331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 8431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 8531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 8631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isTraceEnabled(); 8731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 8831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 8931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the TRACE level. 9031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 9131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 9231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 9331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 9431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(String msg); 9531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 9631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 9731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the TRACE level according to the specified format 9831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and argument. 9931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 10031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 10131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the TRACE level. </p> 10231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 10331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 10431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 10531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 10631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 10731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(String format, Object arg); 10831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 10931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 11031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the TRACE level according to the specified format 11131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 11231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 11331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 11431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the TRACE level. </p> 11531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 11631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 11731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 11831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 11931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 12031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 12131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(String format, Object arg1, Object arg2); 12231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 12331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 12431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the TRACE level according to the specified format 12531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 12631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 12731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous string concatenation when the logger 12831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the TRACE level. However, this variant incurs the hidden 12931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * (and relatively small) cost of creating an <code>Object[]</code> before invoking the method, 13031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * even if this logger is disabled for TRACE. The variants taking {@link #trace(String, Object) one} and 13131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * {@link #trace(String, Object, Object) two} arguments exist solely in order to avoid this hidden cost.</p> 13231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 13331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 13431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 13531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 13631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 13731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(String format, Object... arguments); 13831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 13931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 14031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log an exception (throwable) at the TRACE level with an 14131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * accompanying message. 14231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 14331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 14431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 14531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 14631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 14731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(String msg, Throwable t); 14831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 14931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 15031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Similar to {@link #isTraceEnabled()} method except that the 15131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into account. 15231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 15331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker data to take into consideration 15431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the TRACE level, 15531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 15631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 15731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 15831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 15931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isTraceEnabled(Marker marker); 16031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 16131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 16231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message with the specific Marker at the TRACE level. 16331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 16431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 16531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 16631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 16731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 16831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(Marker marker, String msg); 16931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 17031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 17131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #trace(String, Object)} method except that the 17231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 17331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 17431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 17531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 17631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 17731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 17831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 17931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(Marker marker, String format, Object arg); 18031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 18131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 18231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #trace(String, Object, Object)} 18331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 18431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 18531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 18631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 18731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 18831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 18931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 19031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 19131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 19231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(Marker marker, String format, Object arg1, Object arg2); 19331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 19431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 19531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #trace(String, Object...)} 19631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 19731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 19831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 19931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 20031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 20131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param argArray an array of arguments 20231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 20331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 20431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(Marker marker, String format, Object... argArray); 20531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 20631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 20731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #trace(String, Throwable)} method except that the 20831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 20931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 21031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 21131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 21231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 21331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @since 1.4 21431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 21531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void trace(Marker marker, String msg, Throwable t); 21631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 21731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 21831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Is the logger instance enabled for the DEBUG level? 21931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 22031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the DEBUG level, 22131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 22231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 22331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isDebugEnabled(); 22431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 22531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 22631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the DEBUG level. 22731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 22831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 22931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 23031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(String msg); 23131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 23231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 23331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the DEBUG level according to the specified format 23431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and argument. 23531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 23631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 23731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the DEBUG level. </p> 23831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 23931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 24031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 24131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 24231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(String format, Object arg); 24331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 24431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 24531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the DEBUG level according to the specified format 24631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 24731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 24831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 24931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the DEBUG level. </p> 25031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 25131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 25231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 25331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 25431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 25531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(String format, Object arg1, Object arg2); 25631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 25731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 25831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the DEBUG level according to the specified format 25931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 26031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 26131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous string concatenation when the logger 26231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the DEBUG level. However, this variant incurs the hidden 26331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * (and relatively small) cost of creating an <code>Object[]</code> before invoking the method, 26431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * even if this logger is disabled for DEBUG. The variants taking 26531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * {@link #debug(String, Object) one} and {@link #debug(String, Object, Object) two} 26631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * arguments exist solely in order to avoid this hidden cost.</p> 26731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 26831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 26931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 27031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 27131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(String format, Object... arguments); 27231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 27331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 27431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log an exception (throwable) at the DEBUG level with an 27531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * accompanying message. 27631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 27731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 27831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 27931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 28031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(String msg, Throwable t); 28131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 28231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 28331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Similar to {@link #isDebugEnabled()} method except that the 28431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into account. 28531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 28631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker data to take into consideration 28731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the DEBUG level, 28831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 28931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 29031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isDebugEnabled(Marker marker); 29131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 29231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 29331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message with the specific Marker at the DEBUG level. 29431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 29531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 29631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 29731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 29831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(Marker marker, String msg); 29931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 30031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 30131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #debug(String, Object)} method except that the 30231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 30331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 30431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 30531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 30631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 30731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 30831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(Marker marker, String format, Object arg); 30931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 31031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 31131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #debug(String, Object, Object)} 31231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 31331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 31431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 31531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 31631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 31731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 31831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 31931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 32031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(Marker marker, String format, Object arg1, Object arg2); 32131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 32231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 32331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #debug(String, Object...)} 32431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 32531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 32631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 32731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 32831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 32931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 33031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 33131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(Marker marker, String format, Object... arguments); 33231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 33331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 33431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #debug(String, Throwable)} method except that the 33531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 33631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 33731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 33831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 33931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 34031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 34131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void debug(Marker marker, String msg, Throwable t); 34231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 34331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 34431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Is the logger instance enabled for the INFO level? 34531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 34631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the INFO level, 34731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 34831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 34931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isInfoEnabled(); 35031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 35131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 35231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the INFO level. 35331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 35431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 35531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 35631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(String msg); 35731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 35831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 35931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the INFO level according to the specified format 36031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and argument. 36131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 36231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 36331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the INFO level. </p> 36431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 36531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 36631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 36731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 36831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(String format, Object arg); 36931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 37031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 37131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the INFO level according to the specified format 37231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 37331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 37431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 37531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the INFO level. </p> 37631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 37731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 37831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 37931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 38031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 38131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(String format, Object arg1, Object arg2); 38231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 38331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 38431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the INFO level according to the specified format 38531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 38631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 38731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous string concatenation when the logger 38831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the INFO level. However, this variant incurs the hidden 38931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * (and relatively small) cost of creating an <code>Object[]</code> before invoking the method, 39031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * even if this logger is disabled for INFO. The variants taking 39131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * {@link #info(String, Object) one} and {@link #info(String, Object, Object) two} 39231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * arguments exist solely in order to avoid this hidden cost.</p> 39331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 39431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 39531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 39631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 39731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(String format, Object... arguments); 39831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 39931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 40031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log an exception (throwable) at the INFO level with an 40131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * accompanying message. 40231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 40331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 40431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 40531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 40631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(String msg, Throwable t); 40731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 40831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 40931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Similar to {@link #isInfoEnabled()} method except that the marker 41031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * data is also taken into consideration. 41131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 41231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker data to take into consideration 41331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return true if this logger is warn enabled, false otherwise 41431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 41531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isInfoEnabled(Marker marker); 41631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 41731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 41831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message with the specific Marker at the INFO level. 41931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 42031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker specific to this log statement 42131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 42231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 42331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(Marker marker, String msg); 42431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 42531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 42631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #info(String, Object)} method except that the 42731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 42831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 42931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 43031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 43131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 43231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 43331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(Marker marker, String format, Object arg); 43431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 43531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 43631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #info(String, Object, Object)} 43731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 43831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 43931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 44031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 44131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 44231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 44331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 44431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 44531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(Marker marker, String format, Object arg1, Object arg2); 44631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 44731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 44831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #info(String, Object...)} 44931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 45031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 45131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 45231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 45331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 45431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 45531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 45631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(Marker marker, String format, Object... arguments); 45731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 45831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 45931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #info(String, Throwable)} method 46031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * except that the marker data is also taken into consideration. 46131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 46231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data for this log statement 46331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 46431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 46531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 46631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void info(Marker marker, String msg, Throwable t); 46731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 46831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 46931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Is the logger instance enabled for the WARN level? 47031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 47131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the WARN level, 47231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 47331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 47431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isWarnEnabled(); 47531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 47631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 47731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the WARN level. 47831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 47931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 48031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 48131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(String msg); 48231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 48331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 48431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the WARN level according to the specified format 48531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and argument. 48631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 48731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 48831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the WARN level. </p> 48931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 49031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 49131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 49231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 49331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(String format, Object arg); 49431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 49531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 49631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the WARN level according to the specified format 49731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 49831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 49931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous string concatenation when the logger 50031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the WARN level. However, this variant incurs the hidden 50131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * (and relatively small) cost of creating an <code>Object[]</code> before invoking the method, 50231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * even if this logger is disabled for WARN. The variants taking 50331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * {@link #warn(String, Object) one} and {@link #warn(String, Object, Object) two} 50431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * arguments exist solely in order to avoid this hidden cost.</p> 50531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 50631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 50731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 50831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 50931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(String format, Object... arguments); 51031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 51131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 51231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the WARN level according to the specified format 51331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 51431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 51531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 51631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the WARN level. </p> 51731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 51831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 51931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 52031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 52131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 52231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(String format, Object arg1, Object arg2); 52331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 52431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 52531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log an exception (throwable) at the WARN level with an 52631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * accompanying message. 52731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 52831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 52931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 53031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 53131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(String msg, Throwable t); 53231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 53331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 53431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Similar to {@link #isWarnEnabled()} method except that the marker 53531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * data is also taken into consideration. 53631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 53731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker data to take into consideration 53831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the WARN level, 53931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 54031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 54131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isWarnEnabled(Marker marker); 54231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 54331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 54431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message with the specific Marker at the WARN level. 54531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 54631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker specific to this log statement 54731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 54831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 54931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(Marker marker, String msg); 55031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 55131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 55231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #warn(String, Object)} method except that the 55331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 55431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 55531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 55631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 55731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 55831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 55931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(Marker marker, String format, Object arg); 56031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 56131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 56231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #warn(String, Object, Object)} 56331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 56431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 56531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 56631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 56731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 56831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 56931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 57031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 57131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(Marker marker, String format, Object arg1, Object arg2); 57231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 57331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 57431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #warn(String, Object...)} 57531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 57631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 57731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 57831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 57931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 58031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 58131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 58231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(Marker marker, String format, Object... arguments); 58331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 58431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 58531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #warn(String, Throwable)} method 58631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * except that the marker data is also taken into consideration. 58731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 58831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data for this log statement 58931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 59031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 59131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 59231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void warn(Marker marker, String msg, Throwable t); 59331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 59431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 59531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Is the logger instance enabled for the ERROR level? 59631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 59731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the ERROR level, 59831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 59931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 60031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isErrorEnabled(); 60131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 60231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 60331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the ERROR level. 60431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 60531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 60631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 60731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(String msg); 60831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 60931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 61031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the ERROR level according to the specified format 61131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and argument. 61231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 61331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 61431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the ERROR level. </p> 61531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 61631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 61731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 61831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 61931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(String format, Object arg); 62031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 62131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 62231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the ERROR level according to the specified format 62331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 62431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 62531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous object creation when the logger 62631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the ERROR level. </p> 62731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 62831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 62931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 63031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 63131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 63231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(String format, Object arg1, Object arg2); 63331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 63431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 63531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message at the ERROR level according to the specified format 63631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * and arguments. 63731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p/> 63831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * <p>This form avoids superfluous string concatenation when the logger 63931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * is disabled for the ERROR level. However, this variant incurs the hidden 64031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * (and relatively small) cost of creating an <code>Object[]</code> before invoking the method, 64131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * even if this logger is disabled for ERROR. The variants taking 64231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * {@link #error(String, Object) one} and {@link #error(String, Object, Object) two} 64331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * arguments exist solely in order to avoid this hidden cost.</p> 64431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 64531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 64631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 64731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 64831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(String format, Object... arguments); 64931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 65031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 65131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log an exception (throwable) at the ERROR level with an 65231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * accompanying message. 65331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 65431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 65531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 65631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 65731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(String msg, Throwable t); 65831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 65931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 66031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Similar to {@link #isErrorEnabled()} method except that the 66131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 66231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 66331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker data to take into consideration 66431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @return True if this Logger is enabled for the ERROR level, 66531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * false otherwise. 66631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 66731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public boolean isErrorEnabled(Marker marker); 66831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 66931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 67031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * Log a message with the specific Marker at the ERROR level. 67131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 67231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker The marker specific to this log statement 67331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message string to be logged 67431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 67531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(Marker marker, String msg); 67631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 67731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 67831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #error(String, Object)} method except that the 67931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * marker data is also taken into consideration. 68031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 68131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 68231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 68331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg the argument 68431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 68531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(Marker marker, String format, Object arg); 68631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 68731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 68831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #error(String, Object, Object)} 68931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 69031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 69131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 69231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 69331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 69431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg1 the first argument 69531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arg2 the second argument 69631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 69731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(Marker marker, String format, Object arg1, Object arg2); 69831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 69931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 70031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #error(String, Object...)} 70131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 70231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 70331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 70431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 70531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param format the format string 70631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param arguments a list of 3 or more arguments 70731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 70831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(Marker marker, String format, Object... arguments); 70931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu 71031212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu /** 71131212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * This method is similar to {@link #error(String, Throwable)} 71231212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * method except that the marker data is also taken into 71331212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * consideration. 71431212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * 71531212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param marker the marker data specific to this log statement 71631212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param msg the message accompanying the exception 71731212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu * @param t the exception (throwable) to log 71831212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu */ 71931212435723e2dfd5d6716d1f6a7b0e66a1e6b38Ceki Gulcu public void error(Marker marker, String msg, Throwable t); 72088c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu 72188c4c456766193e012eb890e2208473d99b91f83Ceki Gulcu} 722