log4j是用來記錄日誌的。
軟件的運行過程離不開日誌.日誌主要用來記錄系統運行過程中的一些重要的操作信息,便於監視系統運行情況,幫助用戶提前發現和避開可能出現的問題,或者出現問題後根據日誌找到發生的原因.
日誌根據記錄內容的不同,主要分成以下3類:
- SQL日誌:記錄系統執行的SQL語句.
- 異常日誌:記錄系統運行中發生的異常事件.
- 業務日誌:記錄系統運行過程,如用戶登錄,操作記錄.
要使用log4j,首先需要下載log4j 的JAR文件.log4j是Apache的一個開源項目,它的官方網站是http://logging.apache.org/log4j
看過好多log4j的文章,基本上都有log4j的配置方法,卻沒有log4j的配置步驟,我說一下吧:
創建log4.properties文件
使用log4j需要創建log4j.propterties文件,這個文件時專門用來配置日誌信息的,比如輸出級別、輸出目的地、輸出格式等.
然後選擇要使用log4j的項目,右擊src,依次選擇”New” →”File”選項,彈出”New File”對話框,輸入文件名” log4j.properties”,這樣就創建成功了.
至於log4j的配置方法,就是那讓別人轉載爛了的那段:
### set log levels ###
log4j.rootLogger = debug , stdout , D , E
### 輸出到控制檯 ###
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{ABSOLUTE} %5p %c{ 1 }:%L - %m%n
### 輸出到日誌文件 ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG ## 輸出DEBUG級別以上的日誌
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
### 保存異常信息到單獨文件 ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = logs/error.log ## 異常日誌文件名
log4j.appender.D.Append = true
log4j.appender.D.Threshold = ERROR ## 只輸出ERROR級別以上的日誌!!!
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
在web.xml文件中添加
<!-- 配置log4j -->
<context-param>
<param-name>webAppRootKey</param-name>
<param-value>com.test.webapp.root</param-value>
</context-param>
<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>/WEB-INF/classes/log4j.properties</param-value>
</context-param>
<context-param>
<param-name>log4jRefreshInterval</param-name>
<param-value>600000</param-value>
</context-param>
log4j在main方法中使用:
import org.apache.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.hsinghsu.testSSH.dao.UserDao;
import com.hsinghsu.testSSH.model.User;
import com.hsinghsu.testSSH.service.UserService;
@Service(value = "userService")
public class UserServiceImpl implements UserService{
@Autowired
private UserDao userDao;
// private final static Logger logger = Logger.getLogger(UserServiceImpl.class);
private Logger logger = Logger.getLogger(this.getClass().getName());
public boolean login(String name, String password)
{
logger.info("--UserServiceImpl login method name:"+name+" password:"+password);
User user = userDao.getUserByName(name);
if(user!=null)
{
if(password.equals(user.getPwd()))
{
return true;
}
}
return false;
}
}
log4j的輸出級別:
log的級別分爲debug(調試信息)、info(一般信息)、warn(警告信息)、error(錯誤信息)、fatal(致命錯誤信息)。 Log4j支持兩種配置文件格式,一種是XML格式的文件,一種是java屬性文件log4j.properties,下面以log4j.properties爲例進行說明。
1、配置根Logger
Logger 負責處理日誌記錄的大部分操作,其語法爲:
log4j.rootLogger = [ level ] , appenderName1, appenderName2, …
level : 是日誌記錄的優先級,分爲OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定義的級別。
appenderName:就是指定日誌信息輸出目的地的名稱。
如:log4j.rootLogger=info,A1,B2,C3
在早期log4j版本中,org.apache.Category實現了記錄器的功能,後使用logger擴展了Category類,因此log4j.rootCategory也可以使用。
如:log4j.rootCategory=INFO,A1,A2
2、配置日誌信息輸出目的地 Appender
Appender 負責控制日誌記錄操作的輸出,其語法爲:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
其中"fully.qualified.name.of.appender.class" 有以下幾種: i.org.apache.log4j.ConsoleAppender(控制檯)
該選項有以下幾種:
Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。 Target=System.err:默認情況下是:System.out,指定輸出控制檯 ii.org.apache.log4j.FileAppender(文件)
該選項有以下幾種:
Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。 File=mylog.txt:指定消息輸出到mylog.txt文件。 Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。 iii.org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌文件)
該選項有以下幾種:
Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。 File=a.log:指定消息輸出到a.log文件,默認是從web服務器的根路徑開始。 Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。 DatePattern='.'yyyy-ww:每週滾動一次文件,即每週產生一個新的文件。當然也可以指定按月、周、天、時和分。即對應的格式如下: '.'yyyy-MM: 每月 '.'yyyy-ww: 每週 '.'yyyy-MM-dd: 每天 '.'yyyy-MM-dd-a: 每天兩次 '.'yyyy-MM-dd-HH: 每小時 '.'yyyy-MM-dd-HH-mm: 每分鐘 iv.org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件,可通過log4j.appender.appenderName.MaxFileSize=100KB設置文件大小)
該選項有以下幾種:
Threshold=WARN:指定日誌消息的輸出最低層次。 ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。 File=a.log:指定消息輸出到a.log文件,默認是從web服務器的根路徑開始。 Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。 MaxFileSize=100KB: 後綴可以是KB, MB 或者是 GB. 在日誌文件到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1文件。 MaxBackupIndex=2:指定可以產生的滾動文件的最大數。 v.org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)
例如:
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender log4j.appender.R.File=D:\\eclipsespace\\testSSH\\WebContent\\WEB-INF\\testlog.log
3、配置日誌信息的格式(佈局)Layout
Layout 負責格式化Appender的輸出,其語法爲: log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class 其中"fully.qualified.name.of.layout.class" 有以下幾種: i.org.apache.log4j.HTMLLayout(以HTML表格形式佈局) 該選項有以下幾種: LocationInfo=true:默認值是false,輸出java文件名稱和行號 Title=my app file: 默認值是 Log4J Log Messages. ii.org.apache.log4j.PatternLayout(可以靈活地指定佈局模式) 該選項有以下幾種: ConversionPattern=%m%n :指定怎樣格式化指定的消息 其中%m%n等符號所代表的含義如下: -X號: X信息輸出時左對齊; %p: 輸出日誌信息優先級,即DEBUG,INFO,WARN,ERROR,FATAL, %d: 輸出日誌時間點的日期或時間,默認格式爲ISO8601,也可以在其後指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},輸出類似:2002年10月18日 22:10:28,921 %r: 輸出自應用啓動到輸出該log信息耗費的毫秒數 %c: 輸出日誌信息所屬的類目,通常就是所在類的全名 %t: 輸出產生該日誌事件的線程名 %l: 輸出日誌事件的發生位置,相當於%C.%M(%F:%L)的組合,包括類目名、發生的線程,以及在代碼中的行數。舉例:Testlog4.main(TestLog4.java:10) %x: 輸出和當前線程相關聯的NDC(嵌套診斷環境),尤其用到像java servlets這樣的多客戶多線程的應用中。 %%: 輸出一個"%"字符 %F: 輸出日誌消息產生時所在的文件名稱 %L: 輸出代碼中的行號 %m: 輸出代碼中指定的消息,產生的日誌具體信息 %n: 輸出一個回車換行符,Windows平臺爲"\r\n",Unix平臺爲"\n"輸出日誌信息換行 可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如: %20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,默認的情況下右對齊。 %-20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,"-"號指定左對齊。 %.30c:指定輸出category的名稱,最大的寬度是30,如果category的名稱大於30的話,就會將左邊多出的字符截掉,但小於30的話也不會有空格。 %20.30c:如果category的名稱小於20就補空格,並且右對齊,如果其名稱長於30字符,就從左邊交遠銷出的字符截掉。 如:%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n [TEST] %p [%t] %C.%M(%L) | %m%n iii.org.apache.log4j.SimpleLayout(包含日誌信息的級別和信息字符串) iv.org.apache.log4j.TTCCLayout(包含日誌產生的時間、線程、類別等等信息)
4.其他
log4j.logger.com. neusoft =DEBUG 指定com.neusoft包下的所有類的等級爲DEBUG。
log4j.logger.com.opensymphony.oscache=ERROR log4j.logger.net.sf.navigator=ERROR
這兩句是把這兩個包下出現的錯誤的等級設爲ERROR,如果項目中沒有配置EHCache,則不需要這兩句。
log4j.logger.org.apache.commons=ERROR log4j.logger.org.apache.struts=WARN
這兩句是struts的包。
log4j.logger.org.displaytag=ERROR
這句是displaytag的包。(QC問題列表頁面所用)
log4j.logger.org.springframework=DEBUG 此句爲Spring的包。
log4j.logger.org.hibernate.ps.PreparedStatementCache=WARN log4j.logger.org.hibernate=DEBUG
此兩句是hibernate的包。
三、將log寫入多個文件中。
log4j配置:
log4j.rootCategory=INFO,stdout log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss,SSS}[ColorClouds] %p [%t] %C.%M(%L) | %m%n log4j.logger.net.sf.navigator=INFO log4j.logger.org.springframework=INFO log4j.logger.runLogger= INFO,R log4j.appender.R=org.apache.log4j.RollingFileAppender log4j.appender.R.File=G:\\log\\runLog.log log4j.appender.R.MaxFileSize=51200KB #log4j.appender.R.File=${com.huawei.icity.webapp.root}/log/icity.log log4j.appender.R.layout=org.apache.log4j.PatternLayout log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss,SSS}[ColorClouds Run] %p [%t] %C.%M(%L) | %m%n #log4j.logger.businessLogger= INFO,B #log4j.appender.B=org.apache.log4j.RollingFileAppender #log4j.appender.B.File=G:\\log\\businessLog.log #log4j.appender.B.MaxFileSize=51200KB #log4j.appender.B.layout=org.apache.log4j.PatternLayout #log4j.appender.B.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss,SSS}[ColorClouds Business] %p [%t] %C.%M(%L) | %m%n log4j.logger.interfaceLogger= INFO,I log4j.appender.I=org.apache.log4j.RollingFileAppender log4j.appender.I.File=G:\\log\\interfaceLog.log log4j.appender.I.MaxFileSize=51200KB log4j.appender.I.layout=org.apache.log4j.PatternLayout log4j.appender.I.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss,SSS}[ColorClouds Interface] %p [%t] %C.%M(%L) | %m%n
java調用:
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class QueryMyMeetingAction extends BaseFlowAction
{
/**
* uid
*/
private static final long serialVersionUID = 7612831197603586815L;
private static Log runLog = LogFactory.getLog("runLogger");//運行日誌
private static Log interfaceLog = LogFactory.getLog("interfaceLogger");//接口日誌
public String execute() throws Exception
{
interfaceLog.info("====>>請求");
runLog.info("請求02" );
return super.execute();
}
}