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

三、简单实例

1、类实例

package com.soufang;

import java.util.logging.Logger;

import java.util.logging.Level;

public class TestLogger { 

    public static void main(String[] args) { 

            Logger log = Logger.getLogger("log"); 

            // 设定日志级别

            log.setLevel(Level.INFO); 

            Logger log1 = Logger.getLogger("log"); 

            System.out.println(log==log1);     //true 

            Logger log2 = Logger.getLogger("log.log"); 

            log2.setLevel(Level.WARNING); 

            log.info("aaa"); 

            log2.info("bbb"); 

            log2.fine("fine"); 

    } 

}

 2、输出结果

true

2015-6-27 15:18:47 com.soufang.TestLogger main

信息: aaa

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

true

2015-6-27 15:20:28 com.soufang.TestLogger main

信息: aaa

2015-6-27 15:20:29 com.soufang.TestLogger main

信息: bbb

从这里可以看出，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 的默认值。

1、 列子：

package com.soufang;

import java.util.logging.Logger;

import java.util.logging.Level;

import java.util.logging.FileHandler;

import java.util.logging.ConsoleHandler;

import java.io.IOException;

public class TestLogger { 

    public static void main(String[] args) throws IOException { 

        Logger log = Logger.getLogger("log"); 

        log.setLevel(Level.INFO); 

        Logger log1 = Logger.getLogger("log"); 

        System.out.println(log==log1);     //true 

        Logger log2 = Logger.getLogger("log.blog"); 

        //log2.setLevel(Level.WARNING); 

        // 输出到控制台

        ConsoleHandler consoleHandler =new ConsoleHandler(); 

        // 设置输出级别

        consoleHandler.setLevel(Level.ALL); 

        log.addHandler(consoleHandler); 

        // 输出到指定的file中，即d盘中

        FileHandler fileHandler = new FileHandler("D:/testlog.log"); 

        // 设置输出级别，

        fileHandler.setLevel(Level.INFO); 

        log.addHandler(fileHandler); 

        log.info("aaa"); 

        log2.info("bbb"); 

} 

}

2、输出结果：

true

2015-6-27 15:27:22 com.soufang.TestLogger main

信息: aaa

2015-6-27 15:27:22 com.soufang.TestLogger main

信息: aaa

2015-6-27 15:27:22 com.soufang.TestLogger main

信息: bbb

2015-6-27 15:27:22 com.soufang.TestLogger main

信息: bbb

这里看到有两个aaa和bbb 是因为log输出了一次, ConsoleHandler输出了一次

3、在FileHandler中指定了输出到D盘,查看D盘：

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

五、Logger的Formatter

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

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

1、 实例：

package com.soufang;

import java.util.logging.Formatter; 

import  java.util.logging.SimpleFormatter ;

import  java.util.logging.XMLFormatter;

import java.util.logging.*;

import java.io.IOException;

public class TestLogger { 

        public static void main(String[] args) throws IOException { 

                Logger log = Logger.getLogger("log"); 

                log.setLevel(Level.INFO); 

                Logger log1 = Logger.getLogger("log"); 

                System.out.println(log == log1);     //true 

                Logger log2 = Logger.getLogger("log.log"); 

                //log2.setLevel(Level.WARNING); 

                ConsoleHandler consoleHandler = new ConsoleHandler(); 

                consoleHandler.setLevel(Level.ALL); 

                log.addHandler(consoleHandler); 

                // 这种方式就是日志可以进行累加

                //FileHandler fileHandler = new FileHandler("D:/testlog.log",true);

                // 日志不能进行累加

                FileHandler fileHandler = new FileHandler("D:/testlog.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"; 

    } 

}

2、 Log和ConsoleHandler输出到控制台的自定义格式的信息：

true

级别：INFO-日志信息:aaa

2015-6-27 15:46:38 com.soufang.TestLogger main

信息: aaa

级别：INFO-日志信息:bbb

2015-6-27 15:46:38 com.soufang.TestLogger main

信息: bbb

在D盘输出的文件格式如图

到此，Java自带的Logger内容就没了，按照自定义的格式输出 日志信息。