Interface Logger

slf4j-api/src/main/java/org/slf4j/Logger.java:84–881

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. Typical usage pattern: import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class Wombat { <span style=

 * @author Ceki Gülcü
 */
public interface Logger {

    /**
     * Case-insensitive String constant used to retrieve the name of the root logger.
     *
     * @since 1.3
     */
    final public String ROOT_LOGGER_NAME = "ROOT";

    /**
     * Return the name of this <code>Logger</code> instance.
     * @return name of this logger instance 
     */
    public String getName();

    /**
     * <p>Make a new {@link LoggingEventBuilder} instance as appropriate for this logger implementation.
     * This default implementation always returns a new instance of {@link DefaultLoggingEventBuilder}.</p>
     * <p></p>
     * <p>This method is intended to be used by logging systems implementing the SLF4J API and <b>not</b>
     * by end users.</p>
     * <p></p>
     * <p>Also note that a {@link LoggingEventBuilder} instance should be built for all levels,
     * independently of the level argument. In other words, this method is an <b>unconditional</b>
     * constructor for the {@link LoggingEventBuilder} appropriate for this logger implementation.</p>
     * <p></p>
     * @param level desired level for the event builder
     * @return a new {@link LoggingEventBuilder} instance as appropriate for <b>this</b> logger
     * @since 2.0
     */
    default public LoggingEventBuilder makeLoggingEventBuilder(Level level) {
        return new DefaultLoggingEventBuilder(this, level);
    }

    /**
     * Make a new {@link LoggingEventBuilder} instance as appropriate for this logger and the
     * desired {@link Level} passed as parameter. If this Logger is disabled for the given Level, then
     * a {@link  NOPLoggingEventBuilder} is returned.
     *
     *
     * @param level desired level for the event builder
     * @return a new {@link LoggingEventBuilder} instance as appropriate for this logger
     * @since 2.0
     */
    @CheckReturnValue
    default public LoggingEventBuilder atLevel(Level level) {
        if (isEnabledForLevel(level)) {
            return makeLoggingEventBuilder(level);
        } else {
            return NOPLoggingEventBuilder.singleton();
        }
    }

    
    
    /**
     * Returns whether this Logger is enabled for a given {@link Level}. 
     *