3.java.util.logging.Logger使用详解

一.java.util.logging.Logger简介

java.util.logging.Logger不是什么新鲜东西了，1.4就有了，可是因为log4j的存在，这个logger一直沉默着，

其实在一些测试性的代码中，jdk自带的logger比log4j更方便。

二.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

三.简单的实例代码

package com.my.utils;

import java.io.IOException;
import java.util.logging.ConsoleHandler;
import java.util.logging.FileHandler;
import java.util.logging.Level;
import java.util.logging.Logger;

public class LoggerLog {
    public static void main(String[] args) {
        //create logger
        Logger logger = Logger.getLogger("LoggerLog");
        logger.setLevel(Level.INFO);

        //create console handler
        ConsoleHandler handler = new ConsoleHandler();
        handler.setLevel(Level.ALL);
        
        //add console handler to logger
        logger.addHandler(handler);
        
        try {
            //add fileHandler
            FileHandler fileHandler = new FileHandler("D:\java\test\test.txt");
            fileHandler.setLevel(Level.ALL);
            
            //add fileHandler to logger
            logger.addHandler(fileHandler);
        } catch (SecurityException | IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        
        logger.info("Start");
        logger.info("Running");
        logger.info("End");    
    
    }    

}

这时候你会发现 "Start" "Running" "End" 各在控制台上打印了两遍，是因为log输出了一次, ConsoleHandler输出了一次

在 new fileHandler 时，在文件后加参数可以控制是追加还是新建log文件。

FileHandler fh = new FileHandler(path,true).

Handler 对象从 Logger 中获取日志信息，并将这些信息导出。例如，它可将这些信息写入控制台或文件中，也可以将这些信息发送到网络日志服务中，或将其转发到操作系统日志中。
可通过执行 setLevel(Level.OFF) 来禁用 Handler，并可通过执行适当级别的 setLevel 来重新启用。
Handler 类通常使用 LogManager 属性来设置 Handler 的 Filter、Formatter 和 Level 的默认值。

检查D盘的输出日志如下：

<?xml version="1.0" encoding="GBK" standalone="no"?>
<!DOCTYPE log SYSTEM "logger.dtd">
<log>
<record>
  <date>2018-03-25T20:35:42</date>
  <millis>1521981342189</millis>
  <sequence>0</sequence>
  <logger>LoggerLog</logger>
  <level>INFO</level>
  <class>com.my.utils.LoggerLog</class>
  <method>main</method>
  <thread>1</thread>
  <message>Start</message>
</record>
<record>
  <date>2018-03-25T20:35:42</date>
  <millis>1521981342292</millis>
  <sequence>1</sequence>
  <logger>LoggerLog</logger>
  <level>INFO</level>
  <class>com.my.utils.LoggerLog</class>
  <method>main</method>
  <thread>1</thread>
  <message>Running</message>
</record>
<record>
  <date>2018-03-25T20:35:42</date>
  <millis>1521981342298</millis>
  <sequence>2</sequence>
  <logger>LoggerLog</logger>
  <level>INFO</level>
  <class>com.my.utils.LoggerLog</class>
  <method>main</method>
  <thread>1</thread>
  <message>End</message>
</record>
</log>

可见，默认的日志方式是xml格式，我们使用日志就是为了能够清晰的看到操作的相关信息而这种格式有点多，乱所以我们要自定义logger的格式。需要用Formatter来定义。

四.定义输出日志的Formatter

package com.my.utils;

import java.text.SimpleDateFormat;
import java.util.logging.Formatter;
import java.util.logging.LogRecord;

public class MyFormat extends Formatter {

    @Override
    public String format(LogRecord log) {
        // TODO Auto-generated method stub
        SimpleDateFormat format = new SimpleDateFormat("YYYY-MM-dd HH:mm:ss S");
        
        return log.getLevel() + ": " + format.format(log.getMillis())+" " + log.getMessage() +"
";
    }

}

然后把 Format 添加到 fileHandler 中

fileHandler.setFormatter(new MyFormat());

这时候 输出的日志文件就是比较清晰了，可以根据项目的实际需求定义合适的Format 

INFO: 2018-03-25 21:03:49 791 Start
INFO: 2018-03-25 21:03:49 909 Running
INFO: 2018-03-25 21:03:49 913 End

Formatter 为格式化 LogRecords 提供支持。 
一般来说，每个日志记录 Handler 都有关联的 Formatter。Formatter 接受 LogRecord，并将它转换为一个字符串。 
有些 formatter（如 XMLFormatter）需要围绕一组格式化记录来包装头部和尾部字符串。可以使用 getHeader 和 getTail 方法来获得这些字符串。

LogRecord 对象用于在日志框架和单个日志 Handler 之间传递日志请求。
LogRecord(Level level, String msg)   用给定级别和消息值构造 LogRecord。

 

2018-06-08 14:41

2019-02-14 10:41