log4j详解

我们可以在log4j.properies配置文件看到以下属性：
#定义输出级别和输出平台
log4j.rootLogger=INFO,stdout,fileout
#设定stdout输出平台
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[%-5p][%d{yyyy-MM-dd HH:mm:ss}][%l]:%m%n
#每天一个日志文件
log4j.appender.fileout=org.apache.log4j.DailyRollingFileAppender
log4j.appender.fileout.File=test.log
log4j.appender.fileout.layout=org.apache.log4j.PatternLayout
log4j.appender.fileout.layout.ConversionPattern=[%-5p][%d{yyyy-MM-dd HH:mm:ss}][%l]:%m%n
#对不同的package定义不同的输出级别
log4j.logger.com.daniel.test=DEBUG


分析：log4j.properies定义一般分3部分：
log4j.rootLogger（必须）、log4j.appender（必须）、log4j.logger(不必须)


1、log4j.rootLogger


这个配置是必须的，它的定义格式：


log4j.rootLogger = level  , appenderName, appenderName, …


lelve是定义的输出级别，低于该级别的将不会输出，主要级别有OFF、ALL、FATAL、ERROR、WARN、INFO、DEBUG或自定义级别，其中OFF设定的话将不输出任何信息，ALL设定的话将输出所有信息；另外5个的级别FATAL>ERROR>WARN>INFO>DEBUG，如果你的lenel设定为INFO，那么不能输出DEBUG信息；


appenderName是指定日志信息输出到哪个地方，控制台，文件等等，可同时指定多个输出目的地。


2、log4j.appender


这个也是必须配置的，它是负责控制日志记录操作的输出。它的定义格式如下：


log4j.appender.appenderName=someAppender(选择一种输出平台)
[log4j.appender.appenderName.File=文件名](文件输出定义路径)
log4j.appender.appenderName.layout=输出布局
log4j.appender.appenderName.layout.ConversionPattern=输出格式


log4j.appender.appenderName指定输出appender，Log4J提供了一下几种appender：


a),org.apache.log4j.ConsoleAppender（控制台）
b),org.apache.log4j.FileAppender（文件）
c),org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）
d),org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件，可通过log4j.appender.R.MaxFileSize=100KB设置文件大小，还可通过log4j.appender.R.MaxBackupIndex=1设置为保存一个备份文件）。
e),org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）


log4j.appender.appenderName.layout指定日志信息的格式（布局）Layout，它负责格式化Appender的输出。Log4j提供的layout有以下几种：


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


log4j.appender.appenderName.layout.ConversionPattern格式化日志信息，Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下：


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


3，log4j.logger


这个不是必需的，如果不配置这个，则采用log4j.rootLogger的level级别。它主要是具体到package、Class级别的info，它的定义格式如下：


log4j.logger.packageName[.ClassName]=level[,appender]


它也可以输出到指定的appender，也可以不指定输出到默认appender。


4，log4j的使用


a)、从www.apache.org下载commongs-logging包；


b)、在你的class里面定义protected final Log logger = LogFactory.getLog(this.getClass());
c)、在需要日志输出的地方logger.info(...),logger.error(...),logger.debug(...),....注意，在使用时前最好做个判断if (logger.isDebugEnabled()){logger.debug("...");}其他类似。






附加一个较全面的配置文件作为参考




  
Log4j配置文件实现了输出到控制台、文件、回滚文件、发送日志邮件、输出到数据库日志表、自定义标签等全套功能。  
log4j.rootLogger=DEBUG,console,dailyFile,im  
log4j.additivity.org.apache=true  
# 控制台(console)  
log4j.appender.console=org.apache.log4j.ConsoleAppender  
log4j.appender.console.Threshold=DEBUG  
log4j.appender.console.ImmediateFlush=true  
log4j.appender.console.Target=System.err  
log4j.appender.console.layout=org.apache.log4j.PatternLayout  
log4j.appender.console.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
  
# 日志文件(logFile)  
log4j.appender.logFile=org.apache.log4j.FileAppender  
log4j.appender.logFile.Threshold=DEBUG  
log4j.appender.logFile.ImmediateFlush=true  
log4j.appender.logFile.Append=true  
log4j.appender.logFile.File=D:/logs/log.log4j  
log4j.appender.logFile.layout=org.apache.log4j.PatternLayout  
log4j.appender.logFile.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
# 回滚文件(rollingFile)  
log4j.appender.rollingFile=org.apache.log4j.RollingFileAppender  
log4j.appender.rollingFile.Threshold=DEBUG  
log4j.appender.rollingFile.ImmediateFlush=true  
log4j.appender.rollingFile.Append=true  
log4j.appender.rollingFile.File=D:/logs/log.log4j  
log4j.appender.rollingFile.MaxFileSize=200KB  
log4j.appender.rollingFile.MaxBackupIndex=50  
log4j.appender.rollingFile.layout=org.apache.log4j.PatternLayout  
log4j.appender.rollingFile.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
# 定期回滚日志文件(dailyFile)  
log4j.appender.dailyFile=org.apache.log4j.DailyRollingFileAppender  
log4j.appender.dailyFile.Threshold=DEBUG  
log4j.appender.dailyFile.ImmediateFlush=true  
log4j.appender.dailyFile.Append=true  
log4j.appender.dailyFile.File=D:/logs/log.log4j  
log4j.appender.dailyFile.DatePattern='.'yyyy-MM-dd  
log4j.appender.dailyFile.layout=org.apache.log4j.PatternLayout  
log4j.appender.dailyFile.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
# 应用于socket  
log4j.appender.socket=org.apache.log4j.RollingFileAppender  
log4j.appender.socket.RemoteHost=localhost  
log4j.appender.socket.Port=5001  
log4j.appender.socket.LocationInfo=true  
# Set up for Log Factor 5  
log4j.appender.socket.layout=org.apache.log4j.PatternLayout  
log4j.appender.socket.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
# Log Factor 5 Appender  
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender  
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000  
# 发送日志到指定邮件  
log4j.appender.mail=org.apache.log4j.net.SMTPAppender  
log4j.appender.mail.Threshold=FATAL  
log4j.appender.mail.BufferSize=10  
log4j.appender.mail.From = xxx@mail.com  
log4j.appender.mail.SMTPHost=mail.com  
log4j.appender.mail.Subject=Log4J Message  
log4j.appender.mail.To= xxx@mail.com  
log4j.appender.mail.layout=org.apache.log4j.PatternLayout  
log4j.appender.mail.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
# 应用于数据库  
log4j.appender.database=org.apache.log4j.jdbc.JDBCAppender  
log4j.appender.database.URL=jdbc:mysql://localhost:3306/test  
log4j.appender.database.driver=com.mysql.jdbc.Driver  
log4j.appender.database.user=root  
log4j.appender.database.password=  
log4j.appender.database.sql=INSERT INTO LOG4J (Message) VALUES('=[%-5p] %d(%r) --> [%t] %l: %m %x %n')  
log4j.appender.database.layout=org.apache.log4j.PatternLayout  
log4j.appender.database.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  
  
# 自定义Appender  
log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender  
log4j.appender.im.host = mail.cybercorlin.net  
log4j.appender.im.username = username  
log4j.appender.im.password = password  
log4j.appender.im.recipient = corlin@cybercorlin.net  
log4j.appender.im.layout=org.apache.log4j.PatternLayout  
log4j.appender.im.layout.ConversionPattern=[%-5p] %d(%r) --> [%t] %l: %m %x %n  




log4j的强大功能无可置疑，但实际应用中免不了遇到某个功能需要输出独立的日志文件的情况，怎样才能把所需的内容从原有日志中分离，形成单独的日志文件呢？其实只要在现有的log4j基础上稍加配置即可轻松实现这一功能。  
　　先看一个常见的log4j.properties文件，它是在控制台和myweb.log文件中记录日志：  
log4j.rootLogger=DEBUG, stdout, logfile  
   
log4j.category.org.springframework=ERROR  
log4j.category.org.apache=INFO  
   
log4j.appender.stdout=org.apache.log4j.ConsoleAppender  
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout  
log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n  
   
log4j.appender.logfile=org.apache.log4j.RollingFileAppender  
log4j.appender.logfile.File=${myweb.root}/WEB-INF/log/myweb.log  
log4j.appender.logfile.MaxFileSize=512KB  
log4j.appender.logfile.MaxBackupIndex=5  
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout  
log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - %m%n  
　　  
如果想对不同的类输出不同的文件(以cn.com.Test为例)，先要在Test.java中定义:  
private static Log logger = LogFactory.getLog(Test.class);  
　　然后在log4j.properties中加入:  
log4j.logger.cn.com.Test= DEBUG, test  
log4j.appender.test=org.apache.log4j.FileAppender  
log4j.appender.test.File=${myweb.root}/WEB-INF/log/test.log  
log4j.appender.test.layout=org.apache.log4j.PatternLayout  
log4j.appender.test.layout.ConversionPattern=%d %p [%c] - %m%n  
　　也就是让cn.com.Test中的logger使用log4j.appender.test所做的配置。  
   
　　但是，如果在同一类中需要输出多个日志文件呢？其实道理是一样的，先在Test.java中定义:  
private static Log logger1 = LogFactory.getLog("myTest1");  
private static Log logger2 = LogFactory.getLog("myTest2");  
　　然后在log4j.properties中加入:  
log4j.logger.myTest1= DEBUG, test1  
log4j.appender.test1=org.apache.log4j.FileAppender  
log4j.appender.test1.File=${myweb.root}/WEB-INF/log/test1.log  
log4j.appender.test1.layout=org.apache.log4j.PatternLayout  
log4j.appender.test1.layout.ConversionPattern=%d %p [%c] - %m%n  
　　  
log4j.logger.myTest2= DEBUG, test2  
log4j.appender.test2=org.apache.log4j.FileAppender  
log4j.appender.test2.File=${myweb.root}/WEB-INF/log/test2.log  
log4j.appender.test2.layout=org.apache.log4j.PatternLayout  
log4j.appender.test2.layout.ConversionPattern=%d %p [%c] - %m%n  
　　也就是在用logger时给它一个自定义的名字(如这里的"myTest1")，然后在log4j.properties中做出相应配置即可。别忘了不同日志要使用不同的logger(如输出到test1.log的要用logger1.info("abc"))。  
   
　　还有一个问题，就是这些自定义的日志默认是同时输出到log4j.rootLogger所配置的日志中的，如何能只让它们输出到自己指定的日志中呢？别急，这里有个开关：  
log4j.additivity.myTest1 = false  
　　它用来设置是否同时输出到log4j.rootLogger所配置的日志中，设为false就不会输出到其它地方啦！注意这里的"myTest1"是你在程序中给logger起的那个自定义的名字！  
如果你说，我只是不想同时输出这个日志到log4j.rootLogger所配置的logfile中，stdout里我还想同时输出呢！那也好办，把你的log4j.logger.myTest1 = DEBUG, test1改为下式就OK啦！  
log4j.logger.myTest1=DEBUG, test1