Log4j的组成
Log4j由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式。
日志信息的优先级从高到低有ERROR、WARN、 INFO、DEBUG,分别用来指定这条日志信息的重要程度;
日志信息的输出目的地指定了日志将打印到控制台还是文件中;
而输出格式则负责格式化日志信息的输出内容。
1. 定义配置文件
Log4j有两种设置方式,一是通过代码进行动态配置,但是该方式的明显缺点是:如果需要修改日志输出级别等信息,则必须修改java文件,然后重新编译,很是麻烦;二是通过配置文件的方式,这种将使您的应用程序更加灵活。目前支持两种格式的配置文件:
- xml文件
- properties文件(推荐),本文以此种方式进行说明。
1.1 定义根Logger
语法:log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中:
level:表示日志的优先级。
appenderName:表示日志信息输出到哪个地方,可以同时指定多个输出目的地。
补充:日志的优先级别(从高到低)
A:off 最高等级,用于关闭所有日志记录。
B:fatal 指出每个严重的错误事件将会导致应用程序的退出。
C:error 指出虽然发生错误事件,但仍然不影响系统的继续运行。
D:warm 表明会出现潜在的错误情形。
E:info 一般和在粗粒度级别上,强调应用程序的运行全程。
F:debug 一般用于细粒度级别上,对调试应用程序非常有帮助。
G:all 最低等级,用于打开所有日志记录。
1.2 配置日志信息输出目的地
语法:
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.optionN = valueN
其中,Log4j提供的appender有以下几种:
- org.apache.log4j.ConsoleAppender(控制台)
- org.apache.log4j.FileAppender(文件)
- org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
- org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
- org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
1.3 配置日志信息的格式(布局)
语法:
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采用类似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},输出类似:2002年10月18日 22:10:28,921
%l
输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)