Log4j官方文档翻译(三、配置)

　　之前的章节介绍了log4j的核心组件，本章将会通过配置文件介绍一下核心组建的配置。

　　主要在配置文件中配置log4j的日志级别，定义appender、layout等。

　　log4j.properties是log4j的配置文件，它采用键值对的方式定义。

　　默认情况下，logManager对象会在CLASSPATH目录下寻找log4j.properties。

先看看基本的配置模板

# Define the root logger with appender X
log4j.rootLogger = DEBUG, X
# Set the appender named X to be a File appender
log4j.appender.X=org.apache.log4j.FileAppender
# Define the layout for X appender
log4j.appender.X.layout=org.apache.log4j.PatternLayout
log4j.appender.X.layout.conversionPattern=%m%n

　　看看这个配置文件都做了什么：

  • 首先日志的级别是DEBUG，另外还添加来一个appender，名字是X。
  • 设置appender的名字是X，并且定义该appender的实现为org.apache.log4j.FileAppender，即文件读写方式
  • 为X设置显示的方式——layout

真实样例

# Define the root logger with appender file
log4j.rootLogger = DEBUG, FILE
# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out
# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

　　上面的配置文件又做了什么呢？

  • 日志的root级别为DEBUG，DEBUG的appender名字是FILE。
  • 设置FILE的实现为org.apache.log4j.FileAppender，它会把日志信息写入日志目录中叫log.out的文件。
  • layout的格式定义为%m%n，意思是每条日志都会跟随一个换行符。

　　需要注意的是log4j支持UNIX风格的变量引用，比如${variableName}

Appenders

　　log4j提供了多种的Appender对象，用于输出日志消息到不同的目的地，比如控制台，文件，系统事件日志等等。每个appender对象都有不同的配置属性，这些属性定义来对象的行为。

  • layout    appender使用这个layout对象转换日志信息的格式
  • target    目标可能是控制台、文件、也可能依赖于其他的appender
  • level    用于设定过滤日志的级别
  • threshhold    appender可以设置阈值，与日志的级别有关。日志会忽略掉所有低于该级别的日志
  • filter    过滤器对象能够分析日志信息，然后决定日志请求由某个appender处理还是丢掉

　　可以通过下面的方式，给logger添加appender

log4j.logger.[logger-name]=level, appender1,appender..n

　　当然如果在XML也可以通过下面的方式：

<logger name="com.apress.logging.log4j" additivity="false">
    <appender-ref ref="appender1"/>
    <appender-ref ref="appender2"/>
</logger>

 　　如果想在程序中添加appender，则可以调用下面的方法：

public void addAppender(Appender appender);

　　这个addAppender()方法向logger对象中添加appender。

　　像例子中展示的，它可以同时配置多个appender，每个日志都会独立的发送不到不同的目的地


　　上面只展示来FileAppender的用法，log4j还有下面的appender以供使用：

  • AppenderSkeleton
  • AysncAppender
  • ConsoleAppender
  • DailyRollingFileAppender
  • ExternallyRolledFileAppender
  • FileAppender
  • JDBCAppender
  • JMSAppender
  • LF5Appender
  • NTEventLogAppender
  • NullAppender
  • RollingFileAppender
  • SMTPAppender
  • SocketAppender
  • SocketHubAppender
  • SyslogAppender
  • TelnetAppender
  • WriterAppender

layout

　　上面使用过PatternLayout，下面还有其他的选项：

  • DateLayout
  • HTMLLayout
  • PatternLayout
  • SimpleLayout
  • XMLLayout

 

　　不同的appenders和layout用法，后续会慢慢更新。

posted @ 2015-10-03 14:42  xingoo  阅读(1516)  评论(0)  编辑  收藏  举报