快捷導航

log4j2 項目日志組件的實例代碼

更新時間：2017年12月20日 13:41:19 作者：代碼風云

下面小編就為大家分享一篇log4j2 項目日志組件的實例代碼，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧

在項目運行過程中，常常需要進行功能調(diào)試以及用戶行為的跟蹤和記錄，部分人習慣使用System.out，但這并不建議，它僅僅是使用方便但不便于維護也無擴展性。相比log4j的話，log4j可以控制日志信息的輸送目的地、輸出格式以及級別等等，使我們能夠更加細致地控制日志的生成過程。

Log4j2是對Log4j1的升級，在性能和功能上有顯著的改進，包括多線程中吞吐量的增強、占位符的支持、配置文件自動重新加載等

一、入門介紹

1、下載jar包

pox.xml

<dependencies>
 <dependency>
 <groupId>org.apache.logging.log4j</groupId>
 <artifactId>log4j-api</artifactId>
 <version>2.10.0</version>
 </dependency>
 <dependency>
 <groupId>org.apache.logging.log4j</groupId>
 <artifactId>log4j-core</artifactId>
 <version>2.10.0</version>
 </dependency>
</dependencies>

2、配置文件

Log4j包含四個配置工廠實現(xiàn)：JSON、YAML、properties、XML，本文介紹常用的方式XML。

Log4j具有在初始化期間自動配置自身的能力。當Log4j啟動時，它將定位類路徑下所有符合名稱的文件，優(yōu)先級順序：log4j2-test.properties > log4j2-test.xml > log4j2.properties > log4j2.xml

3、一個簡單的實例

xml配置：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
 <Appenders>
 <Console name="Console" target="SYSTEM_OUT">
 <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
 </Console>
 </Appenders>
 <Loggers>
 <Root level="info">
 <AppenderRef ref="Console"/>
 </Root>
 </Loggers>
</Configuration>

java代碼：

private static final Logger logger = LogManager.getLogger(MyApp.class);
 @Test
 public void testLog4j(){
 logger.info("hello world!");
 }
}

控制臺信息

22:17:47.146 [main] INFO MyApp - hello world!

二、模塊介紹

<Configuration>

屬性	描述
monitorInterval	如果文件被修改了，指定時間后會重新加載配置。單位秒，最小值是5
packages	以逗號隔開的包名列表，用于搜索插件，比如自定義filter、appender等。插件僅會加載一次，所以要想修改后生效必須重啟項目
status	內(nèi)部日志級別，設(shè)置值為debug可以在控制臺上清晰地看到整個日志事件流程，所使用的Logger是org.apache.logging.log4j.core.LOGGER
strict	允許使用嚴格的XML格式。不支持JSON配置
verbose	在加載插件時啟用診斷信息

<Appenders>

Log4j允許將日志請求打印到多個目的地。在log4j語言中，輸出目的地稱為Appender。目前，appender存在于控制臺、文件、遠程套接字服務(wù)器、Apache Flume、JMS、遠程UNIX Syslog守護進程和各種數(shù)據(jù)庫api中。以下介紹幾種比較常用的appender，如需了解更多可以到官網(wǎng)上進行查閱。

1、ConsoleAppender

輸出到控制臺，<Console>

參數(shù)名稱	類型	描述
filter	Filter	過濾器
layout	Layout	日志輸出格式
follow	boolean
direct	boolean
name	String	Appender的名稱
ignoreExceptions	boolean	默認true，忽略寫入異常
target	String	SYSTEM_OUT或SYSTEM_ERR，默認是SYSTEM_OUT

2、FileAppender

輸出到文件，<File>

參數(shù)	類型	描述
append	boolean	默認是true，新記錄將追加到文件尾部
bufferedIO	boolean	默認是true，使用緩沖區(qū)可以顯著地提高性能
bufferSize	int	當bufferedIO是true時，這個屬性緩沖區(qū)大小，默認是8192字節(jié)。
createOnDemand	boolean	appender按需創(chuàng)建文件。只有當一個日志事件通過所有過濾器并被路由到這個appender時，appender才會創(chuàng)建這個文件。默認值為假
filter	Filter	一個過濾器來確定事件是否應該由這個Appender處理。使用復合過濾器可以使用多個篩選器
fileName	String	要寫入的文件的名稱。如果文件或它的任何父目錄不存在，它們將被創(chuàng)建
immediateFlush	boolean	默認true，每次寫入后都將有一個刷新。這將保證緩沖區(qū)的數(shù)據(jù)被寫入磁盤，但可能會影響性能。
layout	Layout	日志格式
locking	boolean	文件鎖，默認false
name	String	Appender的名稱
ignoreExceptions	boolean	默認true，忽略寫入異常
filePermissions	String	定義文件權(quán)限例: rw------- or rw-rw-rw- etc...
fileOwner	String	定義文件所有者
fileGroup	String	定義文件組

3、JDBCAppender

JDBCAppender使用標準JDBC將日志事件寫入到關(guān)系數(shù)據(jù)庫表中。它可以配置為使用JNDI數(shù)據(jù)源或自定義工廠方法獲得JDBC連接。無論采用哪種方法，都必須由連接池來支持。

否則，日志記錄性能將受到極大的影響。

如果已配置的JDBC驅(qū)動程序支持批處理語句，并且將緩沖區(qū)大小配置為一個正數(shù)，那么日志事件將被批處理。

（1）<JDBC>

參數(shù)	類型	描述
name	String	必須，appender的名稱
ignoreExceptions	boolean	默認true，忽略日志事件異常
filter	Filter	過濾器
bufferSize	int	如果一個大于0的整數(shù)，這將導致appender緩沖日志事件，并在緩沖區(qū)達到該大小時刷新寫入數(shù)據(jù)
connectionSource	ConnectionSource	必須，可被檢索到的數(shù)據(jù)庫連接
tableName	String	必須，插入日志事件的數(shù)據(jù)表名
columnConfigs	ColumnConfig[]	必須，需要插入到數(shù)據(jù)庫的字段，由多個<Column>元素組成
columnMappings	ColumnMapping[]	必須，字段映射配置

（2）使用<DataSource>來獲得JDBC的連接，這里僅列出jndi：

參數(shù)	類型	描述
jndiName	String	必需的，如已配置的jndi為jdbc/LoggingDatabase，那此處的值為java:comp/env/jdbc/LoggingDatabase。數(shù)據(jù)源必須由連接池來支持;否則，日志記錄將非常緩慢。

（3）使用<Column>來指定要寫入表中的哪些列，以及如何對它們進行寫入。它沒有SQL注入漏洞。

參數(shù)	類型	描述
name	String	必須，表字段名稱
pattern	String	使用PatternLayout模式插入值，注：同一個Column元素中，patter、literal、isEventTimestamp3個屬性只能存在一個
literal	String	該值將直接包含在SQL語句中執(zhí)行，比如：rand()函數(shù)將生成隨機數(shù)，類似myibats中的${}
isEventTimestamp	boolean	是否時間格式j(luò)ava.sql.Types.TIMESTAMP
isUnicode	boolean	除非指定pattern，否則該屬性將被忽略。如果是true，該值將插入Unicode。否則，該值將被插入非Unicode。
isClob	boolean	除非指定pattern，否則該屬性將被忽略。如果是true，該值將插入CLOB，否則將插入varchar、nvarchar

實例：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="error">
 <Appenders>
 <JDBC name="databaseAppender" tableName="dbo.application_log">
  <DataSource jndiName="java:/comp/env/jdbc/LoggingDataSource" />
  <Column name="eventDate" isEventTimestamp="true" />
  <Column name="level" pattern="%level" />
  <Column name="logger" pattern="%logger" />
  <Column name="message" pattern="%message" />
  <Column name="exception" pattern="%ex{full}" />
 </JDBC>
 </Appenders>
 <Loggers>
 <Root level="warn">
  <AppenderRef ref="databaseAppender"/>
 </Root>
 </Loggers>
</Configuration>

<PatternLayout>

（1）日期，%d / %date

Pattern	示例
%d{DEFAULT}	2012-11-02 14:34:02,781
%d{ISO8601}	2012-11-02T14:34:02,781
%d{ISO8601_BASIC}	20121102T143402,781
%d{ABSOLUTE}	14:34:02,781
%d{DATE}	02 Nov 2012 14:34:02,781
%d{COMPACT}	20121102143402781
%d{HH:mm:ss,SSS}	14:34:02,781
%d{dd MMM yyyy HH:mm:ss,SSS}	02 Nov 2012 14:34:02,781
%d{HH:mm:ss}{GMT+0}	18:34:02
%d{UNIX}	1351866842
%d{UNIX_MILLIS}	1351866842781

當然你也可以自定義格式，比如 %d{yyyy-MM-dd HH:mm:ss}

（2）記錄器，%c / %logger

Conversion Pattern	Logger Name	結(jié)果
%c{1}	org.apache.commons.Foo	Foo
%c{2}	org.apache.commons.Foo	commons.Foo
%c{10}	org.apache.commons.Foo	org.apache.commons.Foo
%c{-1}	org.apache.commons.Foo	apache.commons.Foo
%c{-2}	org.apache.commons.Foo	commons.Foo
%c{-10}	org.apache.commons.Foo	org.apache.commons.Foo
%c{1.}	org.apache.commons.Foo	o.a.c.Foo
%c{1.1.~.~}	org.apache.commons.test.Foo	o.a.~.~.Foo
%c{.}	org.apache.commons.test.Foo	....Foo

{?} - ?是正整數(shù)時表示從右邊開始取n個部分，負整數(shù)表示從左邊開始移除n個部分，那為什么%c{-10}是完整的名稱我也不清楚，歡迎留言

（3）日志信息，%m / %msg / %message

（4）日志級別，%level

<Filter>

log4j2自帶多種filter供直接使用，也可以由我們自己來定義filter：

MyFilter.java

import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.Marker;
import org.apache.logging.log4j.ThreadContext;
import org.apache.logging.log4j.core.LogEvent;
import org.apache.logging.log4j.core.Logger;
import org.apache.logging.log4j.core.config.plugins.Plugin;
import org.apache.logging.log4j.core.config.plugins.PluginAttribute;
import org.apache.logging.log4j.core.config.plugins.PluginFactory;
import org.apache.logging.log4j.core.filter.AbstractFilter;
import org.apache.logging.log4j.message.Message;
@Plugin(name = "MyFilter", category = "Core", elementType = "filter", printObject = true)
public final class MyFilter extends AbstractFilter {
 private final Level level;
 private MyFilter(Level level, Result onMatch, Result onMismatch) {
  super(onMatch, onMismatch);
  this.level = level;
 }
 public Result filter(Logger logger, Level level, Marker marker, String msg, Object[] params) {
  return filter(level);
 }
 public Result filter(Logger logger, Level level, Marker marker, Object msg, Throwable t) {
  return filter(level);
 }
 public Result filter(Logger logger, Level level, Marker marker, Message msg, Throwable t) {
  return filter(level);
 }
 @Override
 public Result filter(LogEvent event) {
  return filter(event.getLevel());
 }
 private Result filter(Level level) {
  /*
  * 業(yè)務(wù)邏輯
  * */
  
  return level.isMoreSpecificThan(this.level) ? onMatch : onMismatch;
 }
 @Override
 public String toString() {
  return level.toString();
 }
 @PluginFactory
 public static MyFilter createFilter(@PluginAttribute(value = "level", defaultString = "ERROR") Level level,
            @PluginAttribute(value = "onMatch", defaultString = "NEUTRAL") Result onMatch,
            @PluginAttribute(value = "onMismatch", defaultString = "DENY") Result onMismatch) {
  return new MyFilter(level, onMatch, onMismatch);
 }
}

log4j2.xml

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="warn" monitorInterval="5" packages="your packages" verbose="false" strict="true">
 <Appenders>
 <Console name="Console" target="SYSTEM_OUT" ignoreExceptions="true">
  <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %level %logger{10} - %msg"/>
  <MyFilter level="info" onMatch="ACCEPT"/>
 </Console>
 </Appenders>
 <Loggers>
 <Root level="info">
  <AppenderRef ref="Console"/>
 </Root>
 </Loggers>
</Configuration>

補充：

在實際應用中，有時需要對用戶的訪問信息進行記錄，比如請求參數(shù)、用戶id等等。在log4j1中我們會使用MDC和NDC來存儲應用程序的上下文信息，而log4j2使用ThreadContext來實現(xiàn)MDC和NDC兩者的功能。

（1）NDC采用類似棧的機制來存儲上下文信息，線程獨立。

在PatternLayout中使用 %x 來輸出，注意x是小寫。

實例：

Test.java

ThreadContext.push("hello world!");

log4j2.xml

<Column name="tip" pattern="%x" />

（2）MDC采用類似map的機制來存儲信息，線程獨立。

在PatternLayout中使用 %X{userId} 來輸出，注意X是大寫。

實例：

Test.java

ThreadContext.put("userId","1");

log4j2.xml

<Column name="userId" pattern="%X{userId}" />

注意使用完后調(diào)用clearAll()清除上下文映射和堆棧。

api：http://logging.apache.org/log4j/2.x/javadoc.html

官網(wǎng)地址：https://logging.apache.org/log4j/2.x/index.html

以上這篇log4j2 項目日志組件的實例代碼就是小編分享給大家的全部內(nèi)容了，希望能給大家一個參考，也希望大家多多支持腳本之家。

您可能感興趣的文章:

欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

log4j2 項目日志組件的實例代碼

相關(guān)文章

最新評論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具