Log4j使用教程

需要的jar包：log4j-1.2.17.jar

先举个例子：

一、在工程根目录下创建一个log4j.properties文件，在文件中写入下面内容

log4j.rootLogger=debug,stdout,debug,error#输出信息到控制台log4j.appender.stdout = org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.Target = System.outlog4j.appender.stdout.layout = org.apache.log4j.PatternLayoutlog4j.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.loglog4j.appender.debug = org.apache.log4j.DailyRollingFileAppenderlog4j.appender.debug.File = E://logs/debug.loglog4j.appender.debug.Append = truelog4j.appender.debug.Threshold = info log4j.appender.debug.layout = org.apache.log4j.PatternLayoutlog4j.appender.debug.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n#输出ERROR以上级别的日志到E://logs/error.loglog4j.appender.error = org.apache.log4j.DailyRollingFileAppenderlog4j.appender.error.File =E://logs/error.log log4j.appender.error.Append = truelog4j.appender.error.Threshold = ERROR log4j.appender.error.layout = org.apache.log4j.PatternLayoutlog4j.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.

E://logs/debug.log的内容为：

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.

E://logs/error.log 的内容为：

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.");}}

日志信息可以记录在多个位置，只要在配置文件log4j.properties中进行配置就行了，此例子将日志信息分别记录到了就是在E://logs/error.log ，E://logs/debug.log和控制台