所有 Apache 日志服务项目的 XML 模式都发布在此目录中。此目录的规范名称为 https://logging.apache.org/xml/ns

重要

在您的应用程序中使用这些模式时,需要了解此处使用的 XSD 版本方案的两个重要事项

  1. 模式版本和项目版本独立发展。 也就是说,Log4j 2.24.0 版本并不一定意味着新的 log4j-config-2.24.0.xsd:Log4j 2 运行时配置 API 可能保持不变。

  2. 建议用户仅使用主要版本的模式log4j-config-2.xsdlog4j-config-3.xsdlog4j-changelog-0.xsd 等。

Log4j 模式

Log4j 是一个 Java 日志记录框架。以下模式模拟 Log4j 运行时配置,即 log4j2.xml[1]

发布时间 文件名 描述

2024-03-19

log4j-config-2.23.1.xsd

Log4j 2.23.1 发布

N/A

log4j-config-2.xsd

指向主要版本 2 的最新 XSD。建议 Log4j 2 用户在他们的 XML 文件中引用此 XSD。

2024-03-19

log4j-config-3.0.0.xsd

N/A

N/A

log4j-config-3.xsd

指向主要版本 3 的最新 XSD。建议 Log4j 3 用户在他们的 XML 文件中引用此 XSD。

Log4j 2 模式使用示例
<?xml version="1.0" encoding="UTF-8"?>
<Configuration xmlns="https://logging.apache.org/xml/ns"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-config-2.xsd">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d [%t] %p %c - %m%n"/>
    </Console>
  </Appenders>
  <Loggers>
    <Root level="WARN">
      <AppenderRef ref="Console"/>
    </Root>
  </Loggers>
</Configuration>

Log4j 变更日志模式

Log4j 变更日志 是一个用于维护变更日志的工具。它专为 Apache Log4j 设计,但可用于任何 Java 项目。

发布时间 文件名 描述

2023-02-03

log4j-changelog-0.1.0.xsd

Log4j Tools 0.2.0 发布

2023-03-17

log4j-changelog-0.1.1.xsd

Log4j Tools 0.3.0 发布

2023-09-28

log4j-changelog-0.1.2.xsd

Log4j Tools 0.5.0 发布

2023-12-13

log4j-changelog-0.1.3.xsd

Log4j Tools 0.7.0 发布

2024-03-15

log4j-changelog-0.2.0.xsd

计划随 Log4j Tools 0.8.0 发布

N/A

log4j-changelog-0.xsd

指向主要版本 0 的最新 XSD。建议用户在他们的 XML 文件中引用此 XSD。

Log4j 变更日志模式使用示例
<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns="https://logging.apache.org/xml/ns"
       xsi:schemaLocation="
               https://logging.apache.org/xml/ns
               https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
       type="updated">
  <issue id="2370" link="https://github.com/apache/logging-log4j2/pull/2370"/>
  <description format="asciidoc">Update `actions/checkout` to version `4.1.2`</description>
</entry>

1. Log4j 2 和 Log4j 3 都使用 log4j2.xml 进行配置。