log4j徹底研究

最近在搞一個項目架設，希望從構建一個項目方方面面都徹底研究透，增長實戰經驗。
今天先研究一下日誌的構建，這裏選擇了log4j--java方面比較流行的log框架，功能
很強大，使用起來也很方便了

      廢話少說，先看看一個史上最簡單的log例子，看看我是如何用最簡潔的設計實現將異常
等信息寫入日誌文件的。

項目文件結構
--------TestLog
           |----src
           |     |-com/janeky/log/Log.java
           |     |-log4j.properties
           |----bin
           |     |-com/janeky/log/Log 
           |----lib
           |     |-log4j-1.2.11.jar

Eclipse新建一個java project TestLog
新建一個com.janeky.log包
導入log4j的jar包
包裏新建一個Log.java

 

package com.janeky.log;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;

/**
 * @author janeky
 * Log演示程序
 */
public class Log {
 //Logger實例
 private Logger loger;
 //將Log類封裝成單實例的模式，獨立於其他類。以後要用到日誌的地方只要獲得Log的實例就可以方便使用
 private static Log log;
 //構造函數，用於初始化Logger配置需要的屬性
 private Log()
 {
  //獲得當前目錄路徑
  String filePath=this.getClass().getResource("/").getPath();
  //找到log4j.properties配置文件所在的目錄(已經創建好)
  filePath=filePath.substring(1).replace("bin", "src");
  //獲得日誌類loger的實例
  loger=Logger.getLogger(this.getClass());
  //loger所需的配置文件路徑
  PropertyConfigurator.configure(filePath+"log4j.properties");
 }

 static Log getLoger()
 {
  if(log!=null)
   return log;
  else
   return new Log();
 }

 //測試函數
 public static void main(String args[])
 {
  Log log=Log.getLoger();
  try
  {
   //引發異常
   int a=2/0;
  }catch(Exception e)
  {
   //控制檯打印異常信息
   e.printStackTrace();
   //寫入到日子文件
   log.loger.error("error", e);

  }
 }

}

 
在src文件夾中新建一個文本文檔 log4j.properties

#定義DEBUG優先級，R爲日誌輸出目的的
log4j.rootLogger=DEBUG, R
#設置日誌輸出類型,爲文件類型
log4j.appender.R=org.apache.log4j.FileAppender
#設置日誌文件名my.log
log4j.appender.R.file=my.log
#每次在文件尾寫入新的日誌信息
log4j.appender.R.Append=true
#日誌輸出信息格式類型
log4j.appender.R.layout=org.apache.log4j.PatternLayout
#日誌輸出信息格式爲 換行、換行、日期、優先級、[類名]、日誌信息、換行
log4j.appender.R.layout.ConversionPattern=%n%n%d%p[%c]-%m%n

 

運行吧，出錯了，恭喜你成功了，去TestLog目錄下尋找my.log日誌信息吧

以後再任何需要記錄日誌的地方只要使用下面語句就行了
Log log= Log.getLogger();
log.logger.error("something u like to record");

 

記錄日誌就是這麼簡單，不過你可以有其他的需要：

 

我要將日誌發到郵箱
我要將日誌寫到數據庫
我要每天的日誌自動歸檔
……

這些都可以通過修改配置log4j.properties配置文件來實現
以下是配置文件的語法

1. log4j.rootLogger = [level],appenderName,appenderName...
其中，level是日誌記錄的優先級，從高到低分別爲FATAL ERROR WARN INFO DEBUG 。當
你定義一個級別，只有等於或者高於這個基本的才進行處理。 可選的All打印所有日誌，OFF
關閉所有日誌輸出。
appenderName用於指定日誌信息輸出目的地，可以指定多個

 

2.配置appender

類型有以下幾種
org.apache.log4j.jdbc.JDBCAppender 存入數據庫
org.apache.log4j.net.SMTPAppender  發送到指定郵箱
net.cybercorlin.util.logger.appender.IMAppender 自定義類型
org.apache.log4j.ConsoleAppender 控制檯
org.apache.log4j.FileAppender 文件
org.apache.log4j.DailyRollingFileAppender 每天產生一個日誌文件
org.apache.log4j.RollingFileAppender 文件達到指定大小的時候產生一個新的文件
org.apache.log4j.WriterAppender 將日誌信息以流格式發送到任意指定的地方
*************可以參照文章後面從網上摘抄的例子************

 

3.配置日誌信息格式Layout
有以下幾種
org.apache.log4j.HTMLLayout HTML表格形式
org.apache.log4j.PatternLayout 自定義的佈局（下面將見到這麼自定義配置)
org.apache.log4j.SimpleLayout 只包含日誌信息基本和信息的字符信息
org.apache.log4j.TTCCLayout   包括日誌產生時間、線程、類別等信息

 

4.自定義的佈局中用到的格式化日誌信息
採用跟C語言中printf的方式，參數有
%m 輸出代碼中指定的信息 如 log.error("error")
%p 輸出優先級 就是上面提到的DEBUG,INFO等
%c 輸出所在類的全名
%r 輸出自應用啓用到輸出該log信息耗費的時間（毫秒）
%t 輸出產生該日子事件的線程名
%n 輸出換行符號 Windows平臺爲 "rn",unix平臺“n"
%d 輸出日誌時間點 默認格式是ISO8601 可以自定義格式，比如%d{yyy MM dd hh:mm:ss,sss}

在程序中使用log4j
記住，很簡單，就兩步驟，相信我，沒錯的:)

1.導入包
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;

2.獲取log實例
 Logger logger = Logger.getLogger

3配置log4j.properties
PropertyConfigurator.configure(log4j2.properties路徑);

就這些了，沒了，謝謝觀看，有什麼意見儘管說

 

 

********************從網上摘抄的一些配置實例*********************
http://hi.baidu.com/yitao/blog/item/7e6a0bd1740ce1d2562c8410.html

      log4j.rootLogger=DEBUG,CONSOLE,A1,im 
      #DEBUG,CONSOLE,FILE,ROLLING_FILE,MAIL,DATABASE 
      log4j.addivity.org.apache=true 
    
      ################### 
      # Console Appender 
      ################### 
      log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender 
      log4j.appender.Threshold=DEBUG 
      log4j.appender.CONSOLE.Target=System.out 
      log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout 
      log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
      #log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n 
    
      ##################### 
      # File Appender 
      ##################### 
      log4j.appender.FILE=org.apache.log4j.FileAppender 
      log4j.appender.FILE.File=file.log 
      log4j.appender.FILE.Append=false 
      log4j.appender.FILE.layout=org.apache.log4j.PatternLayout 
      log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
      # Use this layout for LogFactor 5 analysis 
    
      ######################## 
      # Rolling File 
      ######################## 
      log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender 
      log4j.appender.ROLLING_FILE.Threshold=ERROR 
      log4j.appender.ROLLING_FILE.File=rolling.log 
      log4j.appender.ROLLING_FILE.Append=true 
      log4j.appender.ROLLING_FILE.MaxFileSize=10KB 
      log4j.appender.ROLLING_FILE.MaxBackupIndex=1 
      log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout 
      log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
    
      #################### 
      # Socket Appender 
      #################### 
      log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender 
      log4j.appender.SOCKET.RemoteHost=localhost 
      log4j.appender.SOCKET.Port=5001 
      log4j.appender.SOCKET.LocationInfo=true 
      # Set up for Log Facter 5 
      log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout 
      log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n 
    
      ######################## 
      # Log Factor 5 Appender 
      ######################## 
      log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender 
      log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000 
    
      ######################## 
      # SMTP Appender 
      ####################### 
      log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender 
      log4j.appender.MAIL.Threshold=FATAL 
      log4j.appender.MAIL.BufferSize=10 
      [email protected] 
      log4j.appender.MAIL.SMTPHost=mail.hollycrm.com 
      log4j.appender.MAIL.Subject=Log4J Message 
      [email protected] 
      log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout 
      log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
    
      ######################## 
      # JDBC Appender 
      ####################### 
      log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender 
      log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test 
      log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver 
      log4j.appender.DATABASE.user=root 
      log4j.appender.DATABASE.password= 
      log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n') 
      log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout 
      log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
    
      log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender 
      log4j.appender.A1.File=SampleMessages.log4j 
      log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j' 
      log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout 
      ################### 
      #自定義Appender 
      ################### 
      log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender 
      log4j.appender.im.host = mail.cybercorlin.net 
      log4j.appender.im.username = username 
      log4j.appender.im.password = password 
      log4j.appender.im.recipient = [email protected] 
      log4j.appender.im.layout=org.apache.log4j.PatternLayout 
      log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n 
    
      log4j.properties配置文件講解如下： 
      # Set root logger level to DEBUG and its only appender to A1 
      #log4j中有五級logger 
      #FATAL 0 
      #ERROR 3 
      #WARN 4 
      #INFO 6 
      #DEBUG 7 
      配置根Logger，其語法爲： 
      #log4j.rootLogger = [ level ] , appenderName, appenderName, … 
      log4j.rootLogger=INFO, A1 ,R 
      #這一句設置以爲着所有的log都輸出 
      #如果爲log4j.rootLogger=WARN, 則意味着只有WARN,ERROR,FATAL 
      #被輸出，DEBUG,INFO將被屏蔽掉. 
      # A1 is set to be a ConsoleAppender. 
      #log4j中Appender有幾層如控制檯、文件、GUI組件、甚至是套接口服務器、NT的事件記錄器、UNIX Syslog守護進程等 
      #ConsoleAppender輸出到控制檯 
      log4j.appender.A1=org.apache.log4j.ConsoleAppender 
      # A1 使用的輸出佈局，其中log4j提供4種佈局.

      #org.apache.log4j.HTMLLayout（以HTML表格形式佈局） 
      #org.apache.log4j.PatternLayout（可以靈活地指定佈局模式）， 
      #org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串）， 
      #org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息） 
      log4j.appender.A1.layout=org.apache.log4j.PatternLayout 
      #靈活定義輸出格式 具體查看log4j javadoc org.apache.log4j.PatternLayout 
      #d 時間 .... 
      log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n 
      #R 輸出到文件 RollingFileAppender的擴展，可以提供一種日誌的備份功能。 
      log4j.appender.R=org.apache.log4j.RollingFileAppender 
      #日誌文件的名稱 
      log4j.appender.R.File=log4j.log 
      #日誌文件的大小 
      log4j.appender.R.MaxFileSize=100KB 
      # 保存一個備份文件 
      log4j.appender.R.MaxBackupIndex=1

      log4j.appender.R.layout=org.apache.log4j.TTCCLayout 
      #log4j.appender.R.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%c]-[%p] %m%n 
    
      配置根Logger，其語法爲： 
      log4j.rootLogger = [ level ] , appenderName, appenderName, ... 
      level 是日誌記錄的優先級 
      appenderName就是指定日誌信息輸出到哪個地方。您可以同時指定多個輸出目的地。 
      配置日誌信息輸出目的地Appender，其語法爲 
    
      log4j.appender.appenderName = fully.qualified.name.of.appender.class 
      log4j.appender.appenderName.option1 = value1 
      ... 
      log4j.appender.appenderName.option = valueN 
      Log4j提供的appender有以下幾種： 
      org.apache.log4j.ConsoleAppender（控制檯）， 
      org.apache.log4j.FileAppender（文件）， 
      org.apache.log4j.DailyRollingFileAppender（每天產生一個日誌文件）， 
      org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件）， 
      org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方） 
      配置日誌信息的格式（佈局），其語法爲： 
    
      log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class 
      log4j.appender.appenderName.layout.option1 = value1 
      .... 
      log4j.appender.appenderName.layout.option = valueN 
      Log4j提供的layout有以下幾種： 
      org.apache.log4j.HTMLLayout（以HTML表格形式佈局）， 
      org.apache.log4j.PatternLayout（可以靈活地指定佈局模式）， 
      org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串）， 
      org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息） 
    

簡化spring中的事務管理配置
      xml代碼: 
      <bean id="proxyService" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"> 
      <property name="transactionManager"><ref local="myTransactionManager"/></property> 
      <property name="target"> 
      <ref local="itemService"/> 
      </property> 
      <property name="transactionAttributes"> 
      <props> 
      <prop key="find*">PROPAGATION_REQUIRED,readOnly</prop> 
      <prop key="add*">PROPAGATION_REQUIRED</prop> 
      <prop key="update*">PROPAGATION_REQUIRED</prop> 
      <prop key="delete*">PROPAGATION_REQUIRED</prop> 
      <prop key="*">PROPAGATION_REQUIRED,readOnly</prop> 
      </props> 
      </property> 
      </bean> 
      <bean id="itemService" class="com.xxx.services.IServiceImpl"> 
      <property name="itemMasterDAO"><ref local="itemMasterDAO"/></property> 
      </bean> 
    
      系統中有多個service,但我們的事務策略大部分都是一樣的，難道非要每個service都要寫一個這樣的代理配置麼?當然不是.. 
      看下面代碼: 
      xml代碼: 
    
      <!-- Transactional proxy for the services --> 
      <bean id="baseTxProxy" lazy-init="true" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"> 
      <property name="transactionManager"><ref bean="transactionManager"/></property> 
      <property name="transactionAttributes"> 
      <props> 
      <prop key="*">PROPAGATION_REQUIRED</prop> 
      </props> 
      </property> 
      </bean> 
      <bean id="itemService" parent="baseTxProxy"> 
      <property name="target"> 
      <bean class="ItemServiceImpl" autowire="byName"/> 
      </property> 
      </bean>