JDK自带的日志Logging

OK，现在我们来研究下JDK自带的日志Logger。

从jdk1.4起，JDK开始自带一套日志系统。JDK Logger最大的优点就是不需要任何类库的支持，只要有Java的运行环境就可以使用。

相对于其他的日志空间，JDK自带的日志可谓是鸡肋，无论易用性，功能还是扩展性都要稍逊一筹，所以在商业系统中很好直接使用。

我们现在整理到日志系列了，所以这里只是做一个简单的介绍就好了，比较实际编码中也不会写到这部分代码。

JDK Logging把日志分为如下几个级别，等级依次升高。

all→finest→finer→fine→config→info→warning→server→off

如果将级别设为info，那么info值钱的低级别信息将不会输出，只有info级别只有的信息会输出，通过控制级别达到控制输出的目的。

具体看下面的代码：

package org.linkinpark.commons.logtest;

import java.util.logging.Level;
import java.util.logging.Logger;

/**
 * @创建作者： LinkinPark
 * @创建时间： 2016年2月22日
 * @功能描述： JDK自带日志测试
 */
public class LogJDKTest
{
	public static Logger log = Logger.getLogger(LogJDKTest.class.toString());

	public static void main(String[] args)
	{
		// all→finest→finer→fine→config→info→warning→server→off
		// 级别依次升高，后面的日志级别会屏蔽之前的级别
		log.setLevel(Level.INFO);
		log.finest("finest");
		log.finer("finer");
		log.fine("fine");
		log.config("config");
		log.info("info");
		log.warning("warning");
		log.severe("server");
	}

}

控制台输出如下：

二月 22, 2016 4:31:12 下午 org.linkinpark.commons.logtest.LogJDKTest main
信息: info
二月 22, 2016 4:31:12 下午 org.linkinpark.commons.logtest.LogJDKTest main
警告: warning
二月 22, 2016 4:31:12 下午 org.linkinpark.commons.logtest.LogJDKTest main
严重: server

1，JDK log默认会有一个控制台输出，用来输出INFO级别以上的信息，当然我们也可以调用logger的setLevel()方法来设值。

2，同时我们也可以设置多个输出（Hander），每个输出设置不用的level，然后通过addHandler添加到了log中，注意为log设置级别与为每个handler设置级别的意义是不同的。

代码如下：

package org.linkinpark.commons.logtest;

import java.util.logging.ConsoleHandler;
import java.util.logging.Handler;
import java.util.logging.Level;
import java.util.logging.Logger;

/**
 * @创建作者： LinkinPark
 * @创建时间： 2016年2月22日
 * @功能描述： JDK自带日志测试
 */
public class LogJDKTest
{
	public static Logger log = Logger.getLogger(LogJDKTest.class.toString());

	static
	{
		Handler console = new ConsoleHandler();
		console.setLevel(Level.SEVERE);
		log.addHandler(console);
	}

	public static void main(String[] args)
	{
		// all→finest→finer→fine→config→info→warning→server→off
		// 级别依次升高，后面的日志级别会屏蔽之前的级别
		log.setLevel(Level.INFO);
		log.finest("finest");
		log.finer("finer");
		log.fine("fine");
		log.config("config");
		log.info("info");
		log.warning("warning");
		log.severe("server");
	}

}

控制台输出如下：

// 下面的输出是默认控制台的
二月 22, 2016 4:32:41 下午 org.linkinpark.commons.logtest.LogJDKTest main
信息: info
二月 22, 2016 4:32:41 下午 org.linkinpark.commons.logtest.LogJDKTest main
警告: warning
二月 22, 2016 4:32:41 下午 org.linkinpark.commons.logtest.LogJDKTest main
严重: server
// 下面的输出是自己添加hander的
二月 22, 2016 4:32:41 下午 org.linkinpark.commons.logtest.LogJDKTest main
严重: server

根据级别等级，如果设为all，则所有的信息都会被输出，如果设为off，则所有的信息都不会输出。

• 这里贴出JDK关于该类的介绍

=====================================================================================================================================================================

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

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

日志消息被转发到已注册的 Handler 对象，该对象可以将消息转发到各种目的地，包括控制台、文件、OS 日志等等。

每个 Logger 都跟踪一个“父”Logger，也就是 Logger 名称空间中与其最近的现有祖先。

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

可以根据日志配置文件的属性来配置日志级别，在 LogManager 类的描述中对此有所说明。但是也可以通过调用 Logger.setLevel 方法动态地改变它。如果日志级别改变了，则此变化也会影响它的子 logger，因为任何级别为 null 的子 logger 的有效级别都继承自它的父 Logger。

对于每次日志记录调用，Logger 最初都依照 logger 的有效日志级别对请求级别（例如 SEVERE 或 FINE）进行简单的检查。如果请求级别低于日志级别，则日志记录调用将立即返回。

通过此初始（简单）测试后，Logger 将分配一个 LogRecord 来描述日志记录消息。接着调用 Filter（如果存在）进行更详细的检查，以确定是否应该发布该记录。如果检查通过，则将 LogRecord 发布到其输出 Handler。在默认情况下，logger 也将 LogRecord 沿树递推发布到其父 Handler。

每个 Logger 都有一个与其关联的 ResourceBundle 名称。该指定的包用于本地化日志消息。如果一个 Logger 没有自己的 ResourceBundle 名称，则它将通过其父 Logger 沿树递归继承到 ResourceBundle 名称。

大多数 logger 输出方法都带有 "msg" 参数。此 msg 参数可以是一个原始值，也可以是一个本地化的键。在格式化期间，如果 logger 具有（或继承）一个本地化 ResourceBundle，并且 ResourceBundle 包含 msg 字符串的映射关系，那么用本地化值替换 msg 字符串。否则使用原来的 msg 字符串。通常，格式器使用 java.text.MessageFormat 形式的格式来格式化参数，例如，格式字符串
"{0} {1}" 将两个参数格式化为字符串。

将 ResourceBundle 名称映射到 ResourceBundle 时，Logger 首先试图使用该线程的 ContextClassLoader。如果 ContextClassLoader 为 null，则 Logger 将尝试 SystemClassLoader。作为初始实现中的临时过渡功能，如果 Logger 无法从 ContextClassLoader 或 SystemClassLoaderis 中找到一个
ResourceBundle，则 Logger 将会向上搜索类堆栈并连续调用 ClassLoader 来试图找到 ResourceBundle（此调用堆栈搜索是为了允许容器过渡到使用 ContextClassLoader，该功能可能在以后版本中取消）。

格式化（包括本地化）是输出 Handler 的责任，它通常会调用格式器。

注意，格式化不必同步发生。它可以延迟，直到 LogRecord 被实际写入到外部接收器。

日志记录方法划分为 5 个主要类别：

• 一系列的 "log" 方法，这种方法带有日志级别、消息字符串，以及可选的一些消息字符串参数。

• 一系列的 "logp" 方法（即 "log precise"），其与 "log" 方法相似，但是带有显式的源类名称和方法名称。

• 一系列的 "logrb" 方法（即 "log with resource bundle"），其与 "logp" 方法相似，但是带有显式的在本地化日志消息中使用的资源包名称。

• 还有跟踪方法条目（"entering" 方法）、方法返回（"exiting" 方法）和抛出异常（"throwing" 方法）的便捷方法。

• 最后，还有一系列在非常简单的情况下（如开发人员只想为给定的日志级别记录一条简单的字符串）使用的便捷方法。这些方法按标准级别名称命名（"severe"、"warning"、"info" 等等)，并带有单个参数，即一个消息字符串。

对于不带显式源名和方法名的方法，日志记录框架将尽可能确定日志记录方法中调用了哪个类和方法。但是应认识到，这样自动推断的信息可能只是近似的，甚至可能是完全错误的。这是因为允许虚拟机在 JIT 编译时可以进行广泛的优化，并且可以完全移除栈帧，导致它无法可靠地找到调用的类和方法。

Logger 上执行的所有方法都是多线程安全的。

子类化信息：注意，对于名称空间中的任意点，LogManager 类都可以提供自身的指定 Logger 实现。因此，Logger 的任何子类（它们与新的 LogManager 类一起实现的情况除外）要注意应该从 LogManager 类获得一个 Logger 实例，并应该将诸如 "isLoggable" 和 "log(LogRecord)" 这样的操作委托给该实例。注意，为了截取所有的日志记录输出，子类只需要重写
log(LogRecord) 方法。所有其他日志记录方法作为在此 log(LogRecord) 方法上的调用而实现。

=====================================================================================================================================================================