举例代码如下:
1 public class Test 2 { 3 private static Logger logger = Logger.getLogger(Test.class); 4 5 public static void main(String[] args) 6 { 7 // 加载默认格式的配置文件 8 // BasicConfigurator.configure(); 9 10 // 加载XML格式的配置文件 11 // DOMConfigurator.configure("XML格式的配置文件"); 12 13 // 加载properties格式的配置文件,使用相对路径的话目录是从工程目录开始,并非src或bin 14 Properties props = System.getProperties(); 15 PropertyConfigurator.configure(props.getProperty("user.dir") + props.getProperty("file.separator") + "src" 16 + props.getProperty("file.separator") + "log" + props.getProperty("file.separator") + "log.properties"); 17 18 logger.error("ABCDEFG"); 19 logger.error("HIJKLMN"); 20 } 21 22 }
log.properties文件:
1 ### set log levels[ERROR,WARN,INFO,DEBUG] ### 2 log4j.rootLogger = DEBUG, name1, name2, name3 3 4 ### 输出到控制台 ### 5 log4j.appender.name1 = org.apache.log4j.ConsoleAppender 6 log4j.appender.name1.Target = System.out 7 log4j.appender.name1.layout = org.apache.log4j.PatternLayout 8 log4j.appender.name1.layout.ConversionPattern = %d{ABSOLUTE} %5p %c{1}:%L - %m%n 9 10 ### 输出到日志文件 ### 11 log4j.appender.name2 = org.apache.log4j.DailyRollingFileAppender 12 log4j.appender.name2.File = logs/log.log 13 log4j.appender.name2.Append = true 14 log4j.appender.name2.Threshold = DEBUG 15 log4j.appender.name2.layout = org.apache.log4j.PatternLayout 16 log4j.appender.name2.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}[%t:%r]-[%p]%c : %m%n 17 18 ### 保存异常信息到单独文件 ### 19 log4j.appender.name3 = org.apache.log4j.DailyRollingFileAppender 20 log4j.appender.name3.File = logs/error.log 21 log4j.appender.name3.Append = true 22 log4j.appender.name3.Threshold = ERROR 23 log4j.appender.name3.layout = org.apache.log4j.PatternLayout 24 log4j.appender.name3.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}[%t:%r]-[%p]%c : %m%n
log.log生成的内容如下:
2015-11-06 14:07:31[main:0]-[ERROR]Test : ABCDEFG
2015-11-06 14:07:31[main:2]-[ERROR]Test : HIJKLMN
properties文件参数意义说明:
输出级别的种类。每个Logger都被了一个日志级别,用来控制日志信息的输出。日志级别从高到低分为:
A:OFF 最高等级,用于关闭所有日志记录。
B:FATAL 指出每个严重的错误事件将会导致应用程序的退出。
C:ERROR 指出虽然发生错误事件,但仍然不影响系统的继续运行。
D:WARN 表明会出现潜在的错误情形。
E:INFO 一般和在粗粒度级别上,强调应用程序的运行全程。
F:DEBUG 一般用于细粒度级别上,对调试应用程序非常有帮助。
G:ALL 最低等级,用于打开所有日志记录。
上面这些级别是定义在org.apache.log4j.Level类中。Log4j只建议使用4个级别,优先级从高到低分别是ERROR,WARN,INFO和DEBUG。
配置日志信息输出目的地
log4j.appender.appenderName = fully.qualified.name.of.appender.class(下面5种可选项)
1.org.apache.log4j.ConsoleAppender(控制台)
2.org.apache.log4j.FileAppender(文件)
3.org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
4.org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
5.org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
配置日志信息的格式
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class(下面4种可选项)
1.org.apache.log4j.HTMLLayout(以HTML表格形式布局),
2.org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
3.org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
4.org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
ConsoleAppender选项
Threshold=DEBUG:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
Target=System.err:默认情况下是:System.out,指定输出控制台
FileAppender 选项
Threshold=DEBUF:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
RollingFileAppender 选项
Threshold=DEBUG:指定日志消息的输出最低层次。
ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。
File=mylog.txt:指定消息输出到mylog.txt文件。
Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。
MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。
MaxBackupIndex=2:指定可以产生的滚动文件的最大数。
日志信息格式中几个符号所代表的含义:
-X号: X信息输出时左对齐;
%p: 输出日志信息级别,即DEBUG,INFO,WARN,ERROR,FATAL,
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%r: 输出自应用启动到输出该log信息耗费的毫秒数
%c: 输出日志信息所属的类目,通常就是所在类的全名
%t: 输出产生该日志事件的线程名
%l: 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main (TestLog4.java:10)
%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。
%%: 输出一个"%"字符
%F: 输出日志消息产生时所在的文件名称
%L: 输出代码中的行号
%m: 输出代码中指定的消息,产生的日志具体信息
%n: 输出一个回车换行符,Windows平台为"\r\n",Unix平台为"\n"输出日志信息换行
可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:
1)%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。
2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,"-"号指定左对齐。
3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。
4)%20.30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边较远输出的字符截掉。