使用Log4J可以控制日志信息输送的目的地,包括控制台,文件,GUI组件和NT事件记录器,也可以控制每一条日志的输出格式,或通过定义每一条日志信息的级别,更加细致地控制日志的生成过程。
Logger(日志记录器)
控制要启用或禁用哪些日志记录语句,并对日志信息进行级别限制。Logger被指定为实体,由一个String类的名字识别。Logger的名字是大小写敏感的,且名字之间具有继承关系,子名用父名作为前缀,用点“.”分隔,例如x.y是x.y.z的父级。root Logger(根Logger)是所有Logger的祖先,它总是存在的而且不可以通过名字获得。
配置root Logger的语法为:
log4j.rootLogger=[log level],appenderName,appenderName,...
配置自定义Logger组件的语法为:
log4j.logger.loggerName=[log level],appenderName,appenderName,...
每个Logger都一个日志级别(log level),用来控制日志信息的输出。
排序 | 级别 | 说明 |
A | off | 最高等级,用于关闭所有日志记录。 |
B | fatal | 指出每个严重的错误事件将会导致应用程序的退出。 |
C | error | 指出虽然发生错误事件,但仍然不影响系统的继续运行。 |
D | warm | 表明会出现潜在的错误情形。 |
E | info | 一般和在粗粒度级别上,强调应用程序的运行全程。 |
F | debug | 一般用于细粒度级别上,对调试应用程序非常有帮助。 |
G | all | 最低等级,用于打开所有日志记录。 |
上面这些级别是定义在org.apache.log4j.Level类中。Log4j只建议使用4个级别,优先级从高到低分别是error,warn,info和debug。通过使用日志级别,可以控制应用程序中相应级别日志信息的输出。例如,如果使用info级别,则应用程序中所有低于info级别的日志信息(如debug)将不会被打印出来。
Appenders(输出端)
用来指定日志信息输出到哪个地方,可以同时指定多个输出目的地。Log4j允许将信息输出到许多不同的输出设备中,一个log信息输出目的地就叫做一个Appender。
每个Logger都可以拥有一个或多个Appender,每个Appender表示一个日志的输出目的地。可以使用Logger.addAppender(Appender app)为Logger增加一个Appender,也可以使用Logger.removeAppender(Appender app)为Logger删除一个Appender。
输出设备 | 说明 |
org.apache.log4j.ConsoleAppender | 将日志信息输出到控制台。 |
org.apache.log4j.FileAppender | 将日志信息输出到一个文件。 |
org.apache.log4j.DailyRollingFileAppender | 将日志信息输出到一个日志文件,并且每天输出到一个新的日志文件。 |
org.apache.log4j.RollingFileAppender | 将日志信息输出到一个日志文件,并且指定文件的尺寸,当文件大小达到指定尺寸时,会自动把文件改名,同时产生一个新的文件。 |
org.apache.log4j.WriteAppender | 将日志信息以流格式发送到任意指定地方。 |
org.apache.log4j.jdbc.JDBCAppender | 通过JDBC把日志信息输出到数据库中。 |
Layout(日志布局)
输出布局 | 说明 |
HTMLLayout | 格式化日志输出为HTML表格形式 |
SimpleLayout | 以一种非常简单的方式格式化日志输出,它打印三项内容:级别-信息 |
PatternLayout | 根据指定的转换模式格式化日志输出,或者如果没有指定任何转换模式,就使用默认的转化模式格式。 |
如果使用PatternLayout布局就要指定的打印信息的具体格式
log4j.appender.stdout.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n
参数 | 说明 | |
[QC] | 是log信息的开头,可以为任意字符,例如项目简称。 | |
%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"输出日志信息换行可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如: | |
%20 | 指定输出项最小的宽度是20,如果小于20的话,默认的情况下右对齐。 | |
%-20 | 指定输出项最小的宽度是20,如果小于20的话,默认的情况下左对齐。"-"号指定左对齐。 | |
%.30 | 指定输出项最大的宽度是30,如果大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。 | |
%20.30 | 如果输出项宽度小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边开始截取字符。 |