org.slf4j.ILoggerFactory Maven / Gradle / Ivy
/*
* Copyright (c) 2020. https://rxmicro.io
*
* Licensed 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.
*/
package org.slf4j;
/**
* Unfortunately some db drivers removed support of JUL,
* so the RxMicro framework requires a org.slf4j proxy to enable logging without slf4j-api:
* http://www.slf4j.org.
*
*
* Read more:
*
* https://github.com/mongodb/mongo-java-driver/commit/6a163f715fe08ed8d39acac3d11c896ae547df73
*
*
*
* ILoggerFactory instances manufacture {@link Logger}
* instances by name.
*
*
Most users retrieve {@link Logger} instances through the static
* {@link LoggerFactory#getLogger(String)} method. An instance of of this
* interface is bound internally with {@link LoggerFactory} class at
* compile time.
*
* @author nedis
* @see http://www.slf4j.org/apidocs/org/slf4j/ILoggerFactory.html
* @since 0.3
*/
public interface ILoggerFactory {
/**
* See
* http://www.slf4j.org/apidocs/org/slf4j/ILoggerFactory.html.
*
*
* Return an appropriate {@link Logger} instance as specified by the
* name parameter.
*
*
* If the name parameter is equal to {@link Logger#ROOT_LOGGER_NAME}, that is
* the string value "ROOT" (case insensitive), then the root logger of the
* underlying logging system is returned.
*
*
* Null-valued name arguments are considered invalid.
*
*
* Certain extremely simple logging systems, e.g. NOP, may always
* return the same logger instance regardless of the requested name.
*
* @param name the name of the Logger to return
* @return a Logger instance
*/
Logger getLogger(String name);
}