Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Log4j 2 API provides the interface that applications should code to and provides the adapter components required for implementers to create a logging implementation. Although Log4j 2 is broken up between an API and an implementation, the primary purpose of doing so was not to allow multiple implementations, although that is certainly possible, but to clearly define what classes and methods are safe to use in "normal" application code.

 Hello World!

No introduction would be complete without the customary Hello, World example. Here is ours. First, a Logger with the name "HelloWorld" is obtained from the LogManager. Next, the logger is used to write the 所有有关软件的介绍和使用都是从 Hello World 开始的,这里是我们的 Hello World 示例程序。首先,日志从 LogManager 中获得日志名 Hello World, 然后,日志使用被使用,输出了 "Hello, World!" message, however the message will be written only if the Logger is configured to allow informational messages.这条信息。

当然这条日志能够被输出,是在日志被配置允许这条日志输出的情况下才输出的。

在下面的示例程序中,日志的级别被定义为 info,如果你定义日志输出的级别为 ERROR 的话,这条日志是不会被输出的。

Code Block
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
 
public class HelloWorld {
    private static final Logger logger = LogManager.getLogger("HelloWorld");
    public static void main(String[] args) {
        logger.info("Hello, World!");
    }
}

The output from the call to 输出日志消息的方法 logger.info() will vary significantly depending on the configuration used. See the Configuration section for more details.

...

与日志的配置是密切相关的,请参考 Log4j 2 配置 章节中有关的内容。

 添加参数

Frequently the purpose of logging is to provide information about what is happening in the system, which requires including information about the objects being manipulated. In Log4j 1.x this could be accomplished by doing:

...