JDK1.4的java.util.Logging包的使用说明与示例

原创 2004年07月12日 20:41:00

Sun公司推出的JDK1.4版本在java.util.Logging软件包中新增加了处理应用程序日志工作的核心API函数。这个Java日志软件包提供了一种为Java应用程序嵌入多级日志的简单而又灵活的方法。

简要介绍

java.util.Logging包括1个接口: Filter;15个类: Logger, LogManager, ErrorManager, Level, LogRecord, LoggingPermission, Handler, MemoryHandler, StreamHandler, ConsoleHandler, FileHandler, SocketHandler, Formatter, SimpleFormatter, XMLFormatter,下面是这些类的简单关系是

 

处理器的继承关系

 

Handler

MemoryHandler

ConsoleHandler

StreamHandler

FileHandler

SocketHandler

 

 

 

 

 

 

 

 

 

 

 

 


格式化器的继承关系

 

 

Formatter

 

 

 

 

 

 

 


SimpleFormatter

XMLFormatter

      

 

 

 

 

/接口功能概要

1.      Filter(过滤器):控制日志记录的输出粒度, 粒度范围超过了Level类提供的功能,在每个handlersetFilter方法中设置该类型

2.      Logger(日志记录器): 为了利用日志软件包,Logger对象并调用Logger中多个记录方法中的某一个,例如info(String message)。日志记录器Logger创建一个LogRecord(包含应用程序具体的日志信息)对象并把它传递到一个或者多个HandlerHandler对象再把它输出到目标,这样就实现了日志记录的输出。在日志的输出过程中,LoggerHandler对象可以根据日志等级和过滤器(Filter)来判断那些日志需要记录下来。同时,HandlerFormatter协同工作,Formatter对日志信息进行格式化,决定日志记录如何输出到日志

3.      LogManager(日志管理器):管理一个日志记录器对象的名称空间,所有已命名的日志记录器都被保存在这个名称空间中;管理一套日志记录的控制属性,这些是简单的值对像,可以被Handlerlogging对象使用来进行自我配置;

4.      ErrorManager(错误管理器): ErrorManager对象依附在Handler对象上,用来处理在记录日志期间发生在Handler对象上的任何错误.但在处理输出日志时,假如Handler对象遇到问题时, Handler并没有抛出异常给日志记录的调用者,而是用依附在Handler上的ErrorManager来处理。

5.      Level(等级): Java 日志软件包对每一个日志消息都赋以一个等级,以控制日志记录的输出。等级是一个整型数据,记录的等级越高,那么这个整型数据也就越大。下面的等级是在Level类中定义的(按照从低到高的顺序排列):

级别

重要性

日志记录器相应的日志方法

级别数值

SEVERE

非常重要

severe(String message);

1000

WARNING

针对警告

warning(String message);

900

INFO

信息化的运行时间消息

info(String message);

800

CONFIG

静态设置的消息

config(String message);

700

FINE

提供追踪信息

fine(String message);

500

FINER

显示详细的追踪信息

finer(String message);

400

FINEST

更详细的追踪信息

finest(String message);

300

ALL

显示所有应该日志记录的信息

没有可应用的

Integer.MIN_VALUE

OFF

关闭日志

没有可应用的

Integer.MAX_VALUE

 

6.      LogRecord(记录信息): LogRecord对象用来在日志框架和单个日志记录Handler之间传递日志记录请求,当一个LogRecord被传递进框架时, 在逻辑上它是属于框架的,不应该被客户应用程序使用或更新

注意:假如客户应用程序没有指定一个显式的来源方法名称和来源类名称, 当他们(方法或类)第一次被访问时(由于对getSourceMethodName或者getSourceClassName方法的调用),LogRecord类将通过分析调用堆栈,自动推断他们.因此,假如一个日志处理器想停止传递一个LogRecord给另一个线程,或者通过RMI传播,并且假如它后来想得到方法和类名,它应该调用getSourceClassNamegetSourceMethodName来确保有值被填入.

7.      LoggingPermission(记录许可):当代码和一个调用日志记录控制方法的安全管理器(SecurityManager)一起运行的时候,安全管理器(SecurityManager)将检测这个许可.当前仅仅有一个LoggingPermission.这值控制,并且它有控制日志记录配置的能力,例如添加或删除Handler,添加或删除过滤器,或者改变日志等级.程序员不必直接创建LoggingPermission对象.而是由读取的安全策略文件(security policy file)来创建

8.      Handler(处理器): Handler对象从Logger那里获得日志信息并且将它输出。可能会输出到控制台,或者输出到文件,或者把这些日志信息发送到网络中的日志服务,或者把它们转发给操作系统日志,或者其他什么。。JDK1.4日志API提供了两大类Handler对象。MemoryHandler简单的把日志消息保存在循环内存缓冲(circular memory buffer),当特定的触发事件发生时,再把它们发布到目标handler。典型的触发事件是接收到等级符合发布等级的日志消息。如果需要其它发布标准,MemoryHandler类可以扩展,重写日志方法来按照用户定义的日志记录条件来发布内存缓冲。StreamHandler向指定的输出流发布日志记录。Java日志API指定了三种StreamHandler对象。ConsoleHandler向标准错误流发布日志记录。FileHandler向指定的文件发布日志记录,它也可以配置成向循环文件集写入日志记录。SocketHandler向网络流发布日志记录(与其它应用通信)。可以通过调用setLevel(Level.OFF)使处理器无效,也可以通过调用setLevel方法的一个适当的等级使其有效.处理器类用LogManager属性来设置处理器的过滤器,格式化和等级的默认值.

9.      MemoryHandler(存储处理器):把请求缓冲在内存的循环缓冲区内,通常这个处理器简单地把引入的LogRecord存贮在缓冲区,并丢弃以前的记录.这个缓冲很便宜并且避免了格式化.在某些特殊情况下, MemoryHandler将把当前缓冲区中内容挤出到目标缓冲区. 主要有三种引发挤压缓冲区的模型:

n        引入的LogRecord有一个大于以前定义等级的类型,也就是挤压等级

n        一个外部类显示地调用挤压方法

n        一个子类重载log方法,并且扫描每个引入的LogRecord,假如它匹配需求标准,将调用挤压方法

10.  StreamHandler(流处理器):流基于日志记录处理器(logging Handler),这主要是作为一个基类或支持类来实现其他日志记录处理器. LogRecord被发送到一个给定的java.io.OutputStream.

11.  ConsoleHandler(控制台处理器):这个处理器向标准错误流(System.err)发送日志记录,默认SimpleFormatter被用来产生简短的概要

12.  FileHandler(文件处理器):简单文件日志处理器.FileHandler可以写到一个指定的文件,或者一套循环文件.对一套循环文件,当每个文件达到一个指定大小的时候,它将被关闭,循环出去,一个新的文件被打开.老的文件将按顺序加上"0", "1", "2". 默认用XMLFormatter来格式化

13.  SocketHandler(网络处理器):发布LogRecord到一个网络流连接.默认用XMLFormatter来格式化

14.  Formatter(格式化器):格式化器提供格式化LogRecord支持.每个日志处理器器都有一个格式化器格.式化器获得一个LogRecord,并把它转化为字符串.有一些格式化器(例如XMLFormatter)需要包装头和尾字符串围绕一套格式化记录. GetHeadergetTail方法可以用来获得这些字符串.

15.  SimpleFormatter(简单格式化器): Print a brief summary of the LogRecord in a human readable format. The summary will typically be 1 or 2 lines用一种可以阅读的格式来打印LogRecord的简单概要.典型的概要是1或者2.

16.  XMLFormatter(XML格式化器):LogRecord格式化尾标准的XML格式.DTD规范在Java Logging APIs规范的附录A中提供

示例剖析

1.      简单示例

这个示例说明logging的常用操作

public class JDK14LoggingTest {

 

  /**

   日志记录器

  */

  Logger log = Logger.getLogger(getClass().getName());

 

  /**

   * 日志输出对象

   */

  Handler fileHandler = null;

 

  /**

   * 构造方法

   */

  public JDK14LoggingTest() {

    //设置输出到文件

    try {

      fileHandler = new FileHandler("%h/java%u.log");

//      fileHandler = new FileHandler("%h/java%u.log",10,5,true);

//      设置记录级别

     fileHandler.setLevel(Level.WARNING);

//      设置过滤器,已达到更细粒度的记录

//      fileHandler.setFilter();

 

//      设置输出格式,有两种类型:SimpleFormatterXMLFormatter,

//      默认是XMLFormatter,当然自己也可以扩张,只要继承Formatter类就可以了

     fileHandler.setFormatter(new SimpleFormatter());

//    指定日志编码格式

//      fileHandler.setEncoding("");

//    设置错误处理

//      fileHandler.setErrorManager(new ErrorManager());

    }

    catch (Exception ex) {

      ex.printStackTrace();

    }

    log.addHandler(fileHandler);

  }

 

  public void testLog(){

    log.info(getClass().getName());

    log.log(Level.WARNING,getClass().getName(),"testLog");

  }

 

  public static void main(String[] args) {

    JDK14LoggingTest test = new JDK14LoggingTest();

    test.testLog();

  }

}

2.      数据库Handler示例

从上面的描述可以看出,jdk1.4logging没有提供输出到数据库的Handler,下面将介绍一个怎样把日志输出到数据库, 我们知道Handler对象负责从Logger那里获取日志信息然后把它输出到目的地。而用户希望把日志存储到数据库中,其实这只是把日志信息的输出目标替换为数据库而已。所以编写扩展HandlerJDBCHandler类,由它来实现把日志信息写入到数据库中。要想扩展Handler类,必须实现Handler定义的三个抽象函数(abstract):

public abstract void flush() ;

public abstract void publish(LogRecord record) ;

public abstract void close() throws java.lang.SecurityException;

其中,publish(LogRecord record)方法最为重要,它最终实现把日志信息输出到目标。close()方法负责释放所有handler所拥有的资源。这次我们只在publish(LogRecord record)方法中实现把日志信息(封装在LogRecord对象中)通过合适的JDBC驱动程序插入到数据库中就可以了, 下面我就以向MySql数据库输出日志记录为例,完整源代码的实现如下:

package com.benqguru.commons.logging.test;

 

import java.util.logging.*;

import java.sql.*;

 

class JDBCHandler

    extends Handler {

  public void flush() {

  }

 

  public void publish(LogRecord record) {

    Connection conn = null;

 

    PreparedStatement pstmt = null;

 

    try {

      Class.forName("org.gjt.mm.mysql.Driver");

      conn = DriverManager.getConnection("mysql://10.89.58.228:3306/logtest","root","");

      if (conn != null) {

        Object[] content = record.getParameters();

        String sql = "insert into MyLog(logTime,EventType) values(?,?)";

        pstmt = conn.prepareStatement(sql);

        pstmt.setLong(1, record.getMillis());

        pstmt.setString(2, (String) content[0]);

        //save loginfo in databse

        pstmt.execute();

      }

    }

    catch (Exception e) {

      e.printStackTrace();

    }

    finally {

      if (conn != null) {

        try {

          conn.close();

        }

        catch (Exception ex) {

          ex.printStackTrace();

        }

      }

      if (pstmt != null) {

        try {

          pstmt.close();

        }

        catch (Exception ex) {

          ex.printStackTrace();

        }

      }

    }

  }

 

  public void close() throws java.lang.SecurityException {

 

  }

 

  //测试方法

  public static void main(String[] args) {

    Logger log = Logger.getLogger("com.benqguru.commons.logging.test.JDBCHandler");

    JDBCHandler jdbc = new JDBCHandler();

    log.addHandler(jdbc);

    String[] content = {"insert"};

    LogRecord lr = new LogRecord(Level.INFO, "second test message");

    lr.setParameters(content);

    // first insert log

    log.log(Level.INFO, "first test message", content);

    //second insert log

    log.log(lr);

  }

}

从以上代码可以看出,写入日志的程序没有太大的变化。唯一需要指出的就是,日志记录器Logger是利用刚才编写的JDBCHandler对象来输出日志。通过Logger对象的addHandler(Handler handler)方法指定JDBCHandler对象。

参考

Sun公司的JDK1.4版本java.util.日志Logging软件包的源程序。

java.util.logging源码解析

目录 概要 工作原理和日志处理流程 代码解读 LogManager的初始化 Logger的构造 Logger记录日志 Handler日志处理 StreamHandler IO流方式...
  • liuganggao
  • liuganggao
  • 2012年12月16日 17:20
  • 2484

java.util.logging自定义打印日志

知识准备(如有不全,请查看jdk的api): 1、 Logger 属性  Filter 获取或设置过滤器以控制此 Logger 的输出。  Level 获取或设置为此 Logger...
  • wanghaiping1993
  • wanghaiping1993
  • 2015年10月09日 23:55
  • 752

JDK1.4的java.util.Logging包的使用说明与示例

Sun公司推出的JDK1.4版本在java.util.Logging软件包中新增加了处理应用程序日志工作的核心API函数。这个Java日志软件包提供了一种为Java应用程序嵌入多级日志的简单而又灵活的...
  • friday5pm
  • friday5pm
  • 2007年06月07日 11:11
  • 1317

正确使用java.util.logging包

 java.util.logging包提供了强大的日志输出功能,正确和有效的使用这些功能需要一些技巧: 了解不同的Level, Level.FINE, LEVEL.FINER,LEVEL.FIN...
  • zfqjava
  • zfqjava
  • 2007年05月06日 12:14
  • 1495

JDK.1.4新特性及增强内容概要

Java 2 SDK 1.4标准版的新特性如下所列。 包含以前SDK版本的特性的完整列表可以从 特性指南得到。 Java 2 平台 XML处理 新I/O API 安全 Java 2DTM技术 图形I/...
  • snakeqi
  • snakeqi
  • 2004年07月25日 22:34
  • 2083

JDK1.4安装与环境配置完全图解(windows)

function StorePage(){ d=document; t=d.selection?(d.selection.type!=None?d.selection.createRange().te...
  • johnsonTj
  • johnsonTj
  • 2005年03月11日 20:43
  • 3044

深探java.util.logging包

1.0 Java Logging Overview    1.1 Overview of Control Flow      1.2 Log Levels     1.3 Loggers     1....
  • gdy1039
  • gdy1039
  • 2005年03月13日 13:46
  • 2114

WebService怎么理解和JDK1.4下使用WebService

由于项目需要,必须使用WebService进行接口数据交换。于是百度了很多有关的信息,挑选了一些解释的非常好的解释:         WebService是一种跨编程语言和跨操作系统平台的远程调用技术...
  • a445849497
  • a445849497
  • 2016年07月19日 14:21
  • 2633

JDK1.4环境下使用Eclipse3.4的方法

 在快捷方式中以以下目标启动C:/eclipse3.4/eclipse.exe -vm "C:/Program Files/Java/jre1.5.0_10/bin/client/jvm.dll" 前...
  • bedweather
  • bedweather
  • 2008年08月26日 15:30
  • 981

Jdk1.4下线程池

 Jdk1.4下线程池       JSR 166 (java.util.concurrent)是jdk1.5的部分,它给我们的多线程开发带来很多方便。因为很多应用环境还是在jdk1.4下,目前还无法...
  • nearsun
  • nearsun
  • 2008年02月02日 11:23
  • 2075
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:JDK1.4的java.util.Logging包的使用说明与示例
举报原因:
原因补充:

(最多只允许输入30个字)