freemarker生成excel教程

Freemarker 是一种基于模板的通用文本生成器，可以用于生成各种文档类型，包括 Excel。下面是一个简单的教程，介绍如何使用 Freemarker 生成 Excel 文件。

1. 准备数据

首先，需要准备要填充到 Excel 文件中的数据。可以将数据存储在一个 Java 对象中，然后将该对象传递给 Freemarker 模板。

例如，假设我们要生成一个包含以下信息的 Excel 文件：

| 姓名 | 年龄 | 性别 |
| ---- | ---- | ---- |
| 张三 | 20 | 男 |
| 李四 | 25 | 女 |

我们可以定义一个 Java 类来表示这些数据：

public class Person {
    private String name;
    private int age;
    private String gender;
 
    // 省略 getter 和 setter 方法
}

然后创建一个包含 Person 对象的 List：

List<Person> persons = new ArrayList<>();
Person person1 = new Person("张三", 20, "男");
Person person2 = new Person("李四", 25, "女");
persons.add(person1);
persons.add(person2);

2. 创建 Freemarker 模板

接下来，需要创建一个 Freemarker 模板，用于定义 Excel 文件的格式和样式。

例如，我们可以创建一个名为 `template.ftl` 的模板文件，其中包含以下内容：

<?xml version="1.0"?>
<workbook>
    <worksheet>
        <row>
            <cell>姓名</cell>
            <cell>年龄</cell>
            <cell>性别</cell>
        </row>
        <#list persons as person>
            <row>
                <cell>${person.name}</cell>
                <cell>${person.age}</cell>
                <cell>${person.gender}</cell>
            </row>
        </#list>
    </worksheet>
</workbook>

此模板将生成一个包含表头和数据行的 Excel 文件。

3. 使用 Freemarker 生成 Excel 文件

现在，可以使用 Freemarker 解析模板并生成 Excel 文件。下面是一个示例代码：

Configuration cfg = new Configuration(Configuration.VERSION_2_3_30);
cfg.setClassForTemplateLoading(getClass(), "/");
Template template = cfg.getTemplate("template.ftl");
Map<String, Object> data = new HashMap<>();
data.put("persons", persons);
 
File outputFile = new File("output.xlsx");
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    XlsxExporter exporter = new XlsxExporter();
    exporter.setConfiguration(cfg);
    exporter.export(template, data, outputStream);
}

此代码创建了一个 Freemarker 配置对象，并将模板文件加载到该对象中。然后，将数据存储在一个 Map 对象中，并将其传递给模板。最后，使用 XlsxExporter 类将模板解析为 Excel 文件。

需要注意的是，上述示例代码需要引入以下依赖：

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.30</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml-export</artifactId>
    <version>4.1.2</version>
</dependency>

以上就是使用 Freemarker 生成 Excel 文件的简单教程。希望对你有所帮助！