配置（Configuration）

前一章解释了log4j的核心组件。 本章介绍如何使用配置文件配置核心组件。 配置log4j涉及分配Level，定义Appender以及在配置文件中指定Layout对象。

log4j.properties文件是一个log4j配置文件，它将属性保存在键值对中。 默认情况下，LogManager在CLASSPATH查找名为log4j.properties的文件。

• 根记录器的级别定义为DEBUG 。 DEBUG将名为X的appender附加到它上面。

• 将名为X的appender设置为有效的appender。

• 设置appender X的布局。

log4j.properties Syntax:

以下是appender X的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

log4j.properties Example

使用上面的语法，我们在log4j.properties文件中定义以下内容:

• 根记录器的级别定义为DEBUG ， DEBUG appender命名为FILE 。

• appender FILE定义为org.apache.log4j.FileAppender 。 它写入位于log目录中名为log.out的文件。

• 定义的布局模式是%m%n ，这意味着打印的日志消息后面跟一个换行符。

# 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

值得注意的是，log4j支持UNIX样式的变量替换，例如$ {variableName}。

调试级别

我们在两个appender中都使用了DEBUG。 所有可能的选择是:

• TRACE
• DEBUG
• INFO
• WARN
• ERROR
• FATAL
• ALL

这些级别将在本教程后面介绍。

Appenders

Apache log4j提供Appender对象，主要负责将日志消息打印到不同的目的地，如控制台，文件，套接字，NT事件日志等。

每个Appender对象都有与之关联的不同属性，这些属性指示该对象的行为。

我们可以通过使用以下方法在配置文件中包含以下设置，将Appender对象添加到Logger:

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（）方法将一个Appender添加到Logger对象。 如示例配置所示，可以将许多Appender对象添加到逗号分隔列表中的记录器中，每个对象都将记录信息打印到不同的目标。

我们在上面的示例中只使用了一个appender FileAppender 。 所有可能的appender选项是:

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

我们将在Logging in Files介绍FileAppender，并在登录数据库中介绍JDBC Appender。

Layout

我们使用了PatternLayout和我们的appender。 所有可能的选择是:

• DateLayout
• HTMLLayout
• PatternLayout
• SimpleLayout
• XMLLayout

使用HTMLLayout和XMLLayout，您还可以生成HTML和XML格式的日志。

布局格式

您将在以下章节中学习如何格式化日志消息: Log Formatting 。