引言：Java日志格式化基础
在java应用程序开发中，日志是诊断问题、监控系统行为不可或缺的工具。java.util.logging是java标准库提供的日志框架，而simpleformatter是其中一个常用的格式化器，用于将logrecord对象转换为人类可读的字符串。simpleformatter通过一个可配置的格式字符串来控制日志的输出样式，该格式字符串利用java.util.formatter的语法，并通过索引引用logrecord中的特定字段。理解这些索引字段的含义是高效配置和使用simpleformatter的关键。
SimpleFormatter格式字符串详解
SimpleFormatter的格式字符串通常通过java.util.logging.SimpleFormatter.format系统属性或在代码中设置。它使用%n$的语法来引用LogRecord中的不同信息，其中n是一个数字，代表信息的索引位置。紧随其后的字符（如s、tc）则定义了该信息的具体格式。
以下是SimpleFormatter格式字符串中各个索引字段的详细解析：
索引字段解析
SimpleFormatter在内部会将LogRecord的各个属性映射到格式化函数（java.util.Formatter.format）的参数列表。虽然实际的format方法接受一个LogRecord作为第一个参数，但对于格式字符串中的索引引用，我们应关注其后的参数。这些参数按顺序对应着日志事件的不同方面。
-
%1$：日期/时间 (Date)
立即学习“Java免费学习笔记（深入）”；
- 含义：表示日志事件发生的时间。
- 类型：一个java.util.Date对象，代表LogRecord.getMillis()返回的毫秒时间。
-
常用格式符：
- %1$tc：完整的日期和时间（如 Tue Oct 10 14:00:00 CEST 2023）。
- %1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS.%1$tL：自定义格式，如 2023-10-10 14:00:00.123。
-
%2$：源信息 (Source)
- 含义：表示日志事件的来源。如果能够确定调用者信息，则为调用者的类名和方法名；否则，为日志器的名称。
- 类型：String。
- 常用格式符：%2$s。
-
%3$：日志器名称 (Logger Name)
- 含义：记录此日志消息的Logger实例的名称。
- 类型：String。
- 常用格式符：%3$s。
-
%4$：日志级别 (Log Level)
- 含义：日志消息的级别，如INFO、WARNING、SEVERE等。
- 类型：String，通常是Level.getLocalizedName()的本地化名称。
- 常用格式符：%4$s。
-
%5$：日志消息 (Message)
- 含义：经过格式化后的日志消息内容。此消息是通过Formatter.formatMessage(LogRecord)方法生成的。
- 类型：String。
- 注意事项：%5$的格式化机制与java.text.MessageFormat相关，而不是java.util.Formatter的格式参数。这意味着它会处理LogRecord中携带的参数数组，将它们插入到消息模板中。
- 常用格式符：%5$s。
-
%6$：异常信息 (Thrown)
- 含义：与日志记录关联的Throwable对象及其堆栈跟踪信息。如果存在异常，则此字符串以换行符开始。
- 类型：String。
- 常用格式符：%6$s。
自定义日志格式示例
假设我们希望日志输出格式为：[时间戳] [日志级别] [源] - 消息内容 [异常堆栈]。
我们可以使用如下格式字符串： %1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS.%1$tL [%4$s] [%2$s] - %5$s%6$s%n
让我们来分解一个更简单的例子，即问题中提到的格式： %1$tc %2$s%n%4$s: %5$s%6$s%n
- %1$tc：完整日期和时间。
- ` `：一个空格。
- %2$s：源信息（调用者或日志器名称）。
- %n：一个换行符，将输出分为两行。
- %4$s：日志级别。
- :：一个冒号和空格。
- %5$s：格式化的日志消息。
- %6$s：异常信息（如果存在，会包含堆栈跟踪）。
- %n：再一个换行符，确保每条日志记录独立。
代码示例：
以下代码演示了如何通过编程方式设置SimpleFormatter的格式，并输出不同类型的日志消息。
import java.io.IOException;
import java.util.logging.ConsoleHandler;
import java.util.logging.Level;
import java.util.logging.Logger;
import java.util.logging.SimpleFormatter;
public class CustomLogFormatterDemo {
private static final Logger LOGGER = Logger.getLogger(CustomLogFormatterDemo.class.getName());
public static void main(String[] args) {
// 创建一个ConsoleHandler
ConsoleHandler consoleHandler = new ConsoleHandler();
// 创建一个SimpleFormatter实例
SimpleFormatter simpleFormatter = new SimpleFormatter();
// 定义自定义的日志格式
// 示例格式: [日期时间] [级别] [源信息] - 消息内容 [异常堆栈]
// %1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS.%1$tL : 年-月-日 时:分:秒.毫秒
// %4$s : 日志级别
// %2$s : 源信息 (caller or logger name)
// %5$s : 日志消息
// %6$s : 异常信息 (if any)
String customFormat = "%1$tY-%1$tm-%1$td %1$tH:%1$tM:%1$tS.%1$tL [%4$s] [%2$s] - %5$s%6$s%n";
// 通过系统属性设置格式（这种方式在程序启动前配置更常见）
// System.setProperty("java.util.logging.SimpleFormatter.format", customFormat);
// 或者直接在代码中设置Formatter的格式
simpleFormatter = new SimpleFormatter(customFormat);
// 将自定义Formatter设置给Handler
consoleHandler.setFormatter(simpleFormatter);
// 清除Logger的默认Handler，并添加自定义Handler
// 默认情况下，根Logger会有一个ConsoleHandler，我们可能需要移除它来避免重复输出
Logger rootLogger = Logger.getLogger("");
for (java.util.logging.Handler handler : rootLogger.getHandlers()) {
rootLogger.removeHandler(handler);
}
LOGGER.addHandler(consoleHandler);
LOGGER.setLevel(Level.INFO); // 设置Logger的级别
// 输出不同类型的日志消息
LOGGER.info("这是一个普通的信息日志。");
LOGGER.warning("这是一个警告日志，参数示例: {0}, {1}", new Object[]{"param1", 123});
try {
int result = 10 / 0;
} catch (ArithmeticException e) {
LOGGER.log(Level.SEVERE, "发生了一个严重的错误：除以零！", e);
}
}
}运行上述代码，你将看到日志输出按照自定义的格式显示。
注意事项
- 格式字符串语法：SimpleFormatter的格式字符串遵循java.util.Formatter的语法。这意味着你可以使用各种格式转换符（如%s、%d、%f等）以及日期/时间转换符（如%tc、%tY等）。
- %5$的特殊性：日志消息%5$s的处理不同于其他字段。它不会直接对LogRecord中的消息字符串进行Formatter格式化，而是通过Formatter.formatMessage(LogRecord)方法处理，该方法内部可能使用java.text.MessageFormat来处理带参数的消息模板。因此，如果你的日志消息包含{0}、{1}等占位符，它们会在%5$s阶段被替换。
-
配置方式：
- 系统属性：最常见且推荐的方式是在应用程序启动时通过logging.properties文件或命令行参数-Djava.util.logging.SimpleFormatter.format="你的格式"来设置格式。
- 代码配置：如示例所示，你也可以在代码中创建SimpleFormatter实例并传入格式字符串。
- 性能考量：虽然SimpleFormatter通常不是日志性能的瓶颈，但过于复杂的格式字符串可能会略微增加处理时间。对于高吞吐量系统，应权衡日志内容的丰富度和性能。
- %n换行符：%n是平台无关的换行符，比直接使用\n更具可移植性。
总结
java.util.logging.SimpleFormatter提供了一种灵活的方式来定制Java应用程序的日志输出。通过理解其格式字符串中六个核心索引字段的含义和用法，开发者可以精确控制日志的显示内容和布局，从而提高日志的可读性和问题诊断效率。无论是通过配置文件还是编程方式，掌握SimpleFormatter的格式化机制都是Java日志管理的重要技能。
