JDK Logger 简介 (zhuan)

http://antlove.iteye.com/blog/1924832

*******************************************

一 简述

java.util.logging是JDK自带的日志记录包。

默认情况下，JDK的LogManager会在JRE目录下的"lib/logging.properties"这个文件中读取配置。

JDK的日志包涉及handler,formatter,level

名词	描述
handler	将日志信息记录到指定的流之中，可能是控制台或者是一个文件或者是任意存储区域。 常用实现类 ConsoleHandler, FileHandler, SocketHandler
formatter	日志信息格式化类。常用实现类 SimpleFormatter, XMLFormatter
level	日志记录级别。 SEVERE（最高值） 、WARNING 、INFO 、CONFIG 、FINE 、FINER 、FINEST（最低值） ALL(记录所有信息)  OFF(不记录任何级别信息)

 

二 简单Demo

MySimpleFormatter.java

package logging.formatter;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.logging.Level;
import java.util.logging.LogRecord;
import java.util.logging.SimpleFormatter;
public class MySimpleFormatter extends SimpleFormatter{
    private SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    private StringBuilder sb = new StringBuilder();

    @Override
    public synchronized String format(LogRecord record)
    {
        Level level=record.getLevel();
        String time=sdf.format(new Date(record.getMillis()));
        String loggerName=record.getLoggerName();
        String message=record.getMessage();

        this.sb.append("[").append(level).append("]");
        this.sb.append(" ").append(time);
        this.sb.append(" ").append(loggerName);
        this.sb.append(" :").append(message);
        this.sb.append("
");
        return sb.toString();
    }
}

 

DefaultStreamHandler.java

package logging.handler;
import java.io.OutputStream;
import java.util.logging.StreamHandler;
public class DefaultStreamHandler extends StreamHandler {
    @Override
    public synchronized void setOutputStream(OutputStream out)
            throws SecurityException {
        super.setOutputStream(out);
    }
}

 

CustomLogManager.java

package logging.util;
import java.io.IOException;
import java.io.InputStream;
import java.util.logging.ConsoleHandler;
import java.util.logging.FileHandler;
import java.util.logging.Level;
import java.util.logging.LogManager;
import java.util.logging.Logger;
import logging.formatter.MySimpleFormatter;
import logging.handler.DefaultStreamHandler;
public class CustomLogManager{
    static{
        LogManager.getLogManager().reset(); // reset the log manager
    }

    // read the log configuration from outside property file
    public static void resetFromPropertyFile(String filePath){
        LogManager logManager = LogManager.getLogManager();
        InputStream inputStream = CustomLogManagerEditor.class.getClassLoader().getResourceAsStream(filePath);
        try {
            logManager.readConfiguration(inputStream);
        } catch (Exception e) {
            throw new RuntimeException("reload log configuration fail: "+e.toString());
        }
    }


    public static Logger getLogger(String name){
        Logger logger=Logger.getLogger(name);
        logger.setLevel(Level.ALL);

        // add console handler
        ConsoleHandler consoleHandler=new ConsoleHandler();
        consoleHandler.setLevel(Level.FINE);
        consoleHandler.setFormatter(new MySimpleFormatter());
        logger.addHandler(consoleHandler);

        // add file handler
        FileHandler fileHandler=null;
        try {
            fileHandler = new FileHandler("log.log",true);
            fileHandler.setLevel(Level.FINE);
            fileHandler.setFormatter(new MySimpleFormatter());
            logger.addHandler(fileHandler);
        } catch (SecurityException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }

        // add default stream handler
        DefaultStreamHandler defaultStreamHandler = new DefaultStreamHandler();
        defaultStreamHandler.setLevel(Level.ALL);
        defaultStreamHandler.setFormatter(new MySimpleFormatter());
        defaultStreamHandler.setOutputStream(System.out);
        logger.addHandler(defaultStreamHandler);

        return logger;
    }
}

 

logging.properties

#Level的五个等级SEVERE（最高值） 、WARNING 、INFO 、CONFIG 、FINE 、FINER 、FINEST（最低值）  。这个不同于log4j
#指定默认logger级别
.level= ALL
#为 Handler 指定默认的级别（默认为 Level.INFO）。
java.util.logging.ConsoleHandler.level=FINE
# 指定要使用的 Formatter 类的名称（默认为 java.util.logging.SimpleFormatter）。
java.util.logging.ConsoleHandler.formatter=logging.formatter.MySimpleFormatter

# 为 Handler 指定默认的级别（默认为 Level.ALL）。
java.util.logging.FileHandler.level=ALL
# 指定要使用的 Formatter 类的名称（默认为 java.util.logging.XMLFormatter）。
java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
# 指定要写入到任意文件的近似最大量（以字节为单位）。如果该数为 0，则没有限制（默认为无限制）。
java.util.logging.FileHandler.limit=1024000
# 指定有多少输出文件参与循环（默认为 1）。
java.util.logging.FileHandler.count=1
# 为生成的输出文件名称指定一个模式。有关细节请参见以下内容（默认为 "%h/java%u.log"）。
java.util.logging.FileHandler.pattern=u.log
# 指定是否应该将 FileHandler 追加到任何现有文件上（默认为 false）。
java.util.logging.FileHandler.append=true

handlers= java.util.logging.ConsoleHandler,java.util.logging.FileHandler

 

测试类

Main.java

 

package logging;
import java.io.IOException;
import java.util.logging.Logger;
import logging.util.CustomLogManager;
public class Main {
    public static void main(String[] args) throws SecurityException, IOException {
//      CustomLogManager.resetFromPropertyFile("logging/logging.properties");
//      Logger logger=Logger.getLogger(Main.class.getName());

        Logger logger=CustomLogManager.getLogger(Main.class.getName());

        logger.fine("warning test!");
    }
}

 

 Note:

CustomLogManagerEditor.getLogger返回的logger拥有三个handler，所以记录日志信息的时候，日志信息会被存储到三个区域【log.log,System.out,System.err】。

当启用CustomLogManagerEditor.resetFromPropertyFile("logging/logging.properties");时，日志信息会被记录到控制台，以及u.log文件。

如果即调用CustomLogManagerEditor.resetFromPropertyFile("logging/logging.properties");又通过CustomLogManagerEditor.getLogger返回的logger记录日志，因为logger有5个handler，所以日志信息会被记录到4个区域【u.log,log.log,System.out,System.err】 其中在System.err中会记录2次。