java.util.logging.Logger使用詳解，java.util.logging

java.util.logging.Logger使用詳解，java.util.logging
 

java.util.logging.Logger不是什麼新鮮東西了，1.4就有了，可是因為log4j的存在，這個logger一直沉默著，其實在一些測試性的代碼中，jdk內建的logger比log4j更方便。

一、建立Logger對象

static Logger getLogger(String name) 
          為指定子系統尋找或建立一個 logger。 
static Logger getLogger(String name, String resourceBundleName) 
          為指定子系統尋找或建立一個 logger。 

注意：name是Logger的名稱，當名稱相同時候，同一個名稱的Logger只建立一個。

二、Logger的層級

比log4j的層級詳細，全部定義在java.util.logging.Level裡面。

各層級按降序排列如下： 

· SEVERE（最高值） 

· WARNING 

· INFO 

· CONFIG 

· FINE 

· FINER 

· FINEST（最低值） 

此外，還有一個層級 OFF，可用來關閉日誌記錄，使用層級 ALL 啟用所有訊息的日誌記錄。

logger預設的層級是INFO，比INFO更低的日誌將不顯示。

Logger的預設層級定義是在jre安裝目錄的lib下面。

# Limit the message that are printed on the console to INFO and above. 
java.util.logging.ConsoleHandler.level = INFO

三、簡單一實例

1、類執行個體

package com.soufang;

import java.util.logging.Logger;

import java.util.logging.Level;

public class TestLogger { 

    public static void main(String[] args) { 

            Logger log = Logger.getLogger("log"); 

            // 設定記錄層級

            log.setLevel(Level.INFO); 

            Logger log1 = Logger.getLogger("log"); 

            System.out.println(log==log1);     //true 

            Logger log2 = Logger.getLogger("log.log"); 

            log2.setLevel(Level.WARNING); 

            log.info("aaa"); 

            log2.info("bbb"); 

            log2.fine("fine"); 

    } 

}

 2、輸出結果

true

2015-6-27 15:18:47 com.soufang.TestLogger main

資訊: aaa

當注釋掉        log2.setLevel(Level.WARNING);
輸出結果：

true

2015-6-27 15:20:28 com.soufang.TestLogger main

資訊: aaa

2015-6-27 15:20:29 com.soufang.TestLogger main

資訊: bbb

從這裡可以看出，logger的名字是有層級關係的。這和log4j的控制方式完全一致。

下面是API文檔的原文：

一般使用圓點分隔的層次命名空間來命名 Logger。Logger 名稱可以是任意的字串，但是它們一般應該基於被記錄組件的包名或類名，如 java.net 或 javax.swing。此外，可以建立“匿名”的 Logger，其名稱未儲存在 Logger 命名空間中。 

可通過調用某個 getLogger Factory 方法來獲得 Logger 對象。這些方法要麼建立一個新 Logger，要麼返回一個合適的現有 Logger。 

 

四、Logger的Handler

Handler 對象從 Logger 中擷取日誌資訊，並將這些資訊匯出。例如，它可將這些資訊寫入控制台或檔案中，也可以將這些資訊發送到部落格服務中，或將其轉寄到作業系統日誌中。
可通過執行 setLevel(Level.OFF) 來禁用 Handler，並可通過執行適當層級的 setLevel 來重新啟用。
Handler 類通常使用 LogManager 屬性來設定 Handler 的 Filter、Formatter 和 Level 的預設值。

1、 列子：

package com.soufang;

import java.util.logging.Logger;

import java.util.logging.Level;

import java.util.logging.FileHandler;

import java.util.logging.ConsoleHandler;

import java.io.IOException;

public class TestLogger { 

    public static void main(String[] args) throws IOException { 

        Logger log = Logger.getLogger("log"); 

        log.setLevel(Level.INFO); 

        Logger log1 = Logger.getLogger("log"); 

        System.out.println(log==log1);     //true 

        Logger log2 = Logger.getLogger("log.blog"); 

        //log2.setLevel(Level.WARNING); 

        // 輸出到控制台

        ConsoleHandler consoleHandler =new ConsoleHandler(); 

        // 設定輸出層級

        consoleHandler.setLevel(Level.ALL); 

        log.addHandler(consoleHandler); 

        // 輸出到指定的file中，即d盤中

        FileHandler fileHandler = new FileHandler("D:/testlog.log"); 

        // 設定輸出層級，

        fileHandler.setLevel(Level.INFO); 

        log.addHandler(fileHandler); 

        log.info("aaa"); 

        log2.info("bbb"); 

} 

}

2、輸出結果：

true

2015-6-27 15:27:22 com.soufang.TestLogger main

資訊: aaa

2015-6-27 15:27:22 com.soufang.TestLogger main

資訊: aaa

2015-6-27 15:27:22 com.soufang.TestLogger main

資訊: bbb

2015-6-27 15:27:22 com.soufang.TestLogger main

資訊: bbb

這裡看到有兩個aaa和bbb 是因為log輸出了一次, ConsoleHandler輸出了一次

3、在FileHandler中指定了輸出到D盤,查看D盤：

可見，預設的日誌方式是xml格式，我們使用日誌就是為了能夠清晰的看到操作的相關資訊而這種格式有點多，亂所以我們要自訂logger的格式。需要用Formatter來定義。

五、Logger的Formatter

Formatter 為格式化 LogRecords 提供支援。 
一般來說，每個日誌記錄 Handler 都有關聯的 Formatter。Formatter 接受 LogRecord，並將它轉換為一個字串。 
有些 formatter（如 XMLFormatter）需要圍繞一組格式化記錄來封裝頭部和尾部字串。可以使用 getHeader 和 getTail 方法來獲得這些字串。

LogRecord 對象用於在日誌架構和單個日誌 Handler 之間傳遞日誌請求。
LogRecord(Level level, String msg) 
          用給定層級和訊息值構造 LogRecord。

1、 執行個體：

package com.soufang;

import java.util.logging.Formatter; 

import  java.util.logging.SimpleFormatter ;

import  java.util.logging.XMLFormatter;

import java.util.logging.*;

import java.io.IOException;

public class TestLogger { 

        public static void main(String[] args) throws IOException { 

                Logger log = Logger.getLogger("log"); 

                log.setLevel(Level.INFO); 

                Logger log1 = Logger.getLogger("log"); 

                System.out.println(log == log1);     //true 

                Logger log2 = Logger.getLogger("log.log"); 

                //log2.setLevel(Level.WARNING); 

                ConsoleHandler consoleHandler = new ConsoleHandler(); 

                consoleHandler.setLevel(Level.ALL); 

                log.addHandler(consoleHandler); 

                // 這種方式就是日誌可以進行累加

                //FileHandler fileHandler = new FileHandler("D:/testlog.log",true);

                // 日誌不能進行累加

                FileHandler fileHandler = new FileHandler("D:/testlog.log"); 

                fileHandler.setLevel(Level.INFO); 

                fileHandler.setFormatter(new MyLogHander()); 

                log.addHandler(fileHandler); 

                log.info("aaa"); 

                log2.info("bbb"); 

                log2.fine("fine"); 

        } 

} 

class MyLogHander extends Formatter { 

// 方法重寫，自己定義日誌輸出的格式

    @Override 

    public String format(LogRecord record) { 

            return "層級："+record.getLevel() + "-日誌資訊:" + record.getMessage()+"\n"; 

    } 

}

2、 Log和ConsoleHandler輸出到控制台的自訂格式的資訊：

true

層級：INFO-日誌資訊:aaa

2015-6-27 15:46:38 com.soufang.TestLogger main

資訊: aaa

層級：INFO-日誌資訊:bbb

2015-6-27 15:46:38 com.soufang.TestLogger main

資訊: bbb

在D盤輸出的檔案格式

到此，Java內建的Logger內容就沒了，按照自訂的格式輸出 日誌資訊。

著作權聲明：本文為博主原創文章，未經博主允許不得轉載。