理解 SimpleFormatter 的日志格式化机制
java.util.logging.simpleformatter 是 java 日志 api (jul) 中一个常用的格式化器，它允许开发者通过配置一个格式字符串来定制日志输出的样式。这个格式字符串遵循 java.util.formatter 的语法，并特别定义了六个索引参数，分别对应日志记录的不同组成部分。理解这些索引参数的含义是实现精确日志格式控制的关键。
SimpleFormatter 的格式字符串通常通过设置 java.util.logging.SimpleFormatter.format 系统属性来指定。例如： java.util.logging.SimpleFormatter.format="%1$tc %2$s%n%4$s: %5$s%6$s%n" 这个字符串定义了日志的输出布局，其中 %n 代表换行符，而 %x$ 形式的占位符则引用了特定的日志数据。
核心格式化字段详解
SimpleFormatter 提供了六个预定义的索引字段，它们与 LogRecord 对象中的特定属性相对应。以下是每个字段的详细说明：
-
%1$：日期 (Date)
- 类型： java.util.Date 对象。
- 含义： 代表日志事件发生的时间。通常与 tc 格式化标志结合使用，如 %1$tc，用于输出完整的日期和时间信息。
- 对应 LogRecord 方法： getMillis() 转换为 Date 对象。
-
%2$：源 (Source)
- 类型： 字符串。
- 含义： 表示日志事件的来源。如果调用者信息可用（例如，通过 Logger.logp 或配置 LogManager 启用），则为调用者的类名和方法名；否则，为日志器的名称。
- 对应 LogRecord 方法： getSourceClassName() 和 getSourceMethodName() 或 getLoggerName()。
-
%3$：日志器名称 (Logger Name)
立即学习“Java免费学习笔记（深入）”；
- 类型： 字符串。
- 含义： 记录此日志消息的日志器的完整名称。
- 对应 LogRecord 方法： getLoggerName()。
-
%4$：日志级别 (Level)
- 类型： 字符串。
- 含义： 日志消息的级别，例如 "INFO", "WARNING", "SEVERE" 等，通常是本地化的名称。
- 对应 LogRecord 方法： getLevel().getLocalizedName()。
-
%5$：消息 (Message)
- 类型： 字符串。
- 含义： 经过格式化后的日志消息内容。这是通过 Formatter.formatMessage(LogRecord) 方法处理后的结果，它支持 java.text.MessageFormat 风格的参数替换。
- 对应 LogRecord 方法： getMessage() 经过 Formatter 处理。
-
%6$：异常堆栈 (Thrown)
- 类型： 字符串。
- 含义： 如果日志记录中关联了 Throwable 对象，则此字段包含异常的堆栈跟踪信息，以换行符开头。如果没有异常，则为空字符串。
- 对应 LogRecord 方法： getThrown()。
示例：自定义日志输出格式
下面通过一个 Java 应用程序来演示如何配置 SimpleFormatter 的格式字符串，并观察其输出效果。
import java.io.IOException;
import java.util.logging.ConsoleHandler;
import java.util.logging.Level;
import java.util.logging.LogManager;
import java.util.logging.Logger;
public class CustomLogFormatterDemo {
public static void main(String[] args) {
// 1. 设置自定义的SimpleFormatter格式字符串
// 格式：[日期时间] [日志级别] [源] - 消息内容 (异常堆栈)
System.setProperty("java.util.logging.SimpleFormatter.format",
"[%1$tc] [%4$-7s] [%2$s] - %5$s%6$s%n");
// 2. 获取根Logger，并确保ConsoleHandler已添加
// 通常，默认的LogManager会配置一个ConsoleHandler
Logger rootLogger = LogManager.getLogManager().getLogger("");
rootLogger.setLevel(Level.ALL); // 设置最低日志级别以捕获所有消息
// 确保ConsoleHandler使用SimpleFormatter
// 如果没有明确设置，默认的ConsoleHandler会使用SimpleFormatter
// 并且会读取java.util.logging.SimpleFormatter.format属性
boolean hasConsoleHandler = false;
for (java.util.logging.Handler handler : rootLogger.getHandlers()) {
if (handler instanceof ConsoleHandler) {
hasConsoleHandler = true;
break;
}
}
if (!hasConsoleHandler) {
ConsoleHandler ch = new ConsoleHandler();
rootLogger.addHandler(ch);
}
Logger logger = Logger.getLogger(CustomLogFormatterDemo.class.getName());
// 3. 记录不同类型的日志消息
logger.info("这是一条普通的信息日志。");
logger.warning("发现一个潜在的问题，请注意。");
logger.fine("这是一条详细的调试信息。", new Object[]{"参数1", 123}); // fine级别默认不输出，除非Handler级别更低
try {
int result = 10 / 0;
} catch (ArithmeticException e) {
logger.log(Level.SEVERE, "发生严重错误：除数为零！", e);
}
}
}运行上述代码，你将看到类似以下的输出（日期时间会不同）：
[2023年10月27日 下午03时30分00秒 CST] [INFO ] [CustomLogFormatterDemo] - 这是一条普通的信息日志。
[2023年10月27日 下午03时30分00秒 CST] [WARNING] [CustomLogFormatterDemo] - 发现一个潜在的问题，请注意。
[2023年10月27日 下午03时30分00秒 CST] [SEVERE ] [CustomLogFormatterDemo] - 发生严重错误：除数为零！
java.lang.ArithmeticException: / by zero
at CustomLogFormatterDemo.main(CustomLogFormatterDemo.java:41)格式字符串解析："[%1$tc] [%4$-7s] [%2$s] - %5$s%6$s%n"
- %1$tc: 输出完整的日期和时间。
- %4$-7s: 输出日志级别 (%4$)，左对齐 (-)，占用至少7个字符宽度 (7)，作为字符串 (s)。这有助于对齐不同长度的级别名称。
- %2$s: 输出日志源（通常是类名和方法名）。
- -: 输出字面量 -。
- %5$s: 输出格式化后的日志消息。
- %6$s: 输出异常堆栈信息（如果存在）。
- %n: 换行。
注意事项
- 系统属性设置： java.util.logging.SimpleFormatter.format 属性需要在日志系统初始化之前设置。最常见的方式是在程序启动时通过 -D 参数传递给 JVM，或者在代码中通过 System.setProperty() 在 main 方法的早期调用。
- LogManager 配置： 如果你使用了 logging.properties 文件来配置 JUL，也可以在该文件中设置 java.util.logging.SimpleFormatter.format 属性。
- 性能考虑： 获取源信息 (%2$) 可能会涉及堆栈跟踪，这在性能敏感的应用中可能带来轻微开销。如果不需要精确的调用者信息，可以省略此字段。
- MessageFormat 与 Formatter： %5$ 消息字段本身支持 java.text.MessageFormat 风格的参数化，例如 logger.info("User {0} logged in.", "Alice");。而整个格式字符串是 java.util.Formatter 风格的。
- 默认行为： 如果不设置自定义格式，SimpleFormatter 会使用其默认的格式。
总结
通过掌握 SimpleFormatter 的六个索引字段，开发者可以高度定制 Java JUL 的日志输出格式，使其更具可读性、更符合特定需求。无论是为了调试、审计还是生产监控，灵活配置日志格式都是提升日志有效性的重要手段。建议根据实际应用场景，选择合适的字段组合和格式化标志，创建清晰、简洁且富有信息量的日志输出。
