`
lishumingwm163.com
  • 浏览: 338023 次
  • 性别: Icon_minigender_1
  • 来自: 济南
社区版块
存档分类
最新评论

jdk logger 配置实用宝典

 
阅读更多

日志输出是所有系统必备的,很多开发人员可能因为常常使用log4j而忽视了JDK logging模块,两者之间是否有联系?是怎样的联系?JDK logging处理细节是怎么样的?本周抛砖引玉,先分析JDK logging机制。

***从例子开始

JDK Logging的使用很简单,如下代码所示,先使用Logger类的静态方法getLogger就可以获取到一个logger,然后在任何地方都可以通过 获取到的logger进行日志输入。比如类似logger.info("Main running.")的调用。

 

Java代码
  1. package com.bes.logging;  
  2.    
  3. import java.util.logging.Level;  
  4. import java.util.logging.Logger;  
  5.    
  6. public class LoggerTest {  
  7.       private static Loggerlogger = Logger.getLogger("com.bes.logging");  
  8.       public static void main(String argv[]) {  
  9.                // Log a FINEtracing message  
  10.                logger.info("Main running.");  
  11.                logger.fine("doingstuff");  
  12.                try {  
  13.                          Thread.currentThread().sleep(1000);// do some work  
  14.                } catch(Exception ex) {  
  15.                          logger.log(Level.WARNING,"trouble sneezing", ex);  
  16.                }  
  17.                logger.fine("done");  
  18.       }  
  19. }  


不做任何代码修改和JDK配置修改的话,运行上面的例子,你会发现,控制台只会出现【Main running.】这一句日志。如下问题应该呈现在你的大脑里…

 

 

1,【Main running.】以外的日志为什么没有输出?怎么让它们也能够出现?

2,日志中出现的时间、类名、方法名等是从哪里输出的?

3,为什么日志就会出现在控制台?

4,大型的系统可能有很多子模块(可简单理解为有很多包名),如何对这些子模块进行单独的日志级别控制?

5,扩充:apache那个流行的log4j项目和JDK的logging有联系吗,怎么实现自己的LoggerManager?

带着这些问题,可能你更有兴趣了解一下JDK的logging机制,本章为你分析这个简单模块的机制。

***术语解答:在深入分析之前,需要掌握以下术语

==>logger:对于logger,需要知道其下几个方面

1,代码需要输入日志的地方都会用到Logger,这几乎是一个JDK logging模块的代言人,我们常常用Logger.getLogger("com.aaa.bbb");获得一个logger,然后使用logger做日志的输出。

2,logger其实只是一个逻辑管理单元,其多数操作都只是作为一个中继者传递别的<角色>,比如 说:Logger.getLogger(“xxx”)的调用将会依赖于LogManager类,使用logger输入日志信息的时候会调用logger中 的所有handler进行日志的输入。

3,logger是有层次关系的,我们可一般性的理解为包名之间的父子继承关系。每个logger通常以java包名为其名称。子logger通常会从父logger继承logger级别、handler、ResourceBundle名(与国际化信息有关)等。

4,整个JVM会存在一个名称为空的root logger,所有匿名的logger都会把root logger作为其父

==>LogManager:整个JVM内部所有logger的管理,logger的生成、获取等操作都依赖于它,也包括配置文件的读取。 LogManager中会有一个Hashtable【private Hashtable<String,WeakReference<Logger>> loggers】用于存储目前所有的logger,如果需要获取logger的时候,Hashtable已经有存在logger的话就直接返回 Hashtable中的,如果hashtable中没有logger,则新建一个同时放入Hashtable进行保存。

==>Handler:用来控制日志输出的,比如JDK自带的ConsoleHanlder把输出流重定向到System.err输出,每次 调用Logger的方法进行输出时都会调用Handler的publish方法,每个logger有多个handler。我们可以利用handler来把 日志输入到不同的地方(比如文件系统或者是远程Socket连接).

==>Formatter:日志在真正输出前需要进行一定的格式话:比如是否输出时间?时间格式?是否输入线程名?是否使用国际化信息等都依赖于Formatter。

==>Log Level:不必说,这是做容易理解的一个,也是logging为什么能帮助我们适应从开发调试到部署上线等不同阶段对日志输出粒度的不同需求。JDK Log级别从高到低为OFF(231-1)—>SEVERE(1000)—>WARNING(900)—>INFO(800)—>CONFIG(700)—>FINE(500)—>FINER(400)—>FINEST(300)—>ALL(-231), 每个级别分别对应一个数字,输出日志时级别的比较就依赖于数字大小的比较。但是需要注意的是:不仅是logger具有级别,handler也是有级别,也 就是说如果某个logger级别是FINE,客户希望输入FINE级别的日志,如果此时logger对应的handler级别为INFO,那么FINE级 别日志仍然是不能输出的。

总结对应关系:

==>LogManager与logger是1对多关系,整个JVM运行时只有一个LogManager,且所有的logger均在LogManager中

==>logger与handler是多对多关系,logger在进行日志输出的时候会调用所有的hanlder进行日志的处理

==>handler与formatter是一对一关系,一个handler有一个formatter进行日志的格式化处理

==>很明显:logger与level是一对一关系,hanlder与level也是一对一关系

***Logging配置:

JDK默认的logging配置文件为:$JAVA_HOME/jre/lib/logging.properties,可以使用系统属性 java.util.logging.config.file指定相应的配置文件对默认的配置文件进行覆盖,配置文件中通常包含以下几部分定义:

1, handlers:用逗号分隔每个Handler,这些handler将会被加到root logger中。也就是说即使我们不给其他logger配置handler属性,在输出日志的时候logger会一直找到root logger,从而找到handler进行日志的输入。

2, .level是root logger的日志级别

3, <handler>.xxx是配置具体某个handler的属性,比如java.util.logging.ConsoleHandler.formatter便是为ConsoleHandler配置相应的日志Formatter.

4, logger的配置,所有以[.level]结尾的属性皆被认为是对某个logger的级别的定义,如 com.bes.server.level=FINE是给名为[com.bes.server]的logger定义级别为FINE。顺便说下,前边提到过 logger的继承关系,如果还有com.bes.server.webcontainer这个logger,且在配置文件中没有定义该logger的任 何属性,那么其将会从[com.bes.server]这个logger进行属性继承。除了级别之外,还可以为logger定义handler和 useParentHandlers(默认是为true)属性,如 com.bes.server.handler=com.bes.test.ServerFileHandler(需要是一个extends java.util.logging.Handler的类),com.bes.server.useParentHandlers=false(意味着 com.bes.server这个logger进行日志输出时,日志仅仅被处理一次,用自己的handler输出,不会传递到父logger的 handler)。以下是JDK配置文件示例

 

Html代码
  1. handlersjava.util.logging.FileHandler,java.util.logging.ConsoleHandler  
  2.    
  3. .levelINFO  
  4.    
  5. java.util.logging.FileHandler.pattern = %h/java%u.log  
  6. java.util.logging.FileHandler.limit = 50000  
  7. java.util.logging.FileHandler.count = 1  
  8. javajava.util.logging.FileHandler.formatter =java.util.logging.XMLFormatter  
  9.    
  10. java.util.logging.ConsoleHandler.level = INFO  
  11. javajava.util.logging.ConsoleHandler.formatter =java.util.logging.SimpleFormatter  
  12.    
  13. com.xyz.foo.level = SEVERE  
  14. sun.rmi.transport.tcp.logLevel = FINE  

 

***Logging执行原理

@@@Logger的获取

A,首先是调用Logger的如下方法获得一个logger

 

Java代码
  1. public static synchronized Logger getLogger(String name) {  
  2.        LogManager manager =LogManager.getLogManager();  
  3.     returnmanager.demandLogger(name);  
  4. }  

 

 

B,上面的调用会触发java.util.logging.LoggerManager的类初始化工作,LoggerManager有一个静态化初始化块(这是会先于LoggerManager的构造函数调用的~_~):

 

Java代码
  1. static {  
  2.    AccessController.doPrivileged(newPrivilegedAction<Object>() {  
  3.        public Object run() {  
  4.            String cname =null;  
  5.            try {  
  6.                cname =System.getProperty("java.util.logging.manager");  
  7.                if (cname !=null) {  
  8.                   try {  
  9.                        Class clz =ClassLoader.getSystemClassLoader().loadClass(cname);  
  10.                        manager= (LogManager) clz.newInstance();  
  11.                    } catch(ClassNotFoundException ex) {  
  12.                Class clz =Thread.currentThread().getContextClassLoader().loadClass(cname);  
  13.                       manager= (LogManager) clz.newInstance();  
  14.                    }  
  15.                }  
  16.            } catch (Exceptionex) {  
  17.               System.err.println("Could not load Logmanager \"" + cname+ "\"");  
  18.               ex.printStackTrace();  
  19.            }  
  20.            if (manager ==null) {  
  21.                manager = newLogManager();  
  22.            }  
  23.         
  24.            manager.rootLogger= manager.new RootLogger();  
  25.           manager.addLogger(manager.rootLogger);  
  26.    
  27.            Logger.global.setLogManager(manager);  
  28.           manager.addLogger(Logger.global);  
  29.    
  30.            return null;  
  31.        }  
  32.    });  
  33. }  

 

 

从静态初始化块中可以看出LoggerManager是可以使用系统属性java.util.logging.manager指定一个继承自 java.util.logging.LoggerManager的类进行替换的,比如Tomcat启动脚本中就使用该机制以使用自己的 LoggerManager。

不管是JDK默认的java.util.logging.LoggerManager还是自定义的LoggerManager,初始化工作中均会给 LoggerManager添加两个logger,一个是名称为””的root logger,且logger级别设置为默认的INFO;另一个是名称为global的全局logger,级别仍然为INFO。

LogManager”类”初始化完成之后就会读取配置文件(默认为$JAVA_HOME/jre/lib/logging.properties),把配置文件的属性名<->属性值这样的键值对保存在内存中,方便之后初始化logger的时候使用。

C,A步骤中Logger类发起的getLogger操作将会调用java.util.logging.LoggerManager的如下方法:

 

Java代码
  1. Logger demandLogger(String name) {  
  2.   Logger result =getLogger(name);  
  3.   if (result == null) {  
  4.       result = newLogger(name, null);  
  5.       addLogger(result);  
  6.       result =getLogger(name);  
  7.   }  
  8.   return result;  
  9. }  

 

 

可以看出,LoggerManager首先从现有的logger列表中查找,如果找不到的话,会新建一个looger并加入到列表中。当然很重要的 是新建looger之后需要对logger进行初始化,这个初始化详见 java.util.logging.LoggerManager#addLogger()方法中,改方法会根据配置文件设置logger的级别以及给 logger添加handler等操作。

到此为止logger已经获取到了,你同时也需要知道此时你的logger中已经有级别、handler等重要信息,下面将分析输出日志时的逻辑。

@@@日志的输出

首先我们通常会调用Logger类下面的方法,传入日志级别以及日志内容。

 

Java代码
  1. public void log(Levellevel, String msg) {  
  2.       if (level.intValue() < levelValue ||levelValue == offValue) {  
  3.           return;  
  4.       }  
  5.       LogRecord lr = new LogRecord(level, msg);  
  6.       doLog(lr);  
  7. }  

 

 

该方法可以看出,Logger类首先是进行级别的校验,如果级别校验通过,则会新建一个LogRecord对象,LogRecord中除了日志级别,日志内容之外还会包含调用线程信息,日志时刻等;之后调用doLog(LogRecord lr)方法

 

Java代码
  1. private void doLog(LogRecord lr) {  
  2.       lr.setLoggerName(name);  
  3.       String ebname =getEffectiveResourceBundleName();  
  4.       if (ebname != null) {  
  5.           lr.setResourceBundleName(ebname);  
  6.           lr.setResourceBundle(findResourceBundle(ebname));  
  7.       }  
  8.       log(lr);  
  9. }  

 

 

doLog(LogRecord lr)方法中设置了ResourceBundle信息(这个与国际化有关)之后便直接调用log(LogRecord record) 方法

 

Java代码
  1. public void log(LogRecord record) {  
  2.        if (record.getLevel().intValue() <levelValue || levelValue == offValue) {  
  3.            return;  
  4.        }  
  5.        synchronized (this) {  
  6.            if (filter != null &&!filter.isLoggable(record)) {  
  7.                return;  
  8.            }  
  9.        }  
  10.        Logger logger = this;  
  11.        while (logger != null) {  
  12.            Handler targets[] = logger.getHandlers();  
  13.   
  14.            if(targets != null) {  
  15.                for (int i = 0; i < targets.length; i++){  
  16.                         targets[i].publish(record);  
  17.                     }  
  18.            }  
  19.   
  20.            if(!logger.getUseParentHandlers()) {  
  21.                     break;  
  22.            }  
  23.   
  24.            logger= logger.getParent();  
  25.        }  
  26.  }  

 

 

很清晰,while循环是重中之重,首先从logger中获取handler,然后分别调用handler的 publish(LogRecordrecord)方法。while循环证明了前面提到的会一直把日志委托给父logger处理的说法,当然也证明了可以 使用logger的useParentHandlers属性控制日志不进行往上层logger传递的说法。到此为止logger对日志的控制差不多算是完 成,接下来的工作就是看handler的了,这里我们以java.util.logging.ConsoleHandler为例说明日志的输出。

 

Java代码
  1. public class ConsoleHandler extends StreamHandler {  
  2.     public ConsoleHandler() {  
  3.           sealed = false;  
  4.           configure();  
  5.           setOutputStream(System.err);  
  6.           sealed = true;  
  7.     }  

 

 

ConsoleHandler构造函数中除了需要调用自身的configure()方法进行级别、filter、formatter等的设置之外, 最重要的我们最关心的是setOutputStream(System.err)这一句,把系统错误流作为其输出。而ConsoleHandler的 publish(LogRecordrecord)是继承自java.util.logging.StreamHandler的,如下所示:

 

Java代码
  1. public synchronized void publish(LogRecord record) {  
  2.       if(!isLoggable(record)) {  
  3.           return;  
  4.       }  
  5.       String msg;  
  6.       try {  
  7.           msg =getFormatter().format(record);  
  8.       } catch (Exception ex){  
  9.           // We don't want tothrow an exception here, but we  
  10.           // report theexception to any registered ErrorManager.  
  11.           reportError(null,ex, ErrorManager.FORMAT_FAILURE);  
  12.           return;  
  13.       }  
  14.         
  15.       try {  
  16.           if (!doneHeader) {  
  17.              writer.write(getFormatter().getHead(this));  
  18.               doneHeader =true;  
  19.           }  
  20.           writer.write(msg);  
  21.       } catch (Exception ex){  
  22.           // We don't want tothrow an exception here, but we  
  23.           // report theexception to any registered ErrorManager.  
  24.           reportError(null,ex, ErrorManager.WRITE_FAILURE);  
  25.       }  
  26.    }  

 

 

方法逻辑也很清晰,首先是调用Formatter对消息进行格式化,说明一下:格式化其实是进行国际化处理的重要契机。然后直接把消息输出到对应的 输出流中。需要注意的是handler也会用自己的level和LogRecord中的level进行比较,看是否真正输出日志。

总结

至此,整个日志输出过程已经分析完成。细心的读者应该可以解答如下四个问题了。

1,【Main running.】以外的日志为什么没有输出?怎么让它们也能够出现?

这就是JDK默认的logging.properties文件中配置的handler级别和跟级别均为info导致的,如果希望看到FINE级别日志,需要修改logging.properties文件,同时进行如下两个修改

java.util.logging.ConsoleHandler.level= FINE//修改

com.bes.logging.level=FINE//添加

2,日志中出现的时间、类名、方法名等是从哪里输出的?

请参照[java.util.logging.ConsoleHandler.formatter= java.util.logging.SimpleFormatter]配置中指定的 java.util.logging.SimpleFormatter类,其publicsynchronized String format(LogRecord record) 方法说明了一切。

 

Java代码
  1. public synchronized String format(LogRecord record) {  
  2.     StringBuffer sb = new StringBuffer();  
  3.     // Minimize memory allocations here.  
  4.     dat.setTime(record.getMillis());  
  5.     args[0] = dat;  
  6.     StringBuffer text = new StringBuffer();  
  7.     if (formatter == null) {  
  8.         formatter = new MessageFormat(format);  
  9.     }  
  10.     formatter.format(args, text, null);  
  11.     sb.append(text);  
  12.     sb.append(" ");  
  13.     if (record.getSourceClassName() != null) {       
  14.         sb.append(record.getSourceClassName());  
  15.     } else {  
  16.         sb.append(record.getLoggerName());  
  17.     }  
  18.     if (record.getSourceMethodName() != null) {  
  19.         sb.append(" ");  
  20.        sb.append(record.getSourceMethodName());  
  21.     }  
  22.     sb.append(lineSeparator);  
  23.     String message = formatMessage(record);  
  24.    sb.append(record.getLevel().getLocalizedName());  
  25.     sb.append(": ");  
  26.     sb.append(message);  
  27.     sb.append(lineSeparator);  
  28.     if (record.getThrown() != null) {  
  29.         try {  
  30.             StringWriter sw = newStringWriter();  
  31.             PrintWriter pw = newPrintWriter(sw);  
  32.            record.getThrown().printStackTrace(pw);  
  33.             pw.close();  
  34.              sb.append(sw.toString());  
  35.         } catch (Exception ex) {  
  36.         }  
  37.     }  
  38.     return sb.toString();  
  39. }  

 

 

3,为什么日志就会出现在控制台?

看到java.util.logging.ConsoleHandler 类构造方法中的[setOutputStream(System.err)]语句,相信你已经明白。

4,大型的系统可能有很多子模块(可简单理解为有很多包名),如何对这些子模块进行单独的日志级别控制?

在logging.properties文件中分别对各个logger的级别进行定义,且最好使用java.util.logging.config.file属性指定自己的配置文件。

分享到:
评论

相关推荐

    JDK Logger 简介

    除了代码配置,JDK Logger还支持通过`logging.properties`配置文件进行更复杂的设置,如Handler的类型、日志级别、输出格式等。 ### 扩展性 虽然JDK Logger在简单场景下已经足够使用,但在大型项目中,可能需要更...

    jdk环境配置文档

    **JDK环境配置详解** Java Development Kit (JDK) 是Java编程语言的开发环境,它包含了一组工具和API,用于编写、编译、调试和运行Java应用程序。配置JDK环境变量是使用Java开发工具的基础步骤,对于任何Java开发者...

    maven配置全局的jdk和配置局部的jdk

    ### Maven配置全局与局部JDK详解 在Java项目开发过程中,Maven作为一款非常流行的构建工具,被广泛应用于项目的构建、依赖管理和项目信息管理等方面。其中,如何正确配置项目的Java版本(即JDK版本)是确保项目能够...

    JDK--Java环境配置.zip

    Java开发环境是所有Java编程的基础,它包括Java Development Kit (JDK)的安装与配置。JDK是Oracle公司提供的用于开发和运行Java程序的工具集合,包含Java编译器、Java虚拟机(JVM)、Java类库以及一些开发工具如...

    jdk的配置及其参数的设置

    3. 配置环境变量:包括设置`JAVA_HOME`指向JDK的安装目录,将`bin`子目录添加到`PATH`环境变量中,以便在任何地方都能执行JDK的命令。 【JDK环境变量】 环境变量是操作系统用来定位和管理程序所需资源的关键设置。...

    java JDK 实例开发宝典

    JDK是Java编程的基础,包含了编译器、运行环境、调试工具和其他实用工具,对于任何想要学习或精通Java编程的开发者来说,都是不可或缺的一部分。这本书的目标显然是帮助读者掌握JDK的各种功能和用法,通过实例来提升...

    java配置jdk配置tomcat配置

    java配置jdk配置tomcat配置 所有关于java的配置 path classpath配置都在

    linux环境下tomcat和jdk的配置

    在Linux环境下配置Tomcat和JDK是部署Java应用的基础步骤,这一过程涉及到JDK的安装、环境变量的设定以及Tomcat服务器的配置。下面将详细阐述这些知识点。 ### JDK安装与环境配置 #### 安装JDK 在Linux环境下安装...

    jdk环境变量配置

    jdk环境变量配置,下载前请仔细阅读资源描述,否则后果自负,最终解释权归作者所有

    jdk 一键配置环境工具

    首先在Oracle的网站上下载对应的JDK版本,然后安装。注意在Windows下,为了避免在使用命令行的时候出现问题,一般不要选择安装在C:\Program Files\jdk目录下,可以选择文件夹名没有空格的目录来安装,比如我一般安装...

    linux下jdk安装配置

    Linux 下 JDK 安装配置 Linux 系统上安装 JDK 是 Java 开发人员的基本技能之一,本文将指导学习人员初步学会在 Linux 系统上安装 JDK,并进行环境变量的配置,避免安装时犯下一些常见的错误。 一、Java 运行硬件...

    JDK环境配置.txt

    Solaris JDK配置,加固升级时候留的笔记,小白适用加固参考

    JDK 安装及配置心得

    本文将详细介绍如何在Windows环境下完成JDK的安装与配置,并分享一些实用的经验技巧,帮助读者避免常见的错误与陷阱。 #### 二、JDK安装步骤 1. **选择安装路径:** - 选择一个非默认的安装位置,例如`C:\jdk_...

    YUM安装jdk并配置环境变量.md

    在Linux环境里安装jdk环境并配置变量

    jdk环境配置jdk环境配置.txt

    ### JDK环境配置详解 在深入探讨JDK环境配置之前,我们先来理解一下JDK(Java Development Kit)是什么。JDK是Java开发工具包,包含了Java运行环境(JRE)、Java虚拟机(JVM)、Java编译器以及一系列用于开发Java...

    jdk配置.rar

    在本压缩包"jdk配置.rar"中,我们重点讨论的是如何配置JDK,这对于任何Java开发者来说都是至关重要的基础步骤。 首先,我们需要了解JDK的安装过程。在Windows系统中,通常下载JDK的安装文件,双击运行后按照向导...

    Java JDK 实例开发宝典

    在书中,你将学习到如何安装和配置JDK环境,这是开始Java编程的第一步。接着,通过一系列精心设计的实例,你可以了解到Java语法基础,包括数据类型、控制流、类和对象、接口、包的使用等。这些实例将帮助你构建起...

    JDK配置程序,一键配置安装JDK

    本教程将详细讲解如何使用“JDK配置程序”进行一键配置安装JDK。 1. JDK的重要性: - JDK是开发Java应用程序的基础,提供了编译、调试和运行Java代码所需的全部工具。 - 它包含JRE(Java Runtime Environment),...

    jdk配置java的必须配置

    标题“jdk配置java的必须配置”及描述“jdk配置,java的必须配置java的必须配置java的必须配置”强调了JDK(Java Development Kit)配置在Java开发环境搭建中的重要性。JDK是开发Java应用程序的基础工具包,包含了...

    JDK 1.6环境配置方法

    ### JDK 1.6环境配置方法详解 #### 一、引言 JDK(Java Development Kit)是开发Java应用程序的基础工具包,包含了编译、运行Java程序所需的组件。本文将详细介绍如何在Windows环境下配置JDK 1.6,并确保其正常...

Global site tag (gtag.js) - Google Analytics