Spring MVC+Spring框架使用log4j的學習總結

作為程序員在日常的開發(fā)過程中，經(jīng)常會遇到各種Bug，對于這種情況，作為初學者，我之前一直是在自己覺得可能出錯的地方，輸出相關變量的值。這種“笨”辦法對于某些簡單的Bug是可以的，但是大多數(shù)情況下是不可行的，要想快速定位程序出錯的位置，最好的就是查看相關的日志文件。本文主要介紹如何在我們的項目中使用log4j來記錄日志。如有錯誤之處還請指出、見諒。

1. log4j

Log4j是一個用Java編寫的可靠，快速和靈活的日志框架（API），是Apache的一個開放源代碼項目。我們可以通過使用log4j可以向我們定義的地方、按照我們指定的格式輸出日志文件。
log4j主要由三個組件組成：

1.logger : 負責捕獲、記錄日志，通過它我們可以選擇記錄不同優(yōu)先級的日志
2.appender : 負責發(fā)布日志，通過它我們可以指定日志的輸出地方
3.layout : 負責日志的格式，通過它我們可以按照我們自己定義的格式來輸出日志

下面分別對這三個組件進行展開：

1.1 logger

之前有說通過它我們可以有選擇性的輸出不同優(yōu)先級的日志，那么日志的優(yōu)先級是什么？
日志的優(yōu)先級按照優(yōu)先級從低到高，可以分為：

DEBUG < INFO < WARN < ERROR < FATAL

這其中FATAL為致命的錯誤，會導致程序無法運行，ERROR 為嚴重錯誤 主要是程序的錯誤，WARN 為一般警告，比如session丟失，INFO 為一般要顯示的信息，比如登錄登出，DEBUG 為程序的調(diào)試信息

1.2 appender

一般情況下，appender的常用的值可以為：

  1. org.apache.log4j.ConsoleAppender（控制臺）
  2. org.apache.log4j.FileAppender（文件）
  3. org.apache.log4j.DailyRollingFileAppender（每天產(chǎn)生一個日志文件）
  4. org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產(chǎn)生一個新的文件）

之前有說，appender主要是定義了日志的輸出地方，如果appender的值為org.apache.log4j.FileAppender則表示將日志以文件的形式輸出。

1.3 layout

layout定義了日志的輸出格式，其取值可以為：

  1. org.apache.log4j.HTMLLayout（以HTML表格形式布局）
  2. org.apache.log4j.PatternLayout（可以靈活地指定布局模式
  3. org.apache.log4j.SimpleLayout（包含日志信息的級別和信息字符串）
  4. org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時間、線程、類別等等信息）

一般都會使用org.apache.log4j.PatternLayout，當使用org.apache.log4j.PatternLayout作為layout的取值時，可以結合具體的輸出格式控制來格式化每一條記錄的輸出：

  1. %c 輸出所屬類的全名，可在修改為 %d{Num} ,Num類名輸出的維（如："org.apache.elathen.ClassName",%C{2}將輸出elathen.ClassName)
  2. %d 輸出日志時間其格式為 %d{yyyy-MM-dd HH:mm:ss,SSS}，可指定格式 如 %d{HH:mm:ss}
  3. %l 輸出日志事件發(fā)生位置，包括類目名、發(fā)生線程，在代碼中的行數(shù)
  4. %n 換行符
  5. %m 輸出代碼指定信息，如info(“message”),輸出message
  6. %p 輸出優(yōu)先級，即 FATAL ,ERROR 等
  7. %r 輸出從啟動到顯示該log信息所耗費的毫秒數(shù)
  8. %t 輸出產(chǎn)生該日志事件的線程名

2. log4j配置

前面介紹了log4j的一些組件，看起來肯定是一頭霧水，現(xiàn)在我們動手把log4j配置到我們的項目中。
在web項目中使用log4j首先要創(chuàng)建它的配置文件，可以是以xml文件或者是property文件的形式，本文我們使用property文件的形式。
log4j.properties

log4j.rootLogger = info,stdout,D,E

#配置stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss,SSS} [%p]-[%l] %m%n

#配置D
log4j.appender.D = org.apache.log4j.RollingFileAppender
log4j.appender.D.File = /Users/xiangang/JavaWebLearning/Log4j-Test/log/log.log
log4j.appender.D.Append = truelog4j.appender.D.Threshold = INFO
log4j.appender.D.MaxFileSize=5MB
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %d{yyyy-MM-dd HH\:mm\:ss,SSS} [%p]-[%l] %m%n

#配置E
log4j.appender.E = org.apache.log4j.RollingFileAppender
log4j.appender.E.File = /Users/xiangang/JavaWebLearning/Log4j-Test/log/error.log
log4j.appender.E.Append = truelog4j.appender.E.Threshold = ERROR
log4j.appender.E.MaxFileSize=5MB
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %d{yyyy-MM-dd HH\:mm\:ss,SSS} [%p]-[%l] %m%n

上面的配置文件是按照如下的模式來進行配置的，通常情況下，都會按照下面的格式來配置：

#配置根Logger
log4j.rootLogger = [ level ] , appenderName1 , appenderName2 , …

#配置日志信息輸出目的地Appender
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
log4j.appender.appenderName.optionN = valueN 

#配置日志信息的格式layout
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
log4j.appender.appenderName.layout.optionN = valueN

這里需要解釋一下的是根loggerrootLogger繼承自logger，如果想從源碼的角度分析可以參考：http://www.cnblogs.com/davidwang456/p/4243161.html

要想使用log4j，除了配置完log4j的配置文件，還要在applicationContext初始化的時候加載它的配置文件。本文是在Spring框架中使用，所以相對來說比較簡單，在web.xml中進行簡單設置即可，在其他環(huán)境下使用log4j的可以參考：http://www.codeceo.com/article/log4j-usage.html

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"           
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"           
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee        
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"         version="3.0">    

<!--設置log4j配置文件-->    
<context-param>       
<param-name>log4jConfigLocation</param-name>        
<param-value>classpath:log4j.properties</param-value>    
</context-param>    
<!--log4j的初始化類-->   
 <listener>        
<listener-class>
org.springframework.web.util.Log4jConfigListener
</listener-class>    
</listener>    

<!--定義Filter進行用戶驗證-->    
<filter>        
<filter-name>loginValidation</filter-name>        
<filter-class>filter.LoginValidation</filter-class>        
<init-param>            
<param-name>logonPath</param-name>            
<param-value>/log4j/register.jsp;/log4j/index.jsp</param-value>        
</init-param>        
<init-param>            
<param-name>redirectPath</param-name>            
<param-value>/index.jsp</param-value>        
</init-param>    
</filter>    
<filter-mapping>        
<filter-name>loginValidation</filter-name>        
<url-pattern>/*</url-pattern>    
</filter-mapping>    

<!--配置字符過濾器,防止出現(xiàn)中文亂碼-->    
<filter>        
<filter-name>CharacterEncodingFilter</filter-name>        
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>        
<init-param>            
<param-name>encoding</param-name>            
<param-value>utf-8</param-value>        
</init-param>    
</filter>    
<filter-mapping>        
<filter-name>CharacterEncodingFilter</filter-name>        
<url-pattern>/*</url-pattern>    
</filter-mapping>    

<!--設置Spring MVC的前置控制器-->    
<servlet>        
<servlet-name>DispactherServlet</servlet-name>        
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        
<init-param>            
<param-name>contextConfigLocation</param-name>            
<param-value>classpath:dispatcherServlet.xml</param-value>        
</init-param>        
<load-on-startup>1</load-on-startup>    
</servlet>    
<servlet-mapping>        
<servlet-name>DispactherServlet</servlet-name>        
<url-pattern>/</url-pattern>    
</servlet-mapping>    
<welcome-file-list>        
<welcome-file>index.jsp</welcome-file>    
</welcome-file-list>
</web-app>

build.gradle

group 'xiangang.wei'
version '1.0-SNAPSHOT'
apply plugin: 'java'
apply plugin: 'war'

sourceCompatibility = 1.8

repositories {   
jcenter()    
mavenCentral()
}

dependencies {    
testCompile group: 'junit', name: 'junit', version: '4.11'    
// servlet-api    
compile group: 'javax.servlet', name: 'servlet-api', version: '2.5'    
// log4j api    
compile group: 'log4j', name: 'log4j', version: '1.2.17'    
//spring api    
compile group: 'org.springframework', name: 'spring-webmvc', version: '4.3.3.RELEASE'    
compile group: 'org.springframework', name: 'spring-orm', version: '4.3.3.RELEASE'    
compile group: 'org.springframework', name: 'spring-aspects', version: '4.3.3.RELEASE'
}

其余代碼在：https://github.com/xiangang-wei/log4j

配置好本地Tomcat運行后在控制臺可以看到：

控制臺打印的日志信息

我們還可以在本地文件夾里看到輸出的兩個日志文件：

生成的日志文件

打開log.log文件：

log.log
最后編輯于 ：
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關閱讀更多精彩內(nèi)容

  • 在應用程序中添加日志記錄總的來說基于三個目的：監(jiān)視代碼中變量的變化情況，周期性的記錄到文件中供其他應用進行統(tǒng)計分析...
    時待吾閱讀 5,161評論 0贊 6
  • 在應用程序中添加日志記錄總的來說基于三個目的：監(jiān)視代碼中變量的變化情況，周期性的記錄到文件中供其他應用進行統(tǒng)計分析...
    時待吾閱讀 5,226評論 1贊 13
  • 一、Log4j簡介 Log4j有三個主要的組件：Loggers(記錄器)，Appenders (輸出源)和Layo...
    默默守護閱讀 1,980評論 2贊 8
  • from：https://www.cnblogs.com/ITtangtang/p/3926665.html一、L...
    enshunyan閱讀 3,420評論 0贊 0
  • #########################################################...
    BearFaraway閱讀 1,871評論 0贊 51

友情鏈接更多精彩內(nèi)容