深入浅出揭秘：用Freemarker巧妙实现Word文档模板动态生成

2023-10-26 08:21:43

1. Freemarker简介

Freemarker是一个开源的模板引擎，它允许您使用模板来生成文本输出，如HTML、XML、Word文档等。Freemarker使用一种称为FTL(Freemarker Template Language)的模板语言来定义模板，FTL是一种简单的文本语言，类似于HTML。

2. 创建模板

要使用Freemarker生成Word文档，首先需要创建一个模板。模板可以是任何文本文件，但通常使用.ftl扩展名。模板中包含要生成Word文档所需的代码和占位符，占位符用于指定要动态填充的数据的位置。

3. 准备数据

在创建模板之后，需要准备要填充模板的数据。数据可以是任何格式，如JSON、XML、Java对象等。为了便于与Freemarker配合使用，通常将数据转换为Map或List结构。

4. 将数据与模板融合

将数据准备就绪后，就可以将数据与模板融合，生成Word文档。Freemarker提供了一个称为Configuration的类来加载模板和数据，并生成输出文档。

5. 代码示例

以下是一个使用Freemarker生成Word文档的代码示例：

import freemarker.template.Configuration;
import freemarker.template.Template;
import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;

public class FreemarkerWordDemo {

    public static void main(String[] args) throws Exception {
        // 创建Freemarker配置对象
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);

        // 设置模板加载路径
        cfg.setDirectoryForTemplateLoading(new File("templates"));

        // 加载模板
        Template template = cfg.getTemplate("word.ftl");

        // 准备数据
        Map<String, Object> data = new HashMap<>();
        data.put("title", "Freemarker Word文档生成演示");
        data.put("content", "这是一个使用Freemarker生成的Word文档。");

        // 生成Word文档
        File outputFile = new File("output.docx");
        Writer writer = new OutputStreamWriter(new FileOutputStream(outputFile), "UTF-8");
        template.process(data, writer);
        writer.flush();
        writer.close();

        System.out.println("Word文档生成成功！");
    }
}