Index
Log4j的类图
Logger:日志写出器
Logger的输出方法
Logger的命名规则
Log level
示例代码
关于logger的两点说明
Appender:日志目的地
ConsoleAppender
FileAppender
RollingFileAppender
Layout:日志格式化器
PatternLayout
patterns in PatternLayout
Configuration:配置
默认的log4j初始化过程
BasicConfigurator.configure()
XML格式的log4j配置文件概述
在xml文件中配置appender和layout
我自己的一个使用xml文件配置log4j环境的很简单的例子
Log4j的编码习惯
参考资料
Log4j的类图
Logger - 日志写出器,供程序员输出日志信息
Appender - 日志目的地,把格式化好的日志信息输出到指定的地方去
ConsoleAppender - 目的地为控制台的Appender
FileAppender - 目的地为文件的Appender
RollingFileAppender - 目的地为大小受限的文件的Appender
Layout - 日志格式化器,用来把程序员的logging request格式化成字符串
PatternLayout - 用指定的pattern格式化logging request的Layout
Logger:日志写出器
Logger对象是用来取代System.out或者System.err的日志写出器,用来供程序员输出日志信息。
Logger的输出方法
Logger类对象提供一系列方法供程序员输出日志信息。
------ Log4j APIs : class Logger ------
// Printing methods :
public void debug(Object msg);
public void debug(Object msg, Throwable t);
public void info(Object msg);
public void info(Object msg, Throwable t);
public void warn(Object msg);
public void warn(Object msg, Throwable t);
public void error(Object msg);
public void error(Object msg, Throwable t);
public void fatal(Object msg);
public void fatal(Object msg, Throwable t);
// Generic printing method :
public void log(Level l, Object msg);
Logger的命名规则
Logger由一个String类的名字识别,logger的名字是大小写敏感的,且名字之间具有继续的关系,子名有父名作为前缀,用点号.分隔。如:x.y是x.y.z的父亲。
根logger (root logger)是所有logger的祖先,它具有如下属性:1) 它总是存在的;2) 它不可以通过名字获得。
通过调用public static Logger Logger.getRootLogger()获得root logger;通过调用public static Logger Logger.getLogger(String name)或者public static Logger Logger.getLogger(Class clazz)获得(或者创建)一个named logger。后者相当于调用Logger.getLogger(clazz.getName())。
在某对象中,用该对象所属的类为参数,调用Logger.getLogger(Class clazz)以获得logger被认为是目前所知的最理智的命名logger的方法。
Log level
每个logger都被分配了一个日志级别 (log level),用来控制日志信息的输出。未被分配level的logger将继续它最近的父logger的level。
每条输出到logger的日志请求(logging request)也都有一个level,假如该request的level大于等于该logger的level,则该request将被处理(称为enabled);否则该request将被忽略。故可得知:
logger的level越低,表示该logger越具体
logging request的level越高,表示该logging request越优先输出
Level类中预定义了五个level,它们的大小关系如下:
Level.ALL < Level.DEBUG < Level.INFO < Level.WARN < Level.ERROR < Level.FATAL < Level.OFF