首页 > 代码库 > Java程序日志:java.util.logging.Logger类

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());//设置自定义日志记录格式(默认是XML格式),该类在后文会提到。    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()方法也能进行文件的写出,这里不再赘述。

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

六、Logger 的 Formatter

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

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

注意:
是 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 这个类

输出结果:
技术分享

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