java.util.logging.Logger使用详解 (转)

Posted 2020-08-14

http://lavasoft.blog.51cto.com/62575/184492/

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

java.util.logging.Logger使用详解

 

 

java.util.logging.Logger不是什么新鲜东西了，1.4就有了，可是因为log4j的存在，这个logger一直沉默着，其实在一些测试性的代码中，jdk自带的logger比log4j更方便。

 

一、创建Logger对象

 

static Logger getLogger(String name)
          为指定子系统查找或创建一个 logger。
static Logger getLogger(String name, String resourceBundleName)
          为指定子系统查找或创建一个 logger。

注意：name是Logger的名称，当名称相同时候，同一个名称的Logger只创建一个。

 

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

 

三、简单实例

 

public static void main(String[] args) {
                Logger log = Logger.getLogger("lavasoft");
                log.setLevel(Level.INFO);
                Logger log1 = Logger.getLogger("lavasoft");
                System.out.println(log==log1);     //true
                Logger log2 = Logger.getLogger("lavasoft.blog");
                log2.setLevel(Level.WARNING);

                log.info("aaa");
                log2.info("bbb");
                log2.fine("fine");
        }
}

 

true
2009-7-28 20:00:30 TestLogger main
信息: aaa

Process finished with exit code 0

 

当注释掉        log2.setLevel(Level.WARNING);
输出结果：

true
2009-7-28 20:02:02 TestLogger main
信息: aaa
2009-7-28 20:02:02 TestLogger main
信息: bbb

Process finished with exit code 0

 

从这里可以看出，logger的名字是有层级关系的。这和log4j的控制方式完全一致。

 

下面是API文档的原文：

一般使用圆点分隔的层次命名空间来命名 Logger。Logger 名称可以是任意的字符串，但是它们一般应该基于被记录组件的包名或类名，如 java.net 或 javax.swing。此外，可以创建“匿名”的 Logger，其名称未存储在 Logger 命名空间中。

可通过调用某个 getLogger 工厂方法来获得 Logger 对象。这些方法要么创建一个新 Logger，要么返回一个合适的现有 Logger。

 

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

 

例子：

public static void main(String[] args) throws IOException {
                Logger log = Logger.getLogger("lavasoft");
                log.setLevel(Level.INFO);
                Logger log1 = Logger.getLogger("lavasoft");
                System.out.println(log==log1);     //true
                Logger log2 = Logger.getLogger("lavasoft.blog");
//                log2.setLevel(Level.WARNING);

                ConsoleHandler consoleHandler =new ConsoleHandler();
                consoleHandler.setLevel(Level.ALL);
                log.addHandler(consoleHandler);
                FileHandler fileHandler = new FileHandler("C:/testlog%g.log");
                fileHandler.setLevel(Level.INFO);
                log.addHandler(fileHandler);
                log.info("aaa");
                log2.info("bbb");
                log2.fine("fine");
        }
}

 

输出结果：

true
2009-7-28 20:36:14 TestLogger main
信息: aaa
2009-7-28 20:36:14 TestLogger main
信息: aaa
2009-7-28 20:36:14 TestLogger main
信息: bbb
2009-7-28 20:36:14 TestLogger main
信息: bbb

Process finished with exit code 0

 

查看C盘：

 

可见，默认的日志方式是xml格式，很烂。所以最好自定义下logger的格式。需要用Formatter来定义。

 

五、Logger的Formatter

 

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

 

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

 

java.util.logging.Formatter
  java.util.logging.SimpleFormatter
  java.util.logging.XMLFormatter

 

看个例子就明白了：

public static void main(String[] args) throws IOException {
                Logger log = Logger.getLogger("lavasoft");
                log.setLevel(Level.INFO);
                Logger log1 = Logger.getLogger("lavasoft");
                System.out.println(log == log1);     //true
                Logger log2 = Logger.getLogger("lavasoft.blog");
//                log2.setLevel(Level.WARNING);

                ConsoleHandler consoleHandler = new ConsoleHandler();
                consoleHandler.setLevel(Level.ALL);
                log.addHandler(consoleHandler);
                FileHandler fileHandler = new FileHandler("C:/testlog%g.log");
                fileHandler.setLevel(Level.INFO);
                fileHandler.setFormatter(new MyLogHander());
                log.addHandler(fileHandler);

                log.info("aaa");
                log2.info("bbb");
                log2.fine("fine");
        }
}

class MyLogHander extends Formatter {
        @Override
        public String format(LogRecord record) {
                return record.getLevel() + ":" + record.getMessage()+"\n";
        }
}

 

输出：

在控制和C盘输出的文件如图

 

到此，Java自带的Logger内容就没了。

感觉格式很不爽。自定义的XML格式很烂。