java.util.logging.Logger使用詳解

java.util.logging.Logger使用詳解

 

 

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

 

三、簡單實例

 

public  class TestLogger { 
        public static void main(String[] args) { 
                Logger log = Logger.getLogger("lavasoft"); 
                log.setLevel(Level.INFO); 
                Logger log1 = Logger.getLogger("lavasoft"); 
                System.out.println(log==log1);     //true 
                Logger log2 = Logger.getLogger("lavasoft.blog"); 
                log2.setLevel(Level.WARNING); 

                log.info("aaa"); 
                log2.info("bbb"); 
                log2.fine("fine"); 
        } 
}

 

true  
2009-7-28 20:00:30 TestLogger main 
信息: aaa 

Process finished with exit code 0

 

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

true  
2009-7-28 20:02:02 TestLogger main 
信息: aaa 
2009-7-28 20:02:02 TestLogger main 
信息: bbb 

Process finished with exit code 0

 

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

 

下面是API文檔的原文：

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

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

 

四、Logger的Handler

 

Handler 對象從 Logger 中獲取日志信息，並將這些信息導出。例如，它可將這些信息寫入控制台或文件中，也可以將這些信息發送到網絡日志服務中，或將其轉發到操作系統日志中。

可通過執行 setLevel(Level.OFF) 來禁用 Handler，並可通過執行適當級別的 setLevel 來重新啟用。

Handler 類通常使用 LogManager 屬性來設置 Handler 的 Filter、Formatter 和 Level 的默認值。

java.util.logging.Handler  
  java.util.logging.MemoryHandler 
  java.util.logging.StreamHandler 
    java.util.logging.ConsoleHandler 
    java.util.logging.FileHandler 
    java.util.logging.SocketHandler

 

例子：

public  class TestLogger { 
        public static void main(String[] args) throws IOException { 
                Logger log = Logger.getLogger("lavasoft"); 
                log.setLevel(Level.INFO); 
                Logger log1 = Logger.getLogger("lavasoft"); 
                System.out.println(log==log1);     //true 
                Logger log2 = Logger.getLogger("lavasoft.blog"); 
//                log2.setLevel(Level.WARNING); 

                ConsoleHandler consoleHandler =new ConsoleHandler(); 
                consoleHandler.setLevel(Level.ALL); 
                log.addHandler(consoleHandler); 
                FileHandler fileHandler = new FileHandler("C:/testlog%g.log"); 
                fileHandler.setLevel(Level.INFO); 
                log.addHandler(fileHandler); 
                log.info("aaa"); 
                log2.info("bbb"); 
                log2.fine("fine"); 
        } 
}

 

輸出結果：

true  
2009-7-28 20:36:14 TestLogger main 
信息: aaa 
2009-7-28 20:36:14 TestLogger main 
信息: aaa 
2009-7-28 20:36:14 TestLogger main 
信息: bbb 
2009-7-28 20:36:14 TestLogger main 
信息: bbb 

Process finished with exit code 0

 

查看C盤：

 

可見，默認的日志方式是xml格式，很爛。所以最好自定義下logger的格式。需要用Formatter來定義。

 

五、Logger的Formatter

 

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

 

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

 

java.util.logging.Formatter  
  java.util.logging.SimpleFormatter 
  java.util.logging.XMLFormatter

 

看個例子就明白了：

public  class TestLogger { 
        public static void main(String[] args) throws IOException { 
                Logger log = Logger.getLogger("lavasoft"); 
                log.setLevel(Level.INFO); 
                Logger log1 = Logger.getLogger("lavasoft"); 
                System.out.println(log == log1);     //true 
                Logger log2 = Logger.getLogger("lavasoft.blog"); 
//                log2.setLevel(Level.WARNING); 

                ConsoleHandler consoleHandler = new ConsoleHandler(); 
                consoleHandler.setLevel(Level.ALL); 
                log.addHandler(consoleHandler); 
                FileHandler fileHandler = new FileHandler("C:/testlog%g.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"; 
        } 
}

 

輸出：

在控制和C盤輸出的文件如圖