你的位置:首页 > Java教程

[Java教程]Java程序日志:java.util.logging.Logger类


一、Logger 的级别

比log4j的级别详细,全部定义在java.util.logging.Level里面。
各级别按降序排列如下:
SEVERE(最高值)
WARNING
INFO
CONFIG
FINE
FINER
FINEST(最低值)
此外,还有一个级别 OFF,可用来关闭日志记录,使用级别 ALL 启用所有消息的日志记录。
logger默认的级别是INFO,比INFO更低的日志将不显示(但也会写入文件)。

注意:
高等级的Logger不会显示(或写入)低等级的记录。
低等级的Logger会显示(或写入)高等级的记录。


二、创建 Logger 对象

static Logger getLogger(String name)
为指定子系统查找或创建一个 logger。
static Logger getLogger(String name, String resourceBundleName)
为指定子系统查找或创建一个 logger。

注意:name是Logger的名称,一般使用圆点分隔的层次命名空间来命名 Logger 。
当名称相同时候,同一个名称的Logger只创建一个(不同引用指向同一logger,这意味着不同引用可以操作同一Logger)。


三、简单实例 --- 控制台打印 Logger

public class TestLogger {   public static void main(String[] args) {   //创建SEVERE级别的Logger  Logger severeLogger = Logger.getLogger("logger.severe"); //名为logger.severe  severeLogger.setLevel(Level.SEVERE);//设置logger等级  //创建WARNING级别的Logger  Logger warninglogger = Logger.getLogger("logger.warning");   warninglogger.setLevel(Level.WARNING);  //创建INFO级别的Logger  Logger infoLogger = Logger.getLogger("logger.info");  infoLogger.setLevel(Level.INFO);  //创建CONFIG级别的Logger  Logger configLogger = Logger.getLogger("logger.config");//比INFO等级更低的日志将不显示  configLogger.setLevel(Level.CONFIG);/*------------------------------------记录测试----------------------------------*/  infoLogger.info("这是infoLogger的记录");//记录一条INFO级别的消息  infoLogger.warning("低级能显示高级信息?");//由结果可知低级别的logger能 显示/记录 高级别的信息  warninglogger.warning("这是warninglogger的记录");  warninglogger.severe("低级能显示高级信息?");  warninglogger.info("高级能显示低级信息?");//由结果可知高级别的logger不能 显示/记录 低级别的信息  severeLogger.severe("这是severeLogger的记录");  severeLogger.warning("高级能显示低级信息?");  configLogger.config("这是configLogger的记录");//INFO等级以下的Logger不会显示 同等级/更低级 的消息  Logger testLogger1 = Logger.getLogger("logger.info");//当名称相同时候,同一个名称的Logger只创建一个  System.out.println("同名的logger是否相等:" + (infoLogger == testLogger1));  testLogger1.setLevel(Level.SEVERE);//设置成高等级  infoLogger.info("这是infoLogger的记录");  infoLogger.setLevel(Level.INFO);//再设置成低等级  infoLogger.info("这是infoLogger的记录");  }}

 

输出结果:

四、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

 

五、简单实例 --- 写出 Logger 文件

public class TestLogger {   public static void main(String[] args) throws IOException {  //创建SEVERE级别的Logger  Logger severeLogger = Logger.getLogger("logger.severe"); //名为logger.severe  severeLogger.setLevel(Level.SEVERE);//设置logger等级  //创建WARNING级别的Logger  Logger warninglogger = Logger.getLogger("logger.warning");   warninglogger.setLevel(Level.WARNING);  //创建INFO级别的Logger  Logger infoLogger = Logger.getLogger("logger.info");  infoLogger.setLevel(Level.INFO);  //创建CONFIG级别的Logger  Logger configLogger = Logger.getLogger("logger.config");//比INFO等级更低的日志将不显示  configLogger.setLevel(Level.CONFIG);  File logDir = new File("f:/logTest", "logDir");//创建文件对象参数:父目录,子目录  logDir.mkdirs();//创建多级目录  File logFile = new File(logDir.getAbsolutePath(),"logTest.log");//创建文件对象  FileHandler fileHandler = new FileHandler(logFile.getAbsolutePath(), 10240, 1, true);//写出日志文件,参数:路径,最大字节数,要使用的文件数,是否追加文件。(达到最大字节数后,会删掉原来所有记录,重新开始记录)  fileHandler.setLevel(Level.ALL);//同样地,高等级的FileHandler不会记录低等级的消息,ALL等级的FileHandler会记录所有等级的消息  //fileHandler.setFormatter(new MyLogFormatter());//设置自定义日志记录格式(默认是  infoLogger.addHandler(fileHandler);//添加Handler对象  infoLogger.info("infoLogger的info记录");//将记录写入日志文件  infoLogger.config("infoLogger的config记录");//低于logger等级的记录不会被写入日志文件  configLogger.addHandler(fileHandler);  configLogger.info("configLogger的info记录");  configLogger.config("configLogger的config记录");//如果FileHandler的等级为ALL或低于INFO,config等级的Logger也会被写入日志文件,只是不会在控制台打印出来  }}

 

输出结果:(在F盘中可以找到写出的日志文件)


同样地, Logger log()方法也能进行文件的写出,这里不再赘述。

打开文件会发现,默认的日志方式是我们也可以自定义logger的格式。
需要用Formatter来定义。

六、Logger 的 Formatter

Formatter 为格式化 LogRecords 提供支持。
一般来说,每个日志记录 Handler 都有关联的 Formatter。
Formatter 接受 LogRecord,并将它转换为一个字符串。
LogRecord 对象用于在日志框架和单个日志 Handler 之间传递日志请求。

几种 Formatter :
java.util.logging.Formatter
java.util.logging.SimpleFormatter
java.util.logging.

注意:
是 java.util.logging.Formatter ,要与 java.util.Formatter 区分开


七、简单实例 --- 自定义 Formatter

/**用于自定义格式化的类*/class MyLogFormatter extends Formatter {  @Override  public String format(LogRecord record) {  return record.getSourceClassName() + ": " + record.getSourceMethodName() + ": " + record.getLevel() + ": " + record.getMessage() + "\n";   } }

 

关于其他的格式化设置,可以参考API中 java.util.Formatter 这个类

输出结果: