Log4j配置及详解

1、下载log4j.jar

http://archive.apache.org/dist/logging/log4j/

2、将jar包导入到java项目中

3、在src文件下建立Log4j.properties配置文件

    Log4j.properties配置内容以下：

log4j.rootLogger=DEBUG,CONSOLE,FILE

##for console
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss}[%c-%L][%t][%r] - %m%n  

##for file
log4j.appender.FILE=org.apache.log4j.RollingFileAppender
log4j.appender.FILE.File=E:/logTest/log4j.log
log4j.appender.FILE.MaxFileSize=1MB
log4j.appender.FILE.Append=true
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss}[%t] %-5p %c(line-%L) %r %x - %m%n

4、配置讲解

Log4J配置文件的基本格式以下：

#配置根Logger
log4j.rootLogger  = [level] , appenderName1 , appenderName2 ,  …

#配置日志信息输出目的地Appender
log4j.appender.appenderName  =  fully.qualified.name.of.appender.class 
log4j.appender.appenderName.option1  =  value1 
　… 
log4j.appender.appenderName.optionN  =  valueN 

#配置日志信息的格式（布局）
log4j.appender.appenderName.layout  =  fully.qualified.name.of.layout.class 
log4j.appender.appenderName.layout.option1  =  value1 
　… 
log4j.appender.appenderName.layout.optionN  =  valueN

   （1）配置根Logger
           log4j.rootLogger  =   [ level ]   ,  appenderName1 ,  appenderName2 ,  ...

   其中[level]是日志输出级别，总共有5个级别：

FATAL      0  
ERROR      3  
WARN       4  
INFO       6  
DEBUG      7

• logger的level越低，表示该logger越详细

• logging request的level越高，表示该logging request越优先输出

 

（2）Appender为日志输出的目的地，Log4j提供了如下几种appender：

org.apache.log4j.ConsoleAppender（控制台），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（天天产生一个日志文件），
org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

  （3）Layout：日志输出格式，Log4j提供的layout有如下几种：

org.apache.log4j.HTMLLayout（以HTML表格形式布局），
org.apache.log4j.PatternLayout（能够灵活地指定布局模式），
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

  （4）打印参数: Log4J采用相似C语言中的printf函数的打印格式格式化日志信息，以下:

%m   输出代码中指定的消息
%p   输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL 
%r   输出自应用启动到输出该log信息耗费的毫秒数 
%c   输出所属的类目，一般就是所在类的全名 
%t   输出产生该日志事件的线程名 
%n   输出一个回车换行符，Windows平台为“\r\n”，Unix平台为“\n” 
%d   输出日志时间点的日期或时间，默认格式为ISO8601，也能够在其后指定格式，好比：%d{yyyy-MM-dd HH\:mm\:ss}
%l   输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。

5、根据配置文件初始化log4j

log4j可使用3中配置器来初始化：BasicConfigurator,DOMConfigurator,PropertyConfigurator

其语法分别为：

• BasicConfigurator.configure ()： 自动快速地使用缺省Log4j环境。

• PropertyConfigurator.configure ( String configFilename) ：读取使用Java的特性文件编写的配置文件。

• DOMConfigurator.configure ( String filename ) ：读取XML形式的配置文件。

使用PropertyConfigurator适用于全部的系统。以下的语句：   

PropertyConfigurator.configure("log4j.properties");//就以log4j.properties为配置文件初始化好了log4j环境。

对于通常的java project 能够不使用上面的语句初始化log4j，log4j会自动在classpath下，找到配置文件并初始化。若是log4j不能自动初始化配置文件，那么就须要用上面的方法进行初始化。   

注意：初始化配置文件，最好只在系统启动的时候执行一次，若是执行屡次，一是浪费资源，二就是对于老版本的log4j，使用DailyRollingFileAppender时，可能会出现问题。

6、Log4j使用示例

import org.apache.log4j.BasicConfigurator;
import org.apache.log4j.Logger;

public class ApacheLoggerTest {
    static Logger logger = Logger.getLogger(ApacheLoggerTest.class);//在须要使用log4j的地方获取Logger实例

    public static void main(String[] args) {
        //BasicConfigurator.configure();//初始化log4j环境
        logger.error("error_level");
        logger.debug("debug_level");
        logger.info("info_level");
    }
}

  控制台打印信息：

2015-07-23 17:24:18[logger.ApacheLoggerTest-11][main][0] - error_level
2015-07-23 17:24:18[logger.ApacheLoggerTest-12][main][0] - debug_level
2015-07-23 17:24:18[logger.ApacheLoggerTest-13][main][0] - info_level

  在 E:\logTest 目录下会生成一个log4j文件，文件内容：