1. Vorwort
log4j ist ein zuverlässiges, schnelles und flexibles Protokollierungsframework (API), das in Java geschrieben ist und unter der Apache-Softwarelizenz veröffentlicht wird. Log4j wurde auf Sprachen wie C, C++, C#, Perl, Python und Ruby portiert.
Log4j ist hochgradig konfigurierbar und kann zur Laufzeit über externe Dateien konfiguriert werden. Es priorisiert die Protokollierung und bietet Mechanismen, um Protokollierungsinformationen an viele Ziele weiterzuleiten, z. B. Datenbanken, Dateien, Konsolen, UNIX-Systemprotokolle usw.
Es gibt drei Hauptkomponenten in Log4j:
Logger: Verantwortlich für die Erfassung von Protokollierungsinformationen.
Anhänge: Verantwortlich für die Veröffentlichung von Protokollinformationen an verschiedene bevorzugte Ziele.
Layouts: Verantwortlich für die Formatierung von Protokollinformationen in verschiedenen Stilen.
Hinweis: Dieser Artikel basiert auf log4j 2.X und höher.
2. Installieren Sie
log4j-core-xx.jar
log4j-api-xx.jar
log4j-web -xx.jar (erforderliche Referenz für Webprojekte)
3. Konfiguration
Bereiten Sie einige Protokollklassen vor und fügen Sie die folgenden Referenzen hinzu:
import org.apache.logging.log4j.LogManager; import org.apache.logging.log4j.Logger;
static Logger logger = LogManager.getLogger(Test.class.getName());
Konfigurationsdatei Speicherort: Befindet sich im SRC-Stammverzeichnis. Es wird kein Fehler gemeldet, auch wenn keine Konfigurationsdatei vorhanden ist. Die Ausgabe erfolgt standardmäßig in Form einer Konsole.
Die log4j2-Konfigurationsdatei unterscheidet sich stark von log4 (Version 1.):
<?xml version="1.0" encoding="UTF-8"?> <configuration status="error"> <!--先定义所有的appender--> <appenders> <!--这个输出控制台的配置--> <Console name="Console" target="SYSTEM_OUT"> <!--这个是输出日志的格式--> <PatternLayout pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/> </Console> <!--文件会打印出所有信息,这个log每次运行程序会自动清空,由append属性决定,适合临时测试用--> <File name="Error" fileName="${web:rootDir}/logs/error.log" append="false"> <!--文件只记录level及以上级别的信息(onMatch),其他的直接拒绝(onMismatch)--> <ThresholdFilter level="error" onMatch="ACCEPT" onMismatch="DENY"/> <PatternLayout charset="UTF-8" pattern="%d{HH:mm:ss.SSS} %-5level %class{36} %L %M - %msg%xEx%n"/> </File> <!--这个会打印出所有的信息,每次大小超过size,则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩,作为存档--> <RollingFile name="RollingFile" fileName="${web:rootDir}/logs/history.log" filePattern="log/$${date:yyyy-MM}/history-%d{MM-dd-yyyy}-%i.log.gz"> <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd 'at' HH:mm:ss z} %-5level %class{36} %L %M - %msg%xEx%n"/> <SizeBasedTriggeringPolicy size="50MB"/> </RollingFile> </appenders> <!--然后定义logger,只有定义了logger并引入的appender,appender才会生效--> <loggers> <!--建立一个默认的root的logger--> <root level="trace"> <appender-ref ref="Error"/> <appender-ref ref="RollingFile"/> <appender-ref ref="Console"/> </root> </loggers> </configuration>
4. Gewöhnliche Projekte und Webprojekte
Bei gewöhnlichen Projekten kann dies der Fall sein Wird normalerweise verwendet, nachdem die obige Konfiguration abgeschlossen ist. Bei Webprojekten wird keine Protokolldatei generiert. Sie müssen die folgende Konfiguration unter dem Stammknoten von
<!-- log4j2.x start --> <listener> <listener-class>org.apache.logging.log4j.web.Log4jServletContextListener</listener-class> </listener> <filter> <filter-name>log4jServletFilter</filter-name> <filter-class>org.apache.logging.log4j.web.Log4jServletFilter</filter-class> </filter> <filter-mapping> <filter-name>log4jServletFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- log4j2.x end -->