首页 > 代码库 > 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类