程式師世界 >> 編程語言 >> JAVA編程 >> JAVA綜合教程 >> Java程序日志：java.util.logging.Logger類，

Java程序日志：java.util.logging.Logger類，

編輯：JAVA綜合教程

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 這個類

輸出結果：