java freemarker传值

原创

mob64ca12d42833 2024-08-12 06:16:32 ©著作权

文章标签 FreeMarker java Java 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者mob64ca12d42833的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java FreeMarker 传值的应用

在Java web开发中，模板引擎被广泛应用于动态生成HTML页面。FreeMarker 是一种流行的模板引擎，它能够让我们将业务逻辑与视图层分离，便于管理和维护。本文将介绍如何在Java中使用FreeMarker进行数据传递，并提供具体的代码示例。

FreeMarker 的基本概念

FreeMarker模板是一种简单的文本文件，它包含了一些特定格式的标记。我们可以在这些标记之间插入我们的Java对象，从而动态生成HTML内容。使用FreeMarker的基本步骤如下：

创建FreeMarker配置对象
加载模板文件
准备数据模型
合并数据模型与模板生成最终HTML

代码示例

以下是一个简单的示例，其中展示了如何在Java中使用FreeMarker传递数据。

import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import freemarker.template.TemplateExceptionHandler;

import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;

public class FreeMarkerExample {
    public static void main(String[] args) {
        // 1. 创建 FreeMarker 配置对象
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_30);
        try {
            cfg.setDirectoryForTemplateLoading(new File("src/main/resources/templates"));
            cfg.setDefaultEncoding("UTF-8");
            cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
        } catch (IOException e) {
            e.printStackTrace();
        }

        // 2. 加载模板
        try {
            Template template = cfg.getTemplate("example.ftl");

            // 3. 准备数据模型
            Map<String, Object> dataModel = new HashMap<>();
            dataModel.put("user", "Alice");
            dataModel.put("message", "Welcome to FreeMarker!");

            // 4. 合并数据模型与模板
            Writer out = new FileWriter(new File("output.html"));
            template.process(dataModel, out);
            out.close();
        } catch (IOException | TemplateException e) {
            e.printStackTrace();
        }
    }
}

FreeMarker 模板文件

在上面的代码中，我们要创建一个名为 example.ftl 的 FreeMarker 模板文件，内容如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Welcome Page</title>
</head>
<body>
    Hello, ${user}!
    <p>${message}</p>
</body>
</html>

旅行图

接下来，我们用Mermaid语法绘制一个简单的旅行图，展示数据传输的过程：

journey
    title FreeMarker 数据传输旅程
    section 配置阶段
      创建 FreeMarker 配置对象: 5: 善良
      设置模板加载路径: 4: 善良
    section 模板处理
      加载模板: 4: 善良
      准备数据模型: 5: 善良
    section 合并输出
      合并数据与模板: 5: 善良
      输出 HTML 文件: 5: 善良

类图

最后，我们用Mermaid语法绘制 FreeMarker 相关的类图，以便更好地理解它的结构：

classDiagram
    class Configuration {
        +void setDirectoryForTemplateLoading(File dir)
        +void setDefaultEncoding(String encoding)
        +Template getTemplate(String name)
    }

    class Template {
        +void process(Map<String, Object> model, Writer out)
    }

    class TemplateExceptionHandler {
        +static final TemplateExceptionHandler RETHROW_HANDLER
    }

    Configuration --> Template
    Template --> TemplateExceptionHandler