Log4j 真的很简单,简单到令人发指的地步。不是要记录日志吗?那就给你一个Log ,然后你用Log 来写东西就行了,先来一个完整类示例:
package test;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class Test {
static Log log = LogFactory.getLog (Test. class );
public void log(){
log .debug( "Debug info." );
log .info( "Info info" );
log .warn( "Warn info" );
log .error( "Error info" );
log .fatal( "Fatal info" );
}
public static void main(String[] args) {
Test test = new Test();
test.log();
}
}
日志等级
Log4j 默认把日志信息分为五个等级
debug < info < warn < error < fatal
虽然可以自己添加等级,但是我觉得没有必要,五个够用了吧!你要写入信息的时候就把信息归为五个等级中的一个,然后调用相应的函数即可。
分五个等级到底有什么用呢?日志信息到底写到哪里去了?
“ LogFactory.getLog (Test. class ) ”又是什么意思捏?接着往下看吧!
继承思想
Log4j 的关键之处在于它的继承思想。也就是一个Log 可以继承另外一个Log 的属性(输出到哪里,日志等级,日志格式等等)。怎么继承?
Log4j 是根据Log 的名字来判断继承关系的,比如:
名字为“com.zhlmmc.lib ”的Log 就是“com.zhlmmc.lib.log ”的parent !Log4j 还有一个rootLogger ,相当于Java 的Object 。
三、回过头来看“ LogFactory.getLog (Test. class ) ”这里的“ Test. class ”事实上传进去的是Test 这个类的完整路径(包名+ 类名),“test.Test ”。这样如果存在“test ”这个Log 那么Test 这个Log 就继承它,否则就继承rootLogger 。
定义属性文件
log4j.rootLogger= info, stdout
log4j.appender.stdout= org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout= org.apache.log4j.PatternLayout
Pattern to output the caller’s file name and line number.
log4j.appender.stdout.layout.ConversionPattern= %5p [%t] (%F : %L) - %m%n
分析一下:
第一行,配置log4j.rootLogger 你明白吧。应为它是根,总得配置一下,否则别的Log 继承什么啊。其他的Log 可以配置也可以不配置。等号后面的第一个参数表示日志级别,可以填五个级别中的一种,后面的参数都是让Log 知道输出到哪里,如果你想让日志输出到两个地方就加两个输出参数,比如:
log4j.rootLogger= info, stdout, file
这里的info 表示,该Log 的日志级别为info ,所有级别小于info 的日志都不会被记录。比如使用这个配置文件的话,我刚开始举的那个类中
log .debug( “Debug info.” );
这句话是不起作用的,因为debug 的级别小于info 。这样就很容易控制什么信息在调试的时候要显示,什么信息在发布的时候要去掉。这些都不用改代码,很方便吧。
但,stdout 和file 又是什么呢?
接着往下看,就是配置stdout 了,这个名字是随便取的,你可以叫它A :
log4j.appender.A= org.apache.log4j.ConsoleAppender
那么上面的rootLogger 的参数stdout 也要改成A ,其他用到的地方当然也要改。这里的关键不是名字,而是appender 类型,比如这里的“ ConsoleAppender ”,看明白了吧,输出到Console 。后面两行都是设置日志格式的,一般情况下你就照抄吧。
在实际的项目开发中,很可能遇到所引用的包用Log4j 来记录日志,比如Hibernate 。那么在这里你可以很容易的控制这个包如何记录日志。比如在上面的配置文件中加一行:
log4j.logger.org.hibernate=fatal
那么所有org.hibernate 包下面的类就只会显示很少的信息,因为fatal 的级别最高啊。
部署
把log4j 的包和commons-logging 的包(加在一起才两个)放到classpath 下面。然后把配置文件保存为log4j.properties ,也放在classpath 下面(如果用Eclipse 的话,放在src 目录下即可)。然后你就可以跑了。
在加载的过程中,程序会读取/WEB-INF/log4j.properties 这个文件。
配置文件讲解如下 :
#log4j 中有五级logger FATAL ERROR WARN INFODEBUG
# 配置根Logger ,其语法为:
#log4j.rootLogger = [ level ] , appenderName, appenderName, …
log4j.rootLogger=INFO, A1 ,R
# 这一句设置会把所有级别的log 都输出
# 如果为log4j.rootLogger=WARN, 则意味着只有WARN,ERROR,FATAL 被输出,DEBUG,INFO 将被屏蔽掉.
# A1 is set to be a ConsoleAppender.
#log4j 中Appender 有几层如控制台、文件、GUI 组件、甚至是套接口服务器、NT 的事件记录器、UNIX Syslog 守护进程等
#ConsoleAppender 输出到控制台
log4j.appender.A1=org.apache.log4j.ConsoleAppender
# A1 使用的输出布局,其中log4j 提供4 种布局. org.apache.log4j.HTMLLayout (以HTML 表格形式布局)
#org.apache.log4j.PatternLayout (可以灵活地指定布局模式),
#org.apache.log4j.SimpleLayout (包含日志信息的级别和信息字符串),
#org.apache.log4j.TTCCLayout (包含日志产生的时间、线程、类别等等信息)
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
# 灵活定义输出格式 具体查看log4j javadoc org.apache.log4j.PatternLayout
#d 时间 ....
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n
#R 输出到文件 RollingFileAppender 的扩展,可以提供一种日志的备份功能。
log4j.appender.R=org.apache.log4j.RollingFileAppender
# 日志文件的名称
log4j.appender.R.File=log4j.log
# 日志文件的大小
log4j.appender.R.MaxFileSize=100KB
保存一个备份文件
log4j.appender.R.MaxBackupIndex=1
log4j.appender.R.layout=org.apache.log4j.TTCCLayout
log4j.appender.R.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n
level : 是日志记录的优先级,分为OFF 、FATAL 、ERROR 、WARN 、INFO 、DEBUG 、ALL 或者您定义的级别。
Log4j 建议只使用四个级别,优先级从高到低分别是ERROR 、WARN 、INFO 、DEBUG 。
Log4jTest.java 中的Logger logger = Logger.getLogger(this.getClass().getName()); 可能对应了log4j.rootLogger=DEBUG,CONSOLE,A1 的配置
log4j.rootLogger = DEBUG,CONSOLE,A1
log4j.addivity.org.apache = true
将DAO 层log 记录到DAOLog,allLog 中;代码中使用Logger logger = Logger.getLogger(“DAO”) 来获得此配置;
log4j.logger.DAO = DEBUG,A2
应用于控制台
log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
本处设置为”WARN” 以上级别在控制台输出( 默认情况使用rootLogger 中的设置)
log4j.appender.CONSOLE.Threshold = WARN
log4j.appender.CONSOLE.Target = System.out
log4j.appender.CONSOLE.Encoding = GBK
log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern = [framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
每天新建日志
log4j.appender.A1 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File = C:/log4j/website.log
log4j.appender.A1.Encoding = GBK
log4j.appender.A1.Threshold = DEBUG
log4j.appender.A1.DatePattern = ‘.’yyyy-MM-dd
log4j.appender.A1.layout = org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}: %L: %m%n
A2– 打印到文件DAOLog 中– 专门为DAO 层服务
log4j.appender.A2 = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A2.file = C:/log4j/DAOLog.log
log4j.appender.A2.DatePattern = ‘.’yyyy-MM-dd
log4j.appender.A2.layout = org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method: %l : %m%n
# %n 代表换行
# %d 代表日期
# %c 代表路径名 (Logger.getLogger("DAO") 时为 DAO: ,Logger.getLogger(this.getClass().getName()) 时为绝对类名 )
# %c{1} 为类名,如Log4jTest
# %l 代表类路径及代码所在行数,%L 仅代表代码所在行数
# [%-5p] 代表该日志对应的日志级别(%5p ),如DEBUG,ERROR ,中间的- 起到在[] 中左对齐的作用
# %m 代表“类名: ”(Logger.getLogger("DAO") 时为DAO: ,Logger.getLogger(this.getClass().getName()) 时为类名)及日志信息
#----------------------------------------------------------------------------------
# 分别说明如下:
#1 、使用Logger logger = Logger.getLogger("DAO") 获得配置时,属性文件中必须要有对应设置:log4j.logger.DAO=DEBUG,A2
#2 、%c 为DAO
#3 、%l 为logger.debug("DAO: Debug info."); 的类绝对路径以及代码所在行,
# log.DAOlogTest.doGet(DAOlogTest.java:23)
#4 、%L 为logger.debug("DAO: Debug info."); 代码所在行 23
#5 、%m 为类名和日志信息 DAO: Debug info.
#1 、使用Logger logger = Logger.getLogger(this.getClass().getName()) 获得配置时
#2 、%c 为log.Log4jTest %c{1} 为Log4jTest
#3 、%l 为 log.Log4jTest.doGet(Log4jTest.java:23)
#4 、%L 同上
#5 、%m 为 Debug info.
#
#
# -X 号: X 信息输出时左对齐;
#%p: 日志信息级别
#%d{}: 日志信息产生时间
#%c: 日志信息所在地(类名)
#%m: 产生的日志具体信息
#%n: 输出日志信息换行
日志目录默认情况为 tomcat_home ,
可以通过 log4j.appender.A1.File = webapps//Hibernate_Web//logs//website.log 设置相对路径的日志目录
--------------------------------------------------
为了能够清楚的看到系统启动的情况,以及一些信息,在项目中使用Log4j功能
log4j.properties文件为:(为了使tomcat能够看着干净点,我ConsoleAppender的等级设置为FATAL,具体的详细日志可以在%TOMCAT_HOME%下的log4j.log中)
log4j.rootLogger=INFO, A1, R
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.Threshold=FATAL
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n
R 输出到文件 RollingFileAppender的扩展,可以提供一种日志的备份功能。
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
log4j.appender.R.File=log4j.log
log4j.appender.R.Encoding=GBK
log4j.appender.R.Threshold=INFO
log4j.appender.R.DatePattern=’.’yyyy-MM-dd
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm} %5p %c{1}: %L: %m%n