java.util.logging.Logger 使用详解

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

 

三、简单实例

 

public  class TestLogger { 
         public  static  void main(String[] args) { 
                Logger log = Logger.getLogger( "lavasoft" ); 
                log.setLevel(Level.INFO); 
                Logger log1 = Logger.getLogger( "lavasoft" ); 
                System.out.println(log==log1);      //true 
                Logger log2 = Logger.getLogger( "lavasoft.blog" ); 
                log2.setLevel(Level.WARNING); 

                log.info( "aaa" ); 
                log2.info( "bbb" ); 
                log2.fine( "fine" ); 
        } 
}

 

true 
2009-7-28 20:00:30 TestLogger main 
信 息: aaa 

Process finished with exit code 0

 

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

true 
2009-7-28 20:02:02 TestLogger main 
信 息: aaa 
2009-7-28 20:02:02 TestLogger main 
信息: bbb 

Process finished with exit code 0

 

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

java.util.logging.Handler 
  java.util.logging.MemoryHandler 
  java.util.logging.StreamHandler 
    java.util.logging.ConsoleHandler 
    java.util.logging.FileHandler 
    java.util.logging.SocketHandler

 

例子：

public  class TestLogger { 
         public  static  void main(String[] args)  throws IOException { 
                Logger log = Logger.getLogger( "lavasoft" ); 
                log.setLevel(Level.INFO); 
                Logger log1 = Logger.getLogger( "lavasoft" ); 
                System.out.println(log==log1);      //true 
                Logger log2 = Logger.getLogger( "lavasoft.blog" ); 
//                log2.setLevel(Level.WARNING); 

                ConsoleHandler consoleHandler = new ConsoleHandler(); 
                consoleHandler.setLevel(Level.ALL); 
                log.addHandler(consoleHandler); 
                FileHandler fileHandler =  new FileHandler( "C:/testlog%g.log" ); 
                fileHandler.setLevel(Level.INFO); 
                log.addHandler(fileHandler); 
                log.info( "aaa" ); 
                log2.info( "bbb" ); 
                log2.fine( "fine" ); 
        } 
}

 

输出结果：

true 
2009-7-28 20:36:14 TestLogger main 
信 息: aaa 
2009-7-28 20:36:14 TestLogger main 
信息: aaa 
2009-7-28 20:36:14 TestLogger main 
信息: bbb 
2009-7-28 20:36:14 TestLogger main 
信息: bbb 

Process finished with exit code 0

 

查看C盘：

 

可见，默认的日志方式是xml格式，很烂。所以最好自定义下logger的格式。需要用Formatter来定义。

 

五、Logger的Formatter

 

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

 

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

 

java.util.logging.Formatter 
  java.util.logging.SimpleFormatter 
  java.util.logging.XMLFormatter

 

看个例子就明白了：

public  class TestLogger { 
         public  static  void main(String[] args)  throws IOException { 
                Logger log = Logger.getLogger( "lavasoft" ); 
                log.setLevel(Level.INFO); 
                Logger log1 = Logger.getLogger( "lavasoft" ); 
                System.out.println(log == log1);      //true 
                Logger log2 = Logger.getLogger( "lavasoft.blog" ); 
//                log2.setLevel(Level.WARNING); 

                ConsoleHandler consoleHandler =  new ConsoleHandler(); 
                consoleHandler.setLevel(Level.ALL); 
                log.addHandler(consoleHandler); 
                FileHandler fileHandler =  new FileHandler( "C:/testlog%g.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" ; 
        } 
}

 

输出：

在控制和C盘输出的文件如图

 

到此，Java自带的Logger内容就没了。

感觉格式很不爽。自定义的XML格式很烂。

$

   java Logger 的使用 收藏

Logger所对应的属性文件在安装jdk目录下的jre/lib/logging.properties
logging.properties 文件中的
handlers= java.util.logging.ConsoleHandler  将日志内容输出到控制台
handlers= java.util.logging.FileHandler     将日志文件输出到文件中
handlers= java.util.logging.ConsoleHandler,java.util.logging.FileHandler 将日志内容同时输出到控制台和文件中

# Limit the message that are printed on the console to INFO and above.
java.util.logging.ConsoleHandler.level = INFO   //日志输出级别

java.util.logging.FileHandler.pattern = %h/java%u.log  为生成的输出文件名称指定一个模式。
模式由包括以下特殊组件的字符串组成，则运行时要替换这些组件：

• "/" 本地路径名分隔符
• "%t" 系统临时目录
• "%h" "user.home" 系统属性的值
• "%g" 区分循环日志的生成号
• "%u" 解决冲突的惟一号码
• "%%" 转换为单个百分数符号"%" 

如果未指定 "%g" 字段，并且文件计数大于 1，那么生成号将被添加到所生成文件名末尾的小数点后面。 

java.util.logging.FileHandler.limit = 50000   限制文件的大小，以字节为单位
java.util.logging.FileHandler.count = 1       指定有多少输出文件参与循环（默认为 1）。
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter      指定要使用的 Formatter 类的名称（默认为 java.util.logging.XMLFormatter ）。 另外一个是：java.util.logging. SimpleFormatter 。 XMLFormatter是以xml样式输出，SimpleFormatter是以普通样式输出。
java.util.logging.FileHandler.append 指定是否应该将 FileHandler 追加到任何现有文件上（默认为 false）。

首先找到logging.properties文件,位于jre/lib下
打开文件,内容如下:
############################################################
# 

    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
############################################################

############################################################
#      Global properties
############################################################

# "handlers" specifies a comma separated list of log Handler
# classes.  These handlers will be installed during VM startup.
# Note that these classes must be on the system classpath.
# By default we only configure a ConsoleHandler, which will only
# show messages at the INFO and above levels.
#handlers= java.util.logging.ConsoleHandler

# To also add the FileHandler, use the following line instead.
handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler 
//设置日志处理方式,为写到文件和打印在控制台

# 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

############################################################
# Handler specific properties.
# Describes specific configuration info for Handlers.
############################################################

# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = %h/%s.log //文件名字和路径,默认为用户的根目录
java.util.logging.FileHandler.append=true //不重新创建文件,在原文件里追加 
java.util.logging.FileHandler.limit = 50000 //文件最大数 
java.util.logging.FileHandler.count = 1 
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter //简单格式输出

# Limit the message that are printed on the console to INFO and above.
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter


############################################################
# Facility specific properties.
# Provides extra control for each logger.
############################################################

# For example, set the com.xyz.foo logger to only log SEVERE
# messages:
com.xyz.foo.level = SEVERE