Handler对象在创建时使用LogManager对象的相关属性的默认值(如Handler的Filter、Formatter、Level等对象属性)进行初始化。
Handler对象可通过调用setLevel(Level.OFF)暂停工作;通过调用setLevel设置适当的记录日志消息级别恢复工作。
Handler是一个抽象类。在J2SDK1.4中,其子类及它们之间的关系见图一。
1、 MemoryHandler Handler的子类,在内存中的一个循环缓冲区用于缓存日志记录请求。通常MemoryHandler只简单的把传入的LogRecords存储到它的内存中。这种缓存的开销非常低廉,它去掉了格式化所产生的系统消耗。当某个触发条件满足时,MemoryHandler将其缓冲的数据push(发布)到目标Handler,由后者执行实际的输出。有三种模式触发MemoryHandler进行push操作:a、传入的LogRecords的级别高于MemoryHandler预先定义的push级别;b、有其他对象显式的调用其push方法;c、其子类重载了log方法,逐一检索每个传入的LogRecords,若符合特定的标准则进行push操作。
实例:假设我们需要跟踪一个生产环境中的一个很少出现的Bug。在大多数场合,系统化产生大量的日志记录,而我们仅只关心记录中最近的几条,那么我们只需要使用MemoryHandler对日志记录进行缓存,当且仅当某个事件发生时将最近的几条记录从内存中 dump到制定的文件中。
//MemoryHandlerTest.java
import java.util.logging.*;
import java.io.*;
public class MemoryHandlerTest {
FileHandler fhandler;
Logger logger;
MemoryHandler mhandler;
MemoryHandlerTest() {
try {
//构造名为my.log的日志记录文件
fhandler = new FileHandler("my.log");
int numRec = 5;
//构造一个5个日志记录的MemoryHandler,
//其目标Handler为一个FileHandler
mhandler = new MemoryHandler (fhandler, numRec, Level.OFF) ;
//构造一个记录器
logger = Logger.getLogger("com.mycompany");
//为记录器添加一个MemoryHandler
logger.addHandler(mhandler);
} catch (IOException e) {
}
}
public static void main(String args[]) {
MemoryHandlerTest mt = new MemoryHandlerTest();
int trigger = (int)(Math.random()*100);
for (int i=1;i<100;i++) {
//在MemoryHandler中缓存日志记录
mt.logger.log(Level.INFO,"日志记录"+i);
if (i==trigger) {
//触发事件成立,显式调用MemoryHandler的
//push方法触发目标Handler输出日志记录到
//my.log文件中
mt.mhandler.push();
break;
}
}
}
}
实例2
2、 FileHandler 文件处理器。
StreamHandler流处理器将日志记录以流的形式输出。FileHandler、ConsoleHandler、SocketHandler为StreamHandler的子类。 ConsoleHandler将日志记录输出到控制终端。前面的实例(实例2除外)都将日记记录数据输出到控制台。
FileHandler将日志记录输出到特定的文件,或循环的几个日志文件中。日志文件可以设置容量大小。当日志文件达到限定的容量时将被自动清空,重头开始写入新的日志记录数据。
例:创建一个容量为1Mb的文件处理器
int limit = 1000000; // 1 Mb
FileHandler fh = new FileHandler("my.log", limit, 1);
对于循环的日志文件,每个文件将被指定容量限制。当当前的日志文件的长度达到制定值后该文件被关闭,新的日志文件被创建,旧的文件将在文件名模板后追加序号。如此产生多个顺序编号的日志记录文件。
例:
try {
// 创建一个拥有3个日志文件,每个容量为1Mb的文件处理器
String pattern = "my%g.log";
int limit = 1000000; // 1 Mb
int numLogFiles = 3;
FileHandler fh = new FileHandler(pattern, limit, numLogFiles);
…
} catch (IOException e) {
}
(四)、Level
Level对象定义了一组日志消息的级别,用于控制日志消息的输出。一个级别对应一个整型值。日志消息级别按照其整数值的大小排定优先级。在Logger对象中设定一个级别,则大于等于该级别的日志消息将会被传递到某个Handler对象进行输出处理。
J2SDK1.4的Java Logging框架中定义了以下消息级别:
级别名称 | int值(Windows 2000环境) |
OFF | 2147483647 |
SEVERE | 1000 |
WARNING | 900 |
INFO | 800 |
CONFIG | 700 |
FINE | 500 |
FINER | 400 |
FINEST | 300 |
ALL | -2147483648 |
表一
Level.OFF具有最高的级别。将Logger的Level级别设置成Level.OFF
让我们看看消息级别是怎样工作的:LoggingLevelTest.java
import java.util.logging.*;
public class LoggingLevelTest {
public static void main(String args[]) {
//使用Logger的静态方法获得一个匿名Logger
Logger logger1 = Logger.getAnonymousLogger();
//设置Logger对象记录的最低日志消息级别
logger1.setLevel(Level.FINER);
//记录消息
logger1.severe("SEVERE级消息");
logger1.warning("WARNING级消息");
logger1.config("CONFIG级消息");
logger1.info("INFO级消息");
logger1.fine("FINE级消息");
logger1.finer("FINER级消息");
logger1.finest("FINEST级消息");
}
}
实例3
运行结果:
2003-1-15 7:02:03 LoggingLevelTest main
服务器: SEVERE级消息
2003-1-15 7:02:04 LoggingLevelTest main
警告: WARNING级消息
2003-1-15 7:02:04 LoggingLevelTest main
配置: CONFIG级消息