需要的jar包:log4j-1.2.17.jar
先举个例子:
一、在工程根目录下创建一个log4j.properties文件,在文件中写入下面内容
log4j.rootLogger=debug,stdout,debug,error
#输出信息到控制台
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.Threshold = DEBUG
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
#输出DEBUG以上级别的日志到E://logs/debug.log
log4j.appender.debug = org.apache.log4j.DailyRollingFileAppender
log4j.appender.debug.File = E://logs/debug.log
log4j.appender.debug.Append = true
log4j.appender.debug.Threshold = info
log4j.appender.debug.layout = org.apache.log4j.PatternLayout
log4j.appender.debug.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
#输出ERROR以上级别的日志到E://logs/error.log
log4j.appender.error = org.apache.log4j.DailyRollingFileAppender
log4j.appender.error.File =E://logs/error.log
log4j.appender.error.Append = true
log4j.appender.error.Threshold = ERROR
log4j.appender.error.layout = org.apache.log4j.PatternLayout
log4j.appender.error.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
二、创建测试类
package demo;
import org.apache.log4j.BasicConfigurator;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
public class Demo {
private static Logger logger = Logger.getLogger(Demo.class);
static {
// 自动快速地使用缺省Log4j环境。
BasicConfigurator.configure();
// 读取使用Java的特性文件编写的配置文件。
PropertyConfigurator.configure("log4j.properties");
}
public static void main(String[] args) {
// 记录debug级别的信息
logger.debug("This is debug message.");
// 记录info级别的信息
logger.info("This is info message.");
// 记录error级别的信息
logger.error("This is error message.");
}
}
三、输出结果
控制台输出:
[DEBUG] 2016-01-21 00:17:41,111 method:demo.Demo.main(Demo.java:19)
This is debug message.
[INFO ] 2016-01-21 00:17:41,114 method:demo.Demo.main(Demo.java:21)
This is info message.
[ERROR] 2016-01-21 00:17:41,115 method:demo.Demo.main(Demo.java:23)
This is error message.
2016-01-21 00:17:41 [ main:0 ] - [ DEBUG ] This is debug message.
2016-01-21 00:17:41 [ main:3 ] - [ INFO ] This is info message.
2016-01-21 00:17:41 [ main:4 ] - [ ERROR ] This is error message.
2016-01-21 00:17:41 [ main:4 ] - [ ERROR ] This is error message.
下面详细解说log4j.properties文件的配置
1、配置根Logger
用法为log4j.rootLogger=[level],appenderName1,appenderName
appenderName就是上述的log4j.rootLogger=debug,stdout,debug,error中的stdout,debug(第二个),error.
注意,这里的第一个debug不是appenderName,而是level。
level表示的是日志记录的优先级,log4j一般建议只是用4个,级别由高到低分别是:ERROR,WARNING,INFO,DEBUG.比如level定义为info,则该日志只记录info级别以上的日志,即debug级别的日志不会被打印出来。此处的level参数可以省略不写,默认为debug,但开头的那个‘,’(逗号)不能省略.
2、配置appender的输出位置,如下例子
log4j.appender.stdout = org.apache.log4j.ConsoleAppender(输出到控制台)
log4j.appender.debug = org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
log4j.appender.error = org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
其中stdout ,debug ,error是根Logger中定义的appenderName
log4j提供的appender由如下4种:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
3、配置日志信息的格式(布局),如下例子:
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
log4j.appender.debug.layout = org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
log4j.appender.error.layout = org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
log4j提供了以下4种layout:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
log4j.appender.debug.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n指定日志的格式
Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下: %m 输出代码中指定的消息
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符,Windows平台为“rn”,Unix平台为“n”
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2012年11月20日 22:11:23,421
%l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:30)
4、其他配置
log4j.appender.stdout.Threshold,表示么该日志记录的门槛
比如log4j.appender.error.Threshold = INFO,表示该日志文件只记录info级别以上的日志信息,即不记录debug级别的日志
log4j.appender.debug.Append = true表示在日志文件后面添加,为false时新的日志信息会覆盖原日志信息
log4j.appender.error.File =E://logs/error.log 表示日志的存储位置
5、在代码中使用log4j
package demo;
import org.apache.log4j.BasicConfigurator;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
public class Demo {
private static Logger logger = Logger.getLogger(Demo.class);
static {
// 自动快速地使用缺省Log4j环境。
BasicConfigurator.configure();
// 读取使用Java的特性文件编写的配置文件。
PropertyConfigurator.configure("log4j.properties");
}
public static void main(String[] args) {
// 记录debug级别的信息
logger.debug("This is debug message.");
// 记录info级别的信息
logger.info("This is info message.");
// 记录error级别的信息
logger.error("This is error message.");
}
}