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用法，后续会慢慢更新。

巴特西

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

先看看基本的配置模板

真实样例

Appenders

layout

最新文章

热门文章