Java里的各种日志框架,相信大家都不陌生。Log4j/Log4j2/Logback/jboss logging
等等,其实这些日志框架核心结构没什么区别,只是细节实现上和其性能上有所不同。本文带你从零开始,一步一步的设计一个日志框架
输出内容 - LoggingEvent
提到日志框架,最容易想到的核心功能,那就是输出日志了。那么对于一行日志内容来说,应该至少包含以下几个信息:
-
日志时间戳
-
线程信息
-
日志名称(一般是全类名)
-
日志级别
-
日志主体(需要输出的内容,比如info(str))
为了方便的管理输出内容,现在需要创建一个输出内容的类来封装这些信息:
public class LoggingEvent {
public long timestamp;//日志时间戳
private int level;//日志级别
private Object message;//日志主题
private String threadName;//线程名称
private long threadId;//线程id
private String loggerName;//日志名称
//getter and setters...
@Override
public String toString() {
return "LoggingEvent{" +
"timestamp=" + timestamp +
", level=" + level +
", message=" + message +
", threadName='" + threadName + '\'' +
", threadId=" + threadId +
", loggerName='" + loggerName + '\'' +
'}';
}
}
对于每一次日志打印,应该属于一次输出的“事件-Event”,所以这里命名为LoggingEvent
输出组件 - Appender
有了输出内容之后,现在需要考虑输出方式。输出的方式可以有很多:标准输出/控制台(Standard Output/Console)、文件(File)、邮件(Email)、甚至是消息队列(MQ)和数据库。
现在将输出功能抽象成一个组件“输出器” - Appender,这个Appender组件的核心功能就是输出,下面是Appender的实现代码:
public interface Appender {
void append(LoggingEvent event);
}
不同的输出方式,只需要实现Appender接口做不同的实现即可,比如ConsoleAppender - 输出至控制台
public class ConsoleAppender implements Appender {
private OutputStream out = System.out;
private OutputStream out_err = System.err;
@Override
public void append(LoggingEvent event) {
try {
out.write(event.toString().getBytes(encoding));
} catch (IOException e) {
e.printStackTrace();
}
}
}
日志级别设计 - Level
日志框架还应该提供日志级别的功能,程序在使用时可以打印不同级别的日志,还可以根据日志级别来调整那些日志可以显示,一般日志级别会定义为以下几种,级别从左到右排序,只有大于等于某级别的LoggingEvent才会进行输出
ERROR > WARN > INFO > DEBUG > TRACE
现在来创建一个日志级别的枚举,只有两个属性,一个级别名称,一个级别数值(方便做比较)
public enum Level {
ERROR(40000, "ERROR"), WARN(30000, "WARN"), INFO(20000, "INFO"), DEBUG(10000, "DEBUG"), TRACE(5000, "TRACE");
private int levelInt;
private String levelStr;
Level(int i, String s) {
levelInt = i;
levelStr = s;
}
public static Level parse(String level)