JDK Logger 简介 (zhuan)

http://antlove.iteye.com/blog/1924832

*******************************************

一 简述

java.util.logging是JDK自带的日志记录包。

默认情况下，JDK的LogManager会在JRE目录下的"lib/logging.properties"这个文件中读取配置。

JDK的日志包涉及handler,formatter,level

名词	描述
handler	将日志信息记录到指定的流之中，可能是控制台或者是一个文件或者是任意存储区域。 常用实现类 ConsoleHandler, FileHandler, SocketHandler
formatter	日志信息格式化类。常用实现类 SimpleFormatter, XMLFormatter
level	日志记录级别。 SEVERE（最高值） 、WARNING 、INFO 、CONFIG 、FINE 、FINER 、FINEST（最低值） ALL(记录所有信息)  OFF(不记录任何级别信息)

二 简单Demo

MySimpleFormatter.java

1. package logging.formatter;
2. import java.text.SimpleDateFormat;
3. import java.util.Date;
4. import java.util.logging.Level;
5. import java.util.logging.LogRecord;
6. import java.util.logging.SimpleFormatter;
7. public class MySimpleFormatter extends SimpleFormatter{
8. private SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
9. private StringBuilder sb = new StringBuilder();
10. @Override
11. public synchronized String format(LogRecord record)
12. {
13. Level level=record.getLevel();
14. String time=sdf.format(new Date(record.getMillis()));
15. String loggerName=record.getLoggerName();
16. String message=record.getMessage();
17. this.sb.append("[").append(level).append("]");
18. this.sb.append(" ").append(time);
19. this.sb.append(" ").append(loggerName);
20. this.sb.append(" :").append(message);
21. this.sb.append("\n");
22. return sb.toString();
23. }
24. }

DefaultStreamHandler.java

1. package logging.handler;
2. import java.io.OutputStream;
3. import java.util.logging.StreamHandler;
4. public class DefaultStreamHandler extends StreamHandler {
5. @Override
6. public synchronized void setOutputStream(OutputStream out)
7. throws SecurityException {
8. super.setOutputStream(out);
9. }
10. }

CustomLogManager.java

1. package logging.util;
2. import java.io.IOException;
3. import java.io.InputStream;
4. import java.util.logging.ConsoleHandler;
5. import java.util.logging.FileHandler;
6. import java.util.logging.Level;
7. import java.util.logging.LogManager;
8. import java.util.logging.Logger;
9. import logging.formatter.MySimpleFormatter;
10. import logging.handler.DefaultStreamHandler;
11. public class CustomLogManager{
12. static{
13. LogManager.getLogManager().reset(); // reset the log manager
14. }
15. // read the log configuration from outside property file
16. public static void resetFromPropertyFile(String filePath){
17. LogManager logManager = LogManager.getLogManager();
18. InputStream inputStream = CustomLogManagerEditor.class.getClassLoader().getResourceAsStream(filePath);
19. try {
20. logManager.readConfiguration(inputStream);
21. } catch (Exception e) {
22. throw new RuntimeException("reload log configuration fail: "+e.toString());
23. }
24. }
25. public static Logger getLogger(String name){
26. Logger logger=Logger.getLogger(name);
27. logger.setLevel(Level.ALL);
28. // add console handler
29. ConsoleHandler consoleHandler=new ConsoleHandler();
30. consoleHandler.setLevel(Level.FINE);
31. consoleHandler.setFormatter(new MySimpleFormatter());
32. logger.addHandler(consoleHandler);
33. // add file handler
34. FileHandler fileHandler=null;
35. try {
36. fileHandler = new FileHandler("log.log",true);
37. fileHandler.setLevel(Level.FINE);
38. fileHandler.setFormatter(new MySimpleFormatter());
39. logger.addHandler(fileHandler);
40. } catch (SecurityException e) {
41. e.printStackTrace();
42. } catch (IOException e) {
43. e.printStackTrace();
44. }
45. // add default stream handler
46. DefaultStreamHandler defaultStreamHandler = new DefaultStreamHandler();
47. defaultStreamHandler.setLevel(Level.ALL);
48. defaultStreamHandler.setFormatter(new MySimpleFormatter());
49. defaultStreamHandler.setOutputStream(System.out);
50. logger.addHandler(defaultStreamHandler);
51. return logger;
52. }
53. }

logging.properties

1. #Level的五个等级SEVERE（最高值） 、WARNING 、INFO 、CONFIG 、FINE 、FINER 、FINEST（最低值）  。这个不同于log4j
2. #指定默认logger级别
3. .level= ALL
4. #为 Handler 指定默认的级别（默认为 Level.INFO）。
5. java.util.logging.ConsoleHandler.level=FINE
6. # 指定要使用的 Formatter 类的名称（默认为 java.util.logging.SimpleFormatter）。
7. java.util.logging.ConsoleHandler.formatter=logging.formatter.MySimpleFormatter
8. # 为 Handler 指定默认的级别（默认为 Level.ALL）。
9. java.util.logging.FileHandler.level=ALL
10. # 指定要使用的 Formatter 类的名称（默认为 java.util.logging.XMLFormatter）。
11. java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
12. # 指定要写入到任意文件的近似最大量（以字节为单位）。如果该数为 0，则没有限制（默认为无限制）。
13. java.util.logging.FileHandler.limit=1024000
14. # 指定有多少输出文件参与循环（默认为 1）。
15. java.util.logging.FileHandler.count=1
16. # 为生成的输出文件名称指定一个模式。有关细节请参见以下内容（默认为 "%h/java%u.log"）。
17. java.util.logging.FileHandler.pattern=u.log
18. # 指定是否应该将 FileHandler 追加到任何现有文件上（默认为 false）。
19. java.util.logging.FileHandler.append=true
20. handlers= java.util.logging.ConsoleHandler,java.util.logging.FileHandler

测试类

Main.java

1. package logging;
2. import java.io.IOException;
3. import java.util.logging.Logger;
4. import logging.util.CustomLogManager;
5. public class Main {
6. public static void main(String[] args) throws SecurityException, IOException {
7. //      CustomLogManager.resetFromPropertyFile("logging/logging.properties");
8. //      Logger logger=Logger.getLogger(Main.class.getName());
9. Logger logger=CustomLogManager.getLogger(Main.class.getName());
10. logger.fine("warning test!");
11. }
12. }

 Note:

CustomLogManagerEditor.getLogger返回的logger拥有三个handler，所以记录日志信息的时候，日志信息会被存储到三个区域【log.log,System.out,System.err】。

当启用CustomLogManagerEditor.resetFromPropertyFile("logging/logging.properties");时，日志信息会被记录到控制台，以及u.log文件。

如果即调用CustomLogManagerEditor.resetFromPropertyFile("logging/logging.properties");又通过CustomLogManagerEditor.getLogger返回的logger记录日志，因为logger有5个handler，所以日志信息会被记录到4个区域【u.log,log.log,System.out,System.err】 其中在System.err中会记录2次。