项目中log4j.properties使用详解
???? 项目中大部分都会用到log4j.properties,确实很好使。但每次打开的时候,看到的是一大堆无字天书,看不懂,现在得空研究了一下,做一下分享,这里面汲取了javaEye中其他博友的帮助,再次O(∩_∩)O谢谢了、
?
注意:红色部分都为重要信息。
1.输出级别:
? ERROR、WARN、INFO、DEBUG、FATAL、OFF
ERROR:严重错误,主要是程序的错误
WARN:一般警告,比如:seesion丢失
INFO:一般要显示的信息,比如:登录
DEBUG:程序调试信息
?
log4j建议使用以上四种带注释的,即ERROR、WARN、INFO、DEBUG。
2.log4j的具体使用实例
log4j.rootCategory=INFO, CONSOLE, LOGFILE
#输出到控制台
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.Threshold=DEBUG
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=- %m%n
#每天生成一个日志文件
log4j.appender.LOGFILE=org.apache.log4j.DailyRollingFileAppender
log4j.appender.LOGFILE.DatePattern='.'yyyy-MM-dd
log4j.appender.LOGFILE.Append=true
log4j.appender.LOGFILE.Threshold=WARN
log4j.appender.LOGFILE.File=logs/log
log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
#在日志中显示sql语句
log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql.Statement=debug
log4j.logger.java.sql.PreparedStatement=debug
log4j.logger.java.sql.ResultSet=info
log4j.logger.javax.sql=info
log4j.logger.com.ibatis=debug
log4j.logger.com.ibatis.common.jdbc.SimpleDataSource=debug
log4j.logger.com.ibatis.common.jdbc.ScriptRunner=debug
首先:必须先在程序中导入两个jar包:commons-logging.jar,logging-log4j-1.2.9.jar.
$1、定义输出目的地
?? log4j.rootLogger或者log4j.rootCategory=[level],A1,B2,C3...
两者区别:在早期log4j版本中,org.apache.Category实现了记录器的功能,所谓人往高处走水往低处流,log4j也做的要越来越好,它使用logger扩展了Category类,因此目前这两个可以通用的。(个人建议使用log4j.rootLogger)
$2、输出目的地的类型? log4j.appender.A1=以下类
? 1、org.apache.log4j.ConsoleAppender?????????? 输出到控制台
? 2、org.apache.log4j.DailyRollingFileAppender? 每天生成一个日志文件
? 3、org.apache.log4j.RollingFileAppender?????? 文件达到制定的尺寸会产生一个新的文件
? 4、org.apache.log4j.FileAppender????????????? 输出到文件
? 5、org.apache.log4j.WriterAppender??????????? 把日志文件以流的形式发送到任意指定的地方\
? (imp)每种布局格式的常用属性详解
???? $2-1(org.apache.log4j.ConsoleAppender)、
???? ??? ??? log4j.appender.A1=org.apache.log4j.ConsoleAppender
?????? (1)log4j.appender.A1.Threshold=日志输出级别(如:ERROR,WARN等)? 【指定消息的最低输出层次】
?????? (2)log4j.appender.A1.ImmediateFlush=true|false???? 默认为true??? 【表所有的信息都会立即示输出】
?????? (3)log4j.appender.A1.Target=System.err|System.out? 默认为System.out? ??? ??? 【指定输出到控制台】
???? $2-2(org.apache.log4j.DailyRollingFileAppender)、
??????? log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
?????? (1)log4j.appender.A1.Threshold=日志输出级别(如:ERROR,WARN等)? 【指定消息的最低输出层次】
?????? (2)log4j.appender.A1.ImmediateFlush=true|false???? 默认为true??? 【表所有的信息都会立即示输出】
?????? (3)log4j.appender.A1.File=a.log? (a.log为文件名) 【把日志信息输出到a.log文件,默认是从web服务器的根路径开始】
?????? (4)DatePattern='.'yyyy-ww:每周滚动一次文件,即每周产生一个新的文件。也可以指定按月、周、天、时和分,
???????? 对应的格式如下:
????????? 1)'.'yyyy-MM: 每月
????????? 2)'.'yyyy-ww: 每周
????????? 3)'.'yyyy-MM-dd: 每天
????????? 4)'.'yyyy-MM-dd-a: 每天a次
????????? 5)'.'yyyy-MM-dd-HH: 每小时
????????? 6)'.'yyyy-MM-dd-HH-mm: 每分钟
??? ??? ?$2-3(org.apache.log4j.RollingFileAppender)
??? ??? ????? log4j.appender.A1=org.apache.log4j.RollingFileAppender
??? ??? ?? (1)log4j.appender.A1.Threshold=日志输出级别(如:ERROR,WARN等)? 【指定消息的最低输出层次】
?????? (2)log4j.appender.A1.ImmediateFlush=true|false???? 默认为true??? 【表所有的信息都会立即示输出】
?????? (3)log4j.appender.A1.File=a.log? (a.log为文件名) 【把日志信息输出到a.log文件,默认是从web服务器的根路径开始】
?????? (4)log4j.appender.A1.Append=true|false? 默认为true? 【true将消息增加到指定文件中,false指将消息覆盖指定的文件内容】
?????? (5)log4j.appender.A1.MaxFileSize=100KB 后缀可以为MB,GB。日志文件达到该大小时,将会自动滚动,将原来内容移动到a.log.1文件、
??? ??? ???? ?(6)log4j.appender.A1.MaxBackupIndex=1|2|3....? 指可以产生的滚动文件的最大数
??? ??? ?$2-4(org.apache.log4j.FileAppender)
??? ??? ????? log4j.appender.A1=org.apache.log4j.FileAppender
??? ??? ?? (1)log4j.appender.A1.Threshold=日志输出级别(如:ERROR,WARN等)? 【指定消息的最低输出层次】
?????? (2)log4j.appender.A1.ImmediateFlush=true|false???? 默认为true??? 【表所有的信息都会立即示输出】
?????? (3)log4j.appender.A1.File=a.log? (a.log为文件名) 【把日志信息输出到a.log文件,默认是从web服务器的根路径开始;貌似还可以在启动web服务的时候指定文件根目录,这个没有试用过】
$3、配置日志输出的格式 log4j.appender.A1.layout=以下类
? 1、org.apache.log4j.HTMLLayout??????? 以html表格的形式布局
? 2、org.apache.log4j.TTCCLayout??????? 包含日志产生的时间、线程、类别等信息
? 3、org.apache.log4j.PatternLayout???? 可以灵活指定布局格式(这个经常与log4j.appender.A1.layout.ConversionPattern=%-4r %d{yyyy MM dd HH:mm:ss} %m%n)
? 4、org.apache.log4j.SimpleLayout????? 包含日志信息的级别和信息字符串
?
?使用灵活布局格式(PatternLayout),需要指定打印格式ConsersionPattern,具体参数如下:
? %p? 日志的优先级,即:DEBUG,WARN,INFO,ERROR,FAULT
? %m? 代码中指定的信息,产生的日志具体信息
? %n? 换行
? %r? 自应用启动到输出该log信息时耗费的毫秒数
? %c? 日志信息所属的类的全名
? %d? 输出日志的时间,默认为ISO8601 如:2010-04-07 15:19:21,640,也可以在后面指定格式,如:%d{yyyy-MM-dd HH:mm:ss,SSS}
? %L? 输出代码中的行号?
? %F? 产生日志的代码名称
? %t? 产生日志信息的线程名
? %l? 日志事件的位置,相当于%c.%m(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数,举例:Testlog4.main(TestLog4.java:10)。
?
?Ⅰ、也可以在%和参数之间添加数字等,控制其最大、最小宽度以及对齐方式、
? %-20c:输出日志信息所在类的全名,该全名的最小宽度为20,“-”表示左对齐,默认为右对齐。类的全名小于20,就右补空格。
? %.20c:前面加个点,表示该类的全名的最大宽度为20,此时为右对齐,如果长度小于20,也不会左补空格;如果长度超过20,则截取左边超长的部分。写成(%-.20c效果一样),但是你不能写成%.-20c,控制台会原样输出,并且提示这样写有问题,但不影响程序运行、
? %20.50c:表示最小宽度为20,最大宽度为50,如果长度超过50,截取左边超出部分.(测试发现与%-20.50c效果一样,很是郁闷....)
?
?Ⅱ、输出指定包或者指定类中的日志信息
? log4j.logger.com.ibatis.common.jdbc.SimpleDataSource=debug??? 输出com.ibatis.common.jdbc.SimpleDataSource类中的日志信息
? log4j.logger.javax.sql=info???? 输出javax.sql包中的日志信息
? log4j.com.test=warn??????? 你也可以指定你的项目中的包
? log4j.logger.org.springframework=DEBUG??? 输出spring的包里面的日志信息
?
? Ⅲ、在项目的类中使用,需要导入commons-logging.jar
? 然后private final static Log log = LogFactory.getLog(getClass());? 参数为当前类的class
? 在使用日志记录时,可以分等级的去记录,如:log.info("这是基本信息");log.error("这个错误信息");等等
?
------------------------------------------------------我是分割线----------------------------------------
log4j的相对路径配置:
?
?
1、需要在web.xml中添加一个监听器:
?<listener>?
<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>?
</listener>
注意:这个监听器一定要放在前面,放在后面不起作用(具体不知道为什么)
2、需要把项目在tomcat中的路径注入到一个变量中
?
<!-- Log4j的配置(在同一容器中部署多个应用时,不能使用默认的webAppRootKey,必须指定唯一KEY,以免冲突) --><context-param> <param-name>webAppRootKey</param-name> <param-value>XXX.root</param-value></context-param>
?3、在log4j.properties中配置log4j.appender.R.File=${dxmppApi.root}/WEB-INF/xxx.log,你就可以tomcat的项目目录下找到xxx.log文件了。
?
?
再说一下,在项目中,如果log4j不是放在根目录下时候怎么加载它。在web.xml中添加如下代码:
?
<context-param><param-name>log4jConfigLocation</param-name><param-value>/WEB-INF/classes/config/log4j.properties</param-value><!-- 也可以这样写<param-value>classpath:config/log4j.properties</param-value> --></context-param>