JLog

Универсальный интерфейс Java-логгера, подобный SLF4J или Apache Commons Logging.

Введение

Это универсальный интерфейс Java-логгера, похожий на SLF4J и Apache Commons Logging. В отличие от Log4j, он не является реализацией логгера сам по себе, а предоставляет абстракцию для различных реализаций логгеров.

Как и SLF4J, JLog способен обнаруживать все реализации логгеров в текущем пути к классам (через класс LogBinder) и выбирать наиболее подходящую в качестве стандартной реализации. При загрузке LogFactory сканирует все классы LogBinder в пути к классам и выбирает подходящий класс для создания фабрики логгеров. Стратегия выбора конкретной реализации логгера основана на двух правилах:

• getWeight — приоритет текущей реализации логгера. LogFactory отдаёт предпочтение реализациям с более высоким приоритетом.
• isAvailable — доступность текущей реализации логгера, то есть наличие зависимого файла Jar.

Следуя этим правилам, можно легко создать реализацию логгера с высоким приоритетом, чтобы JLog использовал её в первую очередь.

Загрузка

RELEASE: 1.0.0-RELEASE

Сборка

Этот проект использует Gradle в качестве инструмента сборки, что позволяет легко создавать его практически на любой платформе.

git clone http://git.oschina.net/jiangyc0/jlog.git
cd jlog
gradlew build

FAQ

Пример использования:

public class Test {
    public static void main(String[] args) {
        Log l = LogFactory.getLog(Test.class);
        l.debug("Hello JLog");
        // formatter string
        l.debug("Hello%5s", "JLog");
    }
}

Создание собственной реализации Log

Можно написать собственную реализацию Log и позволить JLog автоматически загружать её. Вот шаги для создания собственной реализации:

1. Написать класс, который реализует com.jopenlab.jlog.api.spi.LogBinder.
2. Создать файл с именем com.jopenlab.jlog.api.spi.LogBinder в каталоге META-INF/services.
3. Записать полное имя класса, реализующего com.jopenlab.jlog.api.spi.LogBinder, в этот файл.