log4j的使用

Log4j是Apache的一個開源項目，它允許開發者以任意間隔輸出日誌信息.。主要分爲兩部分：一是appender，是輸出日誌的方式；二是logger，是具體日誌輸出器

1.  Appender

　　其中，Log4j提供的appender有以下幾種：

　　org.apache.log4j.ConsoleAppender（輸出到控制檯）

　　org.apache.log4j.FileAppender（輸出到文件）

　　org.apache.log4j.DailyRollingFileAppender（每天產生一個日誌文件）

　　org.apache.log4j.RollingFileAppender（文件到達指定大小的時候產生一個新的文件）

　　org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）

例如：

<appender name=" ConsoleAppenderA"class="org.apache.log4j.ConsoleAppender">
        <param name="target" value="System.out"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"value="%-5p %x %c{2} -%m%n"/>
        </layout>
</appender>

<appender name="BUSINESSERRORAPPENDER" class="com.alibaba.common.logging.spi.log4j.DailyRollingFileAppender">
      <param name="file" value="${luna_loggingRoot}/usr/common/business-error.log"/>
      <param name="append" value="true"/>
      <param name="encoding" value="GBK"/>
      <layout class="org.apache.log4j.PatternLayout">
          <param name="ConversionPattern" value="%d %-5p %c{2} - %m%n"/>
      </layout>
  </appender>

其中，Log4j提供的layout有以下幾種：

　　org.apache.log4j.HTMLLayout（以HTML表格形式佈局）

　　org.apache.log4j.PatternLayout（可以靈活地指定佈局模式）

　　org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串）

　　org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）

　　格式化日誌信息

　　Log4J採用類似C語言中的printf函數的打印格式格式化日誌信息，打印參數如下：

　　%m 輸出代碼中指定的消息

　　%p 輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL

　　%r 輸出自應用啓動到輸出該log信息耗費的毫秒數

　　%c 輸出所屬的類目，通常就是所在類的全名

　　%t 輸出產生該日誌事件的線程名

　　%n 輸出一個回車換行符，Windows平臺爲“rn”，Unix平臺爲“n”

　　%d 輸出日誌時間點的日期或時間，默認格式爲ISO8601，也可以在其後指定格式，比如：%d{yyyy MMM ddHH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921

%l 輸出日誌事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。

2.  Logger

Log4j中有一個根日誌器

<root>
        <level value="$luna_loggingLevel"/>
        <appender-ref ref="PROJECT"/>
    <appender-ref ref="EXCEPTION_LOG"/>
    </root>

默認時系統中其他所有非根logger都會繼承根日誌器，logger如果有level屬性就會覆蓋繼承日誌器（比如根日誌器)的level屬性。而appender會疊加，即本logger的配置的appender加上繼承日誌器上的appender。

<logger name="com.alibaba.service.VelocityService">
        <level value="INFO"/>
        <appender-ref ref="ConsoleAppenderA"/>
</logger>

根據繼承原則得到這個logger的level是INFO，appender是ConsoleAppenderA、PROJECT、EXCEPTION_LOG。

也可以使logger不繼承其他logger，使用additivity="false"

<logger name="com.alibaba.china.pylon.enhancedmit.domain.Handler" additivity="false">
        <level value="info"/>
        <appender-ref ref="enhancedMITAppender"/>
    </logger>

其中，level 是日誌記錄的優先級，分爲OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定義的級別。Log4j建議只使用四個級別，優先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這裏定義的級別，您可以控制到應用程序中相應級別的日誌信息的開關。比如在這裏定義了INFO級別，只有等於及高於這個級別的才進行處理，則應用程序中所有DEBUG級別的日誌信息將不被打印出來。ALL:打印所有的日誌，OFF：關閉所有的日誌輸出。 appenderName就是指定日誌信息輸出到哪個地方。可同時指定多個輸出目的地。

appender-ref屬性即使用logger引用之前配置過的appender。

在程序中怎麼創建logger，並調用呢？

Logger logger =Logger.getLogger(VelocityService.class.getName());　

或

Logger logger =LogFactory.getLog(VelocityService.class);

logger.debug("Justtesting a log message with priority set to DEBUG");

logger.info("Just testinga log message with priority set to INFO");

logger.warn("Just testinga log message with priority set to WARN");

logger.error("Justtesting a log message with priority set to ERROR");

logger.fatal("Justtesting a log message with priority set to FATAL");

 

另注，logger對name中前綴默認也有繼承性，例：

<logger name="com.alibaba.service" additivity="false">
        <level value="INFO"/>
        <appender-ref ref="ConsoleAppenderA"/>
    </logger>
<logger name="com.alibaba.service.VelocityService">
       <level value="INFO"/>
        <appender-ref ref="FileAppenderA"/>
 </logger>

根據繼承原則名爲com.alibaba.service.VelocityService的logger的appender是FileAppenderA和ConsoleAppenderA，level的爲INFO。

參考資料：http://zhangjunhd.blog.51cto.com/113473/21014/