Java程式日誌：java.util.logging.Logger類，

Java程式日誌：java.util.logging.Logger類，
一、Logger 的層級

比log4j的層級詳細，全部定義在java.util.logging.Level裡面。
各層級按降序排列如下：
SEVERE（最高值）
WARNING
INFO
CONFIG
FINE
FINER
FINEST（最低值）
此外，還有一個層級 OFF，可用來關閉日誌記錄，使用層級 ALL 啟用所有訊息的日誌記錄。
logger預設的層級是INFO，比INFO更低的日誌將不顯示（但也會寫入檔案）。

注意：
高等級的Logger不會顯示（或寫入）低等級的記錄。
低等級的Logger會顯示（或寫入）高等級的記錄。

二、建立 Logger 對象

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

注意：name是Logger的名稱，一般使用圓點分隔的層次命名空間來命名 Logger 。
當名稱相同時候，同一個名稱的Logger只建立一個（不同引用指向同一logger，這意味著不同引用可以操作同一Logger）。

三、簡單一實例 --- 控制台列印 Logger

public class TestLogger {     public static void main(String[] args) {     //建立SEVERE層級的Logger    Logger severeLogger = Logger.getLogger("logger.severe"); //名為logger.severe    severeLogger.setLevel(Level.SEVERE);//設定logger等級    //建立WARNING層級的Logger    Logger warninglogger = Logger.getLogger("logger.warning");     warninglogger.setLevel(Level.WARNING);    //建立INFO層級的Logger    Logger infoLogger = Logger.getLogger("logger.info");    infoLogger.setLevel(Level.INFO);    //建立CONFIG層級的Logger    Logger configLogger = Logger.getLogger("logger.config");//比INFO等級更低的日誌將不顯示    configLogger.setLevel(Level.CONFIG);/*------------------------------------記錄測試----------------------------------*/    infoLogger.info("這是infoLogger的記錄");//記錄一條INFO層級的訊息    infoLogger.warning("低級能顯示進階資訊？");//由結果可知低層級的logger能 顯示/記錄 進階別的資訊    warninglogger.warning("這是warninglogger的記錄");    warninglogger.severe("低級能顯示進階資訊？");    warninglogger.info("進階能顯示低級資訊？");//由結果可知進階別的logger不能 顯示/記錄 低層級的資訊    severeLogger.severe("這是severeLogger的記錄");    severeLogger.warning("進階能顯示低級資訊？");    configLogger.config("這是configLogger的記錄");//INFO等級以下的Logger不會顯示 同等級/更低級 的訊息    Logger testLogger1 = Logger.getLogger("logger.info");//當名稱相同時候，同一個名稱的Logger只建立一個    System.out.println("同名的logger是否相等:" + (infoLogger == testLogger1));    testLogger1.setLevel(Level.SEVERE);//設定成高等級    infoLogger.info("這是infoLogger的記錄");    infoLogger.setLevel(Level.INFO);//再設定成低等級    infoLogger.info("這是infoLogger的記錄");    }}

 

輸出結果：

四、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

 

五、簡單一實例 --- 寫出 Logger 檔案

public class TestLogger {     public static void main(String[] args) throws IOException {    //建立SEVERE層級的Logger    Logger severeLogger = Logger.getLogger("logger.severe"); //名為logger.severe    severeLogger.setLevel(Level.SEVERE);//設定logger等級    //建立WARNING層級的Logger    Logger warninglogger = Logger.getLogger("logger.warning");     warninglogger.setLevel(Level.WARNING);    //建立INFO層級的Logger    Logger infoLogger = Logger.getLogger("logger.info");    infoLogger.setLevel(Level.INFO);    //建立CONFIG層級的Logger    Logger configLogger = Logger.getLogger("logger.config");//比INFO等級更低的日誌將不顯示    configLogger.setLevel(Level.CONFIG);    File logDir = new File("f:/logTest", "logDir");//建立檔案對象參數：父目錄,子目錄    logDir.mkdirs();//建立多級目錄    File logFile = new File(logDir.getAbsolutePath(),"logTest.log");//建立檔案對象    FileHandler fileHandler = new FileHandler(logFile.getAbsolutePath(), 10240, 1, true);//寫出記錄檔,參數：路徑,最大位元組數,要使用的檔案數,是否追加檔案。(達到最大位元組數後,會刪掉原來所有記錄,重新開始記錄)    fileHandler.setLevel(Level.ALL);//同樣地,高等級的FileHandler不會記錄低等級的訊息,ALL等級的FileHandler會記錄所有等級的訊息    //fileHandler.setFormatter(new MyLogFormatter());//設定自訂日誌記錄格式(預設是XML格式),該類在後文會提到。    infoLogger.addHandler(fileHandler);//添加Handler對象    infoLogger.info("infoLogger的info記錄");//將記錄寫入記錄檔    infoLogger.config("infoLogger的config記錄");//低於logger等級的記錄不會被寫入記錄檔    configLogger.addHandler(fileHandler);    configLogger.info("configLogger的info記錄");    configLogger.config("configLogger的config記錄");//如果FileHandler的等級為ALL或低於INFO,config等級的Logger也會被寫入記錄檔,只是不會在控制台列印出來    }}

 

輸出結果：（在F盤中可以找到寫出的記錄檔）

同樣地, Logger log()方法也能進行檔案的寫出,這裡不再贅述。

開啟檔案會發現，預設的日誌方式是xml格式。
我們也可以自訂logger的格式。
需要用Formatter來定義。

六、Logger 的 Formatter

Formatter 為格式化 LogRecords 提供支援。
一般來說，每個日誌記錄 Handler 都有關聯的 Formatter。
Formatter 接受 LogRecord，並將它轉換為一個字串。
LogRecord 對象用於在日誌架構和單個日誌 Handler 之間傳遞日誌請求。

幾種 Formatter :
java.util.logging.Formatter
java.util.logging.SimpleFormatter
java.util.logging.XMLFormatter

注意：
是 java.util.logging.Formatter ,要與 java.util.Formatter 區分開

七、簡單一實例 --- 自訂 Formatter

/**用於自訂格式化的類*/class MyLogFormatter extends Formatter {    @Override    public String format(LogRecord record) {    return record.getSourceClassName() + ": " + record.getSourceMethodName() + ": " + record.getLevel() + ": " + record.getMessage() + "\n";     } }

 

關於其他的格式化設定，可以參考API中 java.util.Formatter 這個類

輸出結果：