Servlet3.0+springmvc5+log4j2正確的開啟姿勢(WebLookUp)

前言

　java社區占據市場份額比較大的日志組件由log4j 1.×，到logback，再到整合后的升級版 log4j 2.×，有網友測試后據說log4j2的性能最NB。於是開始往自己的springmvc5項目中整合log4j2框架。第一次使用，沒什么經驗，再加上網上出現的資料大多是舊版本，還有些介紹過於集中log4j2的屬性說明，對於項目集成益處有限。接下來我結合自己這次的整合經驗，跟大家分享下時下流行環境的正確開啟姿勢。

   https://logging.apache.org/log4j/2.x/manual/configuration.html

一、Log4j2 jar包文件的導入（MAVEN）

　1.1、基礎jar包依賴

<properties>
    <springframework.version>5.0.1.RELEASE</springframework.version>
    <!--下面這兩個是springAOP需要用到 -->
    <aspectjweaver.version>1.9.0.RC2</aspectjweaver.version>
    <persistence-api.version>1.0.2</persistence-api.version>
    <hibernate.version>5.2.12.Final</hibernate.version>
    <security-version>5.0.0.RELEASE</security-version>
    <log4j2-version>2.10.0</log4j2-version>
</properties>
<dependencies>
<!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core -->
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>${log4j2-version}</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-api -->
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-api</artifactId>
        <version>${log4j2-version}</version>
    </dependency>

　1.2、web項目jar包依賴

<dependency>
             <groupId>org.apache.logging.log4j</groupId>
             <artifactId>log4j-web</artifactId>
             <version>${log4j2-version}</version>
         </dependency>

   說明：log4j-web jar包非常重要，它的存在使我們使用weblookup插件去尋找 ${web:×××}變量成為可能。這種方式基本可以獲取所有跟web上下文環境相關的變量，包括全局屬性文件、系統初始化參數、rootDir、contextPath、servletContextName等等信息，從此不再為獲取項目根路徑，而去特意存儲系統屬性(SystemProperties)或者環境變量(Environment)。而在servlet3.0+的web項目中，Log4jServletContainerInitializer初始化類還可以全自動注入log4jServletFilter，獲取servletContext，這個jar包的功能絕對的能讓你舒爽。

    http://logging.apache.org/log4j/2.x/manual/lookups.html

　　Log4jServletContainerInitializer源碼截圖

　　

 

　　WebLookup源碼截圖

　　 

二、配置log4j2.xml文件

　 log4j2.xml文件的配置項可以參考下《Log4j2配置文件詳解》,web.xml中配置的集成方案可以忽略。下面給出我的log4j2.xml文件，使用變量${web:rootDir}獲得web應用根路徑，將日志文件存放到項目下，各級別日志存放在各自的文件中。

<?xml version="1.0" encoding="UTF-8"?>
<!-- 設置log4j2的自身log級別為warn -->
<!-- OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL -->
<Configuration status="WARN">
    <Appenders>
        <!-- 控制台輸出 -->
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>
        
        <RollingFile name="RollingFileDebug" fileName="${web:rootDir}/logs/debug.log"
            filePattern="${web:rootDir}/logs/$${date:yyyy-MM}/debug-%d{yyyy-MM-dd}-%i.log">
            <!--控制台只輸出level及以上級別的信息（onMatch），其他的直接拒絕（onMismatch）-->        
            <Filters>
                <ThresholdFilter level="DEBUG"/>
                <ThresholdFilter level="INFO" onMatch="DENY" onMismatch="NEUTRAL"/>
            </Filters>
            <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <!--最多保留20個日志文件-->
            <DefaultRolloverStrategy max="20" min="0" />  
        </RollingFile>
    
        <RollingFile name="RollingFileInfo" fileName="${web:rootDir}/logs/info.log"
            filePattern="${web:rootDir}/logs/$${date:yyyy-MM}/info-%d{yyyy-MM-dd}-%i.log">      
            <Filters>
                <ThresholdFilter level="INFO"/>
                <ThresholdFilter level="WARN" onMatch="DENY" onMismatch="NEUTRAL"/>
            </Filters>
            <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <!--最多保留20個日志文件-->
            <DefaultRolloverStrategy max="20" min="0" />  
        </RollingFile>
 
        <RollingFile name="RollingFileWarn" fileName="${web:rootDir}/logs/warn.log"
            filePattern="${web:rootDir}/logs/$${date:yyyy-MM}/warn-%d{yyyy-MM-dd}-%i.log">
            <Filters>
                <ThresholdFilter level="WARN"/>
                <ThresholdFilter level="ERROR" onMatch="DENY" onMismatch="NEUTRAL"/>
            </Filters>
            <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <!--最多保留20個日志文件-->
            <DefaultRolloverStrategy max="20" min="0" />  
        </RollingFile>
 
        <RollingFile name="RollingFileError" fileName="${web:rootDir}/logs/error.log"
            filePattern="${web:rootDir}/logs/$${date:yyyy-MM}/error-%d{yyyy-MM-dd}-%i.log">
            <ThresholdFilter level="ERROR"/>
            <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <!--最多保留20個日志文件-->
            <DefaultRolloverStrategy max="20" min="0" />  
        </RollingFile>
        
        <RollingFile name="RollingFileFatal" fileName="${web:rootDir}/logs/fatal.log"
            filePattern="${web:rootDir}/logs/$${date:yyyy-MM}/fatal-%d{yyyy-MM-dd}-%i.log">
            <ThresholdFilter level="FATAL"/>
            <PatternLayout pattern="[%d{HH:mm:ss:SSS}] [%p] - %l - %m%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <!--最多保留20個日志文件-->
            <DefaultRolloverStrategy max="20" min="0" />  
        </RollingFile>
    </Appenders>
    <Loggers>
         <!--過濾掉simm.spring.restapi一些無用的DEBUG信息-->
        <logger name="simm.spring.restapi" level="INFO"></logger>
        <Root level="all">
            <appender-ref ref="Console"/>
            <appender-ref ref="RollingFileDebug"/>
            <appender-ref ref="RollingFileInfo"/>
            <appender-ref ref="RollingFileWarn"/>
            <appender-ref ref="RollingFileError"/>
            <appender-ref ref="RollingFileFatal"/>
        </Root>
    </Loggers>
</Configuration>

三、集成完畢，運行看效果

　　

      日志文件完美輸出，保存在項目運行根目錄下。是不是特別簡單？沒錯，servlet3.0以上版本的web項目集成log4j2框架就是這么贊，不需要在web.xml中做任何配置，只要引入jar包，配置好自己的log4j2.xml文件，其它的事情都交給框架自己搞定就好了！假如你的項目使用的環境比較時尚，碰巧你又不怎么會用log4j2，那么希望這篇分享能對你有所幫助。