Log4j Full

Index

1. Log4j的类图
2. Logger：日志写出器
   1. Logger的输出方法
   2. Logger的命名规则
   3. Log level
   4. 示例代码
   5. 关于logger的两点说明
3. Appender：日志目的地
   1. ConsoleAppender
   2. FileAppender
   3. RollingFileAppender
4. Layout：日志格式化器
   1. PatternLayout
   2. patterns in PatternLayout
5. Configuration：配置
   1. 默认的log4j初始化过程
   2. BasicConfigurator.configure()
   3. xml格式的log4j配置文件概述
   4. 在xml文件中配置appender和layout
   5. 我自己的一个使用xml文件配置log4j环境的很简单的例子
6. Log4j的编码习惯
7. 参考资料

1. Logger - 日志写出器，供程序员输出日志信息
2. Appender - 日志目的地，把格式化好的日志信息输出到指定的地方去
   1. ConsoleAppender - 目的地为控制台的Appender
   2. FileAppender - 目的地为文件的Appender
   3. RollingFileAppender - 目的地为大小受限的文件的Appender
3. Layout - 日志格式化器，用来把程序员的logging request格式化成字符串
   1. PatternLayout - 用指定的pattern格式化logging request的Layout

Logger对象是用来取代System.out或者System.err的日志写出器，用来供程序员输出日志信息。

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由一个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的方法。

每个logger都被分配了一个日志级别 (log level)，用来控制日志信息的输出。未被分配level的logger将继续它最近的父logger的level。

每条输出到logger的日志请求(logging request)也都有一个level，假如该request的level大于等于该logger的level，则该request将被处理（称为enabled）；否则该request将被忽略。故可得知：

1. logger的level越低，表示该logger越具体
2. logging request的level越高，表示该logging request越优先输出

Level类中预定义了五个level，它们的大小关系如下：

        Level.ALL < Level.DEBUG < Level.INFO < Level.WARN < Level.ERROR < Level.FATAL < Level.OFF