java logtail_Java日志工具之java.util.logging.Logger

今天总结下JDK自带的日志工具Logger，虽然它一直默默无闻，但有时使用它却比较方便。更详细的信息可以查看JDK API手册，本文只是简单示例入门。

创建Logger

我们可以使用Logger的工厂方法

public static Logger getLogger(String name)

来创建，其中name是logger 的名称，这应该是一个圆点分隔的名称，并且通常应该基于子系统的包名或类名(如net.oseye)，这是就Logger的名称空间。如果已经创建了具有给定名称的 logger，则返回该 logger。否则创建一个新的 logger。

每个Logger都有一个"父"Logger，也就是 Logger 名称空间中与其最近的现有祖先，而最顶层有个“Root”Logger，是所有Logger的顶级祖先。

Logger的级别

Level 类定义了一组可用来控制日志输出的标准日志级别。日志 Level 对象是有序的，并且是通过有序的整数来指定。在给定的级别上启用日志记录也就启用了所有较高级别的日志记录。 客户机一般应该使用预定义的 Level 常量(如 Level.SEVERE)。

Logger的级别是比较详细，全部定义在java.util.logging.Level里面，各级别按降序排列如下：

SEVERE(最高值)

WARNING

INFO

CONFIG

FINE

FINER

FINEST(最低值)

此外，还有一个级别 OFF，可用来关闭日志记录，使用级别 ALL 启用所有消息的日志记录。

每个Logger都只关心自己的最低 Level。如果将 Logger 的级别设置为 null，那么它的有效级别继承自父 Logger，这可以通过其父 Logger 一直沿树向上递归得到。

logger默认的级别是INFO，比INFO更低的日志将不显示，Logger的默认级别定义是在jre安装目录的lib下的logging.properties(properties的使用讲解)文件中：

############################################################

# Global properties

############################################################

.....

# Default global logging level.

# This specifies which kinds of events are logged across

# all loggers. For any given facility this global level

# can be overriden by a facility specific level

# Note that the ConsoleHandler also has a separate level

# setting to limit messages printed to the console.

.level= INFO

简单示例

package net.oseye;

import java.util.logging.Logger;

public class RunMain {

public static void main(String[] args) {

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

Logger logtmp=Logger.getLogger("oseye");

log.fine("fine日志测试");

log.info("info日志测试");

log.warning("warning日志测试");

System.out.println(log==logtmp);

System.out.println(System.getProperty("java.home"));

}

}

输出：

三月 15, 2014 11:14:04 上午 net.oseye.RunMain main

INFO: info日志测试

三月 15, 2014 11:14:04 上午 net.oseye.RunMain main

WARNING: warning日志测试

true

C:\Program Files\Java\jre7

可以看到比info级别低的fine日志没有显示，而log和logtmp都是名为"oseye"的Logger。

此时你可以修改logging.properties来设置级别，但首先需要确定你用的那个JRE(安装JDK后会有多个JRE)，只有找到正确的JRE修改的配置才有效，本例中使用的JRE是：

C:\Program Files\Java\jre7

Logger的Handler

Handler 对象从 Logger 中获取日志信息，并将这些信息导出，而且向父级递归传递信息。例如，它可将这些信息写入控制台或文件中，也可以将这些信息发送到网络日志服务中，或将其转发到操作系统日志中。 Handler 类通常使用 LogManager 属性来设置 Handler 的 Filter、Formatter 和 Level 的默认值。Handler的子类如下：

java.util.logging.Handler

java.util.logging.MemoryHandler

java.util.logging.StreamHandler

java.util.logging.ConsoleHandler

java.util.logging.FileHandler

java.util.logging.SocketHandler

可以使用下面的方法来操作Handler:

public void addHandler(Handler handler) //添加

public void removeHandler(Handler handler) //删除

public Handler[] getHandlers() //获取

public void setUseParentHandlers(boolean useParentHandlers) //是否应该将其输出发送到它的父 Logger

示例代码：

package net.oseye;

import java.util.logging.ConsoleHandler;

import java.util.logging.Handler;

import java.util.logging.Logger;

public class RunMain {

public static void main(String[] args) {

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

Handler[] handleList=log.getHandlers();

System.out.println("oseye的handler数:"+handleList.length);

handleList=log.getParent().getHandlers();

System.out.println("oseye的父级handler数:"+handleList.length);

for(Handler h:handleList){

System.out.println(h);

}

log.addHandler(new ConsoleHandler());

log.info("两个handler处理，一个自定义，另一个是祖先");

}

}

输出：

oseye的handler数:0

oseye的父级handler数:1

java.util.logging.ConsoleHandler@125844f

三月 15, 2014 11:35:12 上午 net.oseye.RunMain main

INFO: 两个handler处理，一个自定义，另一个是祖先

三月 15, 2014 11:35:12 上午 net.oseye.RunMain main

INFO: 两个handler处理，一个自定义，另一个是祖先

默认的oseye是没有handler的，但其父级有默认的是ConsoleHander，这个可以在默认的logging.properties配置文件可以看到：

handlers= java.util.logging.ConsoleHandler

增加了一个ConsoleHandler，可以看到信息是向上传递的，直到达到顶层，但可以使用setUseParentHandlers来设置是否传递；

每个handler也可以设置自己的Level，这个留给你当家庭作业吧。

日志内容的格式化

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

package net.oseye;

import java.io.File;

import java.util.logging.FileHandler;

import java.util.logging.Formatter;

import java.util.logging.Level;

import java.util.logging.LogRecord;

import java.util.logging.Logger;

public class RunMain {

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

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

FileHandler fileHandler=new FileHandler("d:"+File.separator+"log.txt");

fileHandler.setFormatter(new Formatter() {

@Override

public String format(LogRecord arg0) {

return arg0.getLoggerName()+"\t"+arg0.getLevel()+"\t"+arg0.getMessage();

}

});

fileHandler.setLevel(Level.WARNING);

log.addHandler(fileHandler);

log.setUseParentHandlers(false);

log.warning("警告信息");

}

}

示例中使用了FileHandler，而且禁止日志消息向上传递，在"d:\log.txt"中可以看到：

oseye WARNING 警告信息

在setFormatter时我使用匿名类(你可以使用别的方式)，其中LogRecord 对象用于在日志框架和单个日志 Handler 之间传递日志请求。

自定义配置文件

自定义配置文件有两种方式：

Logger默认的是使用jre安装目录的lib下的logging.properties配置文件，但logging.properties明确的给出使用其他自定义配置文件的说明：

############################################################

# Default Logging Configuration File

#

# You can use a different file by specifying a filename

# with the java.util.logging.config.file system property.

# For example java -Djava.util.logging.config.file=myfile

############################################################

因此如果你的配置文件是"d:\logging.properties"，当你执行的使用这样用即可：

java -Djava.util.logging.config.file=d:\logging.properties net.oseye.RunMain

使用LogManager

Logger默认的是使用jre安装目录的lib下的logging.properties配置文件，这可以从java.util.logging.LogManager的代码看出：

从代码中我们可以有两种方式加载自定义配置文件，第一种是指定加载自定义的LogManager类，然后再在LogManager来加载自定义配置文件；第二种方式是通过设置"java.util.logging.config.file"系统属性，从而加载自定义配置文件。

我们用第二种示例，第一种作为家庭作业吧

package net.oseye;

import java.util.logging.Logger;

public class RunMain {

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

System.setProperty("java.util.logging.config.file", "d:\\logging.properties");

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

log.warning("警告信息");

}

}

上面示例我用的是绝对路径，实际生成中切记不可如此，可根据需求自己修改。