Thymeleaf 2.1迁移至3.0：模板读取与节点操作问题求助

在 Thymeleaf 3.0 中，核心架构从基于 DOM 的 Document/Node 体系切换到了轻量的 IModel 模型系统，这也是你原来的 2.1 版本代码无法直接复用的原因。下面我会给出适配 3.0 的解决方案，不用修改大量 HTML 文件，保持你原有 Java 层的处理逻辑。

第一步：从模板文件获取 IModel #

Thymeleaf 3.0 不再通过 Template.getDocument() 获取 DOM 树，而是通过模板解析器直接将模板解析为 IModel（由 IModelNode 组成的集合）。你可以通过以下代码实现类似原来 getTemplate 的功能：

protected IModel getTemplateAsModel(String templateName, IProcessorContext context) {
    // 获取核心配置组件
    IConfiguration configuration = context.getConfiguration();
    ITemplateParser templateParser = configuration.getTemplateParser();
    
    // 定位模板资源（需确保资源解析器配置正确，比如classpath下的test/input.html）
    ITemplateResource templateResource = configuration.getResourceResolver()
        .getResource(configuration, templateName);
    
    // 解析模板为IModel
    return templateParser.parseTemplate(
        configuration, 
        templateResource, 
        context.getTemplateMode() // 对应模板的模式，比如HTML
    );
}

第二步：适配原有节点处理逻辑到 IModel #

你原来的 UsingDocument 方法是操作 NestableNode，在 3.0 中要改为操作 IModelElement（对应 HTML 元素节点）。下面是调整后的代码：

private IModelElement processModelElement(IModelElement element, IProcessorContext context) {
    IModelFactory modelFactory = context.getModelFactory();
    
    // 处理属性，设置局部变量
    for (Map.Entry<String, Attribute> attribute : element.getAttributeMap().entrySet()) {
        String varName = PrefixUtils.getUnprefixed(attribute.getValue().getOriginalName());
        element.setLocalVariable(varName, attribute.getValue().getValue());
    }
    
    // 处理节点属性
    for (String property : element.getPropertyNames()) {
        element.setLocalVariable(property, element.getProperty(property));
    }
    
    // 标记子节点为可处理
    List<IModelNode> children = element.getAllChildren();
    for (IModelNode child : children) {
        if (child instanceof IProcessableElementTag) {
            ((IProcessableElementTag) child).setProcessable(true);
        }
    }
    
    // 设置children变量和属性
    element.setLocalVariable("children", children);
    element.setProperty("children", children);
    
    return element;
}

关键注意事项 #

• 组件获取方式：在自定义处理器中，IProcessorContext 会在 process 方法中自动传入，你可以通过它获取 IConfiguration、IModelFactory 等核心组件，无需手动构建旧的 TemplateProcessingParameters。
• 资源解析器配置：确保你的模板资源（比如 test/input.html）能被配置的资源解析器找到，比如使用 ClasspathResourceResolver 时，模板需放在 classpath 目录下。
• IModel 特性：IModel 是 Thymeleaf 3.0 专为高性能模板处理设计的轻量模型，相比旧的 DOM 树更高效，操作方式也更简洁，核心是通过 IModelFactory 创建/修改节点。

这样调整后，你就能在不修改大量 HTML 文件的前提下，完成从 2.1 到 3.0 的代码迁移，保持原有架构的核心逻辑。

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