已经完结的工程中用到了log4j,抽时间写一篇日志记录下。
//参考文章如下
一、log4j是什么?有什么用?
Log4j是一个日志记录工具,基于java语言的。我们可以将日志信息输出到目的地(eg:控制台、某处文件夹等)。
二、log4j的日志等级
级别由低到高为 debug < info < warn < error < fatal
其详细对应的描述请参考百度百科。
三、log4j配置方法
有三种方法来配置log4j:1>通过.properties文件(我做的项目都采用这种方式);2>通过xml文件;3>通过java代码。
无论采用上述哪种方法,我们都可以定义log4j的三个主要组件:logger、appender和layout。详细介绍三个组件:
1>Logger,它是记录器,负责记录处理日志的大部分操作。
配置语法为
log4j.rootLogger=[level],appenderName1,appenderName2,......
级别如上已经介绍,appenderName是指日志输出地名称,同时可以指定多个输出目的地。
2>Appender,它是日志文件输出地,它负责记录日志操作的输出。
配置语法为
log4j.appender.appenderName = xxxx
log4j.appender.appenderName.option1 = value1
......
log4j.appender.appenderName.optionN = valueN
注意:如上的appenderName为1>中定义的名称,可以任意起名称。
log4j提供的appender有如下几种:
org.apache.log4j.ConsoleAppender(输出到控制台)
org.apache.log4j.FileAppender(输出到文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
举个例子:log4j.appender.stdout = org.apache.log4j.ConsoleAppender
解释:定义一个名为stdout的输出目的地,输出到控制台。
3>Layout,它负责格式化Appender的输出
其语法为
log4j.appender.appenderName.layout = xxxx
log4j.appender.appenderName.layout.option1 = value1
......
log4j.appender.appenderName.layout.optionN = valueN
注意:log4j提供的layout有如下几种:
org.apache.log4j.HTMLLayout(以HTML表格形式布局)
org.apache.log4j.PatternLayout(灵活地指定布局模式)--这种用得最多
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
四、示例详解
如下是我配置的log4j.properties文件
#指定日志级别为DEBUG,因此级别高于debug的info < warn < error < fatal都会被输出来 #指定日志输出地名称:stdout、D和E log4j.rootLogger=DEBUG, stdout, D, E #如下设置我的工程中哪些可能会出现bug的地方 #zhiji.caren.mapper是我工程下的某个文件夹 log4j.logger.com.zhiji.caren.mapper=DEBUG #如下配置sql出现bug的地方 log4j.logger.java.sql.Connection = DEBUG log4j.logger.java.sql.Statement = DEBUG log4j.logger.java.sql.PreparedStatement = DEBUG log4j.logger.java.sql.ResultSet = DEBUG #如下是配置stdout输出地 #名为stdout的输出类型为控制台 log4j.appender.stdout = org.apache.log4j.ConsoleAppender #Target=System.out,输出到控制台 log4j.appender.stdout.Target = System.out #指定布局模式 log4j.appender.stdout.layout = org.apache.log4j.PatternLayout #指定输出打印信息的具体格式 log4j.appender.stdout.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n # 如下是配置D输出地 #指定输出地为文件 log4j.appender.D = org.apache.log4j.DailyRollingFileAppender #文件的路径为该项目根目录下的/WEB-INF/logs/debug.log log4j.appender.D.File = ${webapp.root}/WEB-INF/logs/debug.log #DatePattern="."yyyy-MM意思:每月滚动一次日志文件,即每月产生一个新的日志文件。 #当前月的日志文件名为debug.log4j,前一个月的日志文件名为debug.log4j.yyyy-MM。 log4j.appender.D.DatePattern = "."yyyy-MM #Append = true意思:将消息增加到指定文件中,false指将消息覆盖指定的文件内容。 log4j.appender.D.Append = true #Threshold=DEBUG:指定日志消息的输出最低层次。 log4j.appender.D.Threshold = DEBUG #指定布局模式 log4j.appender.D.layout = org.apache.log4j.PatternLayout #指定输出打印信息的具体格式 log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n # 如下是配置E输出地 --详细介绍参考D介绍 log4j.appender.E = org.apache.log4j.DailyRollingFileAppender log4j.appender.E.File = ${webapp.root}/WEB-INF/logs/error.log log4j.appender.E.Append = true log4j.appender.E.DatePattern = "."yyyy-MM log4j.appender.E.Threshold = ERROR log4j.appender.E.layout = org.apache.log4j.PatternLayout log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
备注:如果将多个工程都挂在一个tomcat下时,且这些工程都配了log4j时,这时会报错webappkey的唯一性问题,因此,这里配置webapp.root时,最好是配成 自己的项目名称.root,这样,log4j文件就会产生在各自项目/WEB-INF/logs/xx.log下。