引言
作為一名Java 程序員，最熟悉的、使用最多的調用恐怕莫過于System.out.print(“…”)。當你沒有調試工具而要跟蹤一個變量的值得時候；當你需要顯示捕獲的Exception、Error的時候；當你想知道程序在運行的時候究竟發生了什么的時候，通常的做法就是調用System.out.print把他們在終端、控制臺上打印出來。這種方式對于輸出信息的分類、格式化及永久保存帶來諸多不便。雖然我們可以把它寫入一個文件然后進行分析，但是這要需要編寫額外的程序代碼，其成本不可忽視！而由此給目標系統本身增加的復雜程度不可避免的使開發、調試陷入一個深深的迷潭。

JDK1.4的推出，使得這一切即將成為歷史。讓我們向System.out.print()告別吧，使用Java Logging API為自己的程序構建一個完整的日志記錄系統！

一、第一個實例

    先看一個簡單的實例：SimpleLoggingTest.java

1  import java.util.logging.*;

2 public class SimpleLoggingTest {

3      public static void main(String args[]) {

4           //程序的其它處理

5           //使用Logger的靜態方法獲得一個匿名          //Logger

6           Logger logger1 = Logger.getAnonymousLogger();

7           //記錄消息

8           logger1.log(Level.INFO,"第一條日志記錄");

9           //程序的其它處理

10      }

11 }

注意：編譯、執行該程序需要JDK1.4及以上版本的支持。

運行該程序，可以在控制臺看到程序運行結果：

2003-1-14 15:09:40 SimpleLoggingTest main

信息: 第一條日志記錄

首先，程序引用java.util.Logging包（第1行）。接著，在適當的時候獲得一個Logger(記錄器)類的實例（第6行，獲取一個匿名的Logger）。最后，在程序需要記錄信息的地方調用Logger類的log方法進行記錄（第8行，記錄一個INFO級別的消息）。

二、Java Logging API

     Java Logging API封裝在JDK1.4.0的java.util.Logging包中。它通過產生便于最終用戶、系統管理員、故障維護工程師以及軟件開發團隊（工程師）進行分析的日志記錄為軟件的開發調試和維護提供便利的手段。它捕獲操作系統平臺和執行程序的安全故障、配置錯誤、執行瓶頸和（或）Bug等數據信息，以純文本、XML或程序員自定的某種方式將其格式化成日志記錄，然后傳遞給內存、系統輸出流、控制臺、文件、Sockets等多種系統資源進行緩存和輸出。

(一)該軟件包中的關鍵類：

   Logger:  應用程序進行日志記錄調用的主要實體。 Logger對象用于記錄特定系統或應用程序的消息。

   LogRecord:  用于在日志框架和單個記錄處理程序之間傳遞記錄請求。

   Handler:  日志數據的最終輸出處理器。它將LogRecord對象導出到各種目標，包括內存、輸出流、控制臺、文件和套接字。多種 Handler子類可供用于這種用途。

   Level:  定義一組標準的記錄級別，可用于控制記錄的輸出。可以把程序配置為只輸出某些級別的記錄，而忽略其他級別的輸出。

   Filter:  精細過濾、控制記錄的內容，比記錄級別所提供的控制準確得多。記錄API支持通用的過濾器機制，這種機制允許應用程序代碼添加任意過濾器以便控制記錄的輸出。

   Formatter:  為LogRecord對象的格式化提供支持。

   LogManager: Java Logging框架中唯一的、全局的對象，用于維護與Logger記錄器及日志服務的一系列共享的數據結構及狀態。它負責整個日志框架的初始化、維護一組全局性的Handle對象、維護一個樹形結構的Logger的名字空間、診測日志框架配置文件的改變從而重新讀入并應用相關的參數以及負責程序停止運行時整個日志框架的清理工作。

(二)Logger

1、Logger的命名空間

在SimpleLoggingTest.java實例中，我們使用了一個匿名的（沒有命名的）Logger對象。在Java Logging 框架中，Logger是可以命名的。Logger的名字空間與java類的名字空間相同的結構相同：使用“.”間隔的字符串。Logger的名字空間體現了Logger的層次結構。例如：命名為“a.b”的Logger是命名為“a.b.c”的“父”（上一級）Logger記錄器。Logger的命名可以是任意的字符串，一般情況下，使用包或類的名字為Logger 進行命名。

Logger的名字空間由全局單列類LogManager的實例進行創建、維護。

匿名Logger不被存儲在命名空間中。

2、創建Logger實例

Logger對象可以通過調用工廠方法getLogger或getAnonymousLogger獲取。

//獲取一個名為“A”的Logger對象

Logger loggerA= Logger.getLogger(“A”);

// 獲取一個名為“A.B”的Logger對象，其上級記錄器為loggerA。

Logger loggerAB= Logger.getLogger(“A.B”);

//獲取一個匿名Logger對象

Logger loggerTmp = Logger.getAnonymousLogger();

對非匿名Logger，getLogger先在命名空間中查找同名的Logger對象，如果有，則返回該Logger對象；如果不存在，則在命名空間中創建注冊一個新的Logger對象，并與其上級Logger對象相關聯。

匿名Logger對象屬于創建它的對象的私有對象，只能由創建它的對象使用，記錄一些臨時性的日志信息。而命名Logger對象使全局性的，在日志框架的生存期內，除了創建它的對象外還，可由其它對象用于記錄日志信息。

匿名的Logger對象由一個全局的的root Logger “” 對象（root Logger的名字為空）。這意味著所有匿名Logger對象將從root Logger “”中繼承行為。

匿名Logger對象通常用于java Applet應用中。它去掉了在運行過程中的一班性的安全檢查，允許其創建類對象對Logger的控制、狀態信息進行修改，如：setLevel設置Logger的日志消息記錄級別；addHandle增加Logger的Handle（處理器）對象等。

一個Logger對象可以擁有有零個到多個Handler實例。當沒有Handler時，如不禁止日志記錄沿名字空間向上傳遞，那該Logger對象的日志消息記錄將有其擁有Handler實例的上級Logger進行處理。當一個Logger對象擁有多個Handler實例對象時，其記錄的日志數據將被所有的Handler逐一進行處理。

（三）Handler
 Handler對象接收傳來的日志消息將其輸出。Handler可以把日志消息輸出到多種目標資源，如：輸出到控制臺進行顯示、寫入日志文件、傳送到網絡上的遠程日志服務進行處理、寫入系統日志等任何物理資源。
Handler對象在創建時使用LogManager對象的相關屬性的默認值（如Handler的Filter、Formatter、Level等對象屬性）進行初始化。
Handler對象可通過調用setLevel(Level.OFF)暫停工作；通過調用setLevel設置適當的記錄日志消息級別恢復工作。
Handler是一個抽象類。在J2SDK1.4中，其子類及它們之間的關系見圖一。

1、   MemoryHandler Handler的子類，在內存中的一個循環緩沖區用于緩存日志記錄請求。通常MemoryHandler只簡單的把傳入的LogRecords存儲到它的內存中。這種緩存的開銷非常低廉，它去掉了格式化所產生的系統消耗。當某個觸發條件滿足時，MemoryHandler將其緩沖的數據push(發布)到目標Handler，由后者執行實際的輸出。有三種模式觸發MemoryHandler進行push操作：a、傳入的LogRecords的級別高于MemoryHandler預先定義的push級別；b、有其他對象顯式的調用其push方法；c、其子類重載了log方法，逐一檢索每個傳入的LogRecords，若符合特定的標準則進行push操作

實例：假設我們需要跟蹤一個生產環境中的一個很少出現的Bug。在大多數場合，系統化產生大量的日志記錄，而我們僅只關心記錄中最近的幾條，那么我們只需要使用MemoryHandler對日志記錄進行緩存，當且僅當某個事件發生時將最近的幾條記錄從內存中 dump到制定的文件中。

  //MemoryHandlerTest.java

import java.util.logging.*;

import java.io.*;

public class MemoryHandlerTest {

   FileHandler fhandler;

   Logger logger;

   MemoryHandler mhandler;

   MemoryHandlerTest() {

          try {

                 //構造名為my.log的日志記錄文件

              fhandler = new FileHandler("my.log");

           int numRec = 5;

           //構造一個5個日志記錄的MemoryHandler，

//其目標Handler為一個FileHandler

           mhandler = new MemoryHandler (fhandler, numRec, Level.OFF) ;

            //構造一個記錄器

            logger = Logger.getLogger("com.mycompany");

            //為記錄器添加一個MemoryHandler

           logger.addHandler(mhandler);

       } catch (IOException e) {

       }

   }

   public static void main(String args[]) {

          MemoryHandlerTest mt = new MemoryHandlerTest();

          int trigger = (int)(Math.random()*100);

        for (int i=1;i<100;i++) {

               //在MemoryHandler中緩存日志記錄

                 mt.logger.log(Level.INFO,"日志記錄"+i);

                 if (i==trigger) {

                        //觸發事件成立，顯式調用MemoryHandler的

//push方法觸發目標Handler輸出日志記錄到

//my.log文件中

                        mt.mhandler.push();

                        break;

                 }

          }

   }

2、FileHandler 文件處理器

StreamHandler流處理器將日志記錄以流的形式輸出。FileHandler、ConsoleHandler、SocketHandler為StreamHandler的子類。 ConsoleHandler將日志記錄輸出到控制終端。前面的實例（實例2除外）都將日記記錄數據輸出到控制臺。

FileHandler將日志記錄輸出到特定的文件，或循環的幾個日志文件中。日志文件可以設置容量大小。當日志文件達到限定的容量時將被自動清空，重頭開始寫入新的日志記錄數據。

例：創建一個容量為1Mb的文件處理器

                            int limit = 1000000; // 1 Mb

                      FileHandler fh = new FileHandler("my.log", limit, 1);

對于循環的日志文件，每個文件將被指定容量限制。當當前的日志文件的長度達到制定值后該文件被關閉，新的日志文件被創建，舊的文件將在文件名模板后追加序號。如此產生多個順序編號的日志記錄文件。

例：

try {

        // 創建一個擁有3個日志文件，每個容量為1Mb的文件處理器

        String pattern = "my%g.log";

 int limit = 1000000; // 1 Mb

 int numLogFiles = 3;

  FileHandler fh = new FileHandler(pattern, limit, numLogFiles);

        …

 } catch (IOException e) {

 }

（四）Level

   Level對象定義了一組日志消息的級別，用于控制日志消息的輸出。一個級別對應一個整型值。日志消息級別按照其整數值的大小排定優先級。在Logger對象中設定一個級別，則大于等于該級別的日志消息將會被傳遞到某個Handler對象進行輸出處理。