Java实现类XML TOKEN占位符替换：优先对象值否则用标签默认值

核心需求拆解 #

• 待处理模板为带TOKEN标签的类XML字符串，每个<TOKEN>标签固定携带RW属性（作为兜底默认值），标签内部是%变量名格式的占位符
• 替换规则：占位符对应的业务值非空时，将整个<TOKEN>...</TOKEN>片段替换为实际业务值；业务值为空/不存在时，将整个片段替换为RW属性配置的默认值
• 期望效果：有效值场景输出1234_320_Y_REG111B6，值全空场景输出J_320_Y_N12345B6

现有实现的核心问题 #

多层字符串拆分拼接的方案天然存在缺陷：

• 拆分逻辑强耦合固定的字符串格式，一旦标签格式微调（比如属性顺序变化、标签加了其他属性、占位符带特殊字符）就会直接失效
• 嵌套循环的分支多，单元测试需要覆盖所有拆分边界，维护成本极高
• 全局状态（比如代码里的withDefaultValue标志位）容易在多场景调用时出现传值错误，通用性不足

可复用的优雅实现 #

采用预编译正则匹配+动态回调替换的思路，完全替代手动拆分逻辑，代码简洁且边界可控。

1. 定义匹配规则 #

正则需要兼容日常格式的小变体，精准定位所有TOKEN标签，规则写为：
<TOKEN\s+RW=([^>]+)>([^<]+)</TOKEN>
各部分说明：

• \s+ 兼容标签名和属性之间存在多空格的情况，不会因为多一个空格就匹配失败
• 第一个捕获组([^>]+)：提取RW=后面、直到>之前的内容，也就是标签配置的兜底默认值
• 第二个捕获组([^<]+)：提取标签内部、直到</TOKEN>之前的内容，也就是%FLTNUM这类占位符

2. 封装通用解析工具 #

把占位符和实际值的映射做成可传入参数，不硬编码业务逻辑，所有场景可以直接复用：

import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import org.apache.commons.lang3.StringUtils;

public class TokenTemplateResolver {
    // 预编译正则，避免每次调用重复编译的性能开销
    private static final Pattern TOKEN_PATTERN = Pattern.compile("<TOKEN\\s+RW=([^>]+)>([^<]+)</TOKEN>");

    /**
     * 解析类XML模板字符串
     * @param template 待处理的类XML模板
     * @param valueMap 占位符-实际值映射，例如 {%FLTNUM=1234, %REGNUM=REG111}
     * @return 替换完成的最终字符串
     */
    public static String resolve(String template, Map<String, String> valueMap) {
        if (StringUtils.isBlank(template)) {
            return template;
        }
        Matcher matcher = TOKEN_PATTERN.matcher(template);
        StringBuilder result = new StringBuilder();
        while (matcher.find()) {
            String defaultValue = matcher.group(1);
            String placeholder = matcher.group(2).trim();
            // 取对应占位符的实际值，未配置则默认空字符串
            String actualValue = valueMap.getOrDefault(placeholder, "");
            // 按规则判断替换值：实际值非空用实际值，否则用RW配置的默认值
            String replacement = StringUtils.isNotBlank(actualValue) ? actualValue : defaultValue;
            // 转义特殊字符，避免替换值里的$、\等符号引发正则匹配异常
            matcher.appendReplacement(result, Matcher.quoteReplacement(replacement));
        }
        // 拼接模板里非TOKEN的其余固定片段
        matcher.appendTail(result);
        return result.toString();
    }
}

3. 业务侧调用方式 #

无需编写拆分逻辑，直接传入对应的值映射即可：

public static void main(String[] args) {
    String template = "<TOKEN RW=J>%FLTNUM</TOKEN>_320_Y_<TOKEN RW=N12345>%REGNUM</TOKEN>B6";
    
    // 场景1：业务值有效
    Map<String, String> validValueMap = Map.of(
        "%FLTNUM", "1234",
        "%REGNUM", "REG111"
    );
    System.out.println(TokenTemplateResolver.resolve(template, validValueMap));
    // 输出：1234_320_Y_REG111B6

    // 场景2：业务值为空
    Map<String, String> emptyValueMap = Map.of(
        "%FLTNUM", "",
        "%REGNUM", ""
    );
    System.out.println(TokenTemplateResolver.resolve(template, emptyValueMap));
    // 输出：J_320_Y_N12345B6
}

方案优势 #

• 逻辑集中：所有TOKEN的处理逻辑都在正则匹配的回调里，没有嵌套拆分循环，代码可读性高
• 测试成本低：单元测试只需要覆盖正则匹配的边界场景、值判断规则，不需要测试各种拆分分支，测试用例可减少60%以上
• 抗变更能力强：只要TOKEN标签的核心格式不变，哪怕模板里加了其他无关字符串、其他类型的标签，也不会影响替换逻辑
• 无全局状态：每个TOKEN的取值根据自身对应的占位符独立判断，不会因为标志位传错出现跨场景串值的问题

内容的提问来源于stack exchange，提问作者Prashant