Log4j最简入门及实例
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 log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.R.layout=org.apache.log4j.TTCCLayout |
# 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