Java中 StringBuilder 怎么实现自定义的多行日志格式化输出器-java教程-PHP中文网

java中stringbuilder适合构建多行结构化日志，需封装为链式multilinelogbuilder类，支持缩进控制、段落分隔、敏感字段脱敏及异常堆栈格式化输出。

java中 stringbuilder 怎么实现自定义的多行日志格式化输出器

Java 中 StringBuilder 本身不提供日志格式化功能，但它是非常适合构建多行、结构化日志字符串的底层工具。实现一个“自定义多行日志格式化输出器”，核心是用 StringBuilder 拼接带缩进、换行、字段对齐和上下文信息的文本块，而不是依赖日志框架的内置格式（如 Logback 的 %X{traceId}），而是手动控制每一行内容。

设计一个可复用的多行日志构建器

不要每次日志都手写 sb.append("...").append(" ")，封装成类更清晰：

构造时传入基础信息（如时间、线程名、日志级别）
提供链式方法添加「段落」：请求头、参数、响应体、异常堆栈等
每段自动加前缀缩进（比如 " │ " 或 " "），并以空行分隔
最终调用 toString() 返回完整多行字符串，供 logger.info(builder.toString()) 输出

支持嵌套结构与缩进控制

多行日志常需体现层次，比如 HTTP 请求 → Headers → Body → Response。可用简单缩进计数模拟层级：

javascript-pro

专注现代 ECMAScript、异步编程、性能优化和全栈的 JavaScript 专家，适用于现代开发

下载

内部维护一个 indentLevel，初始为 0
indent() 方法将层级 +1，outdent() 减 1
appendLine(String s) 自动拼上前缀空格（如 " ".repeat(indentLevel)）和换行
遇到 JSON 或 XML 内容，可调用第三方库（如 Jackson 的 defaultPrettyPrinter）美化后追加，避免手写换行缩进

处理特殊内容：异常堆栈与敏感字段脱敏

直接 e.printStackTrace(new PrintWriter(stringWriter)) 会生成多行字符串，但需注意：

用 StringWriter + PrintWriter 捕获堆栈，再逐行读取、每行前加缩进，避免破坏整体排版
对日志中的手机号、身份证号、token 等字段，在 append 前做正则替换（如 str.replaceAll("(\d{3})\d{4}(\d{4})", "$1****$2")）
敏感字段建议统一走 mask(String raw) 方法，而非散落在各处

示例：一个轻量级 `MultiLineLogBuilder`

代码片段示意（不含依赖）：

public class MultiLineLogBuilder {
    private final StringBuilder sb = new StringBuilder();
    private int indent = 0;

    public MultiLineLogBuilder info(String msg) {
        appendLine("INFO | " + msg);
        return this;
    }

    public MultiLineLogBuilder section(String title) {
        appendLine("─ " + title + " ─");
        indent++;
        return this;
    }

    public MultiLineLogBuilder kv(String key, Object value) {
        String line = String.format("%-12s: %s", key, Objects.toString(value, "null"));
        appendLine(line);
        return this;
    }

    private void appendLine(String s) {
        sb.append("    ".repeat(indent)).append(s).append("
");
    }

    public String toString() {
        return sb.toString().trim(); // 去掉末尾多余换行
    }
}

使用：

logger.debug(new MultiLineLogBuilder()<br>
    .info("HTTP request start")<br>
    .section("Request")<br>
    .kv("Method", "POST")<br>
    .kv("URL", "/api/user")<br>
    .section("Headers")<br>
    .kv("Auth", mask("Bearer abc123..."))<br>
    .toString());