使用FreeMarker,导出Word或者Excel

需求:给定Word模板,完成数据的单个导出 或者批量导出,不需要携带图片。

Word模板

Word模板如下 我们把需要填充内容的地方打上标记,并添加分页符,保证之后在填充的时候每一页只有一条记录,如下图所示。

Freemarker需要使用xml文件,我们将Word另存为xml文件,如下图所示。

另存后的xml内容是压缩过的,我们可以通过在线XML格式化。另存之后记得检查一下${xxx},有时候Word看着是正常的,但是转为xml格式之后,${xxx}有可能就分家了。

然后我们需要对xml文件进行处理,用来接收数据列表。

  1. 定位到<w:body>标签,输入<#list elems as elem>,其中elems为集合,elem为集合中的一个对象
  1. 定位到<w:sectPr>,差不多就是分页符结束的地方,我们添加上闭合标签</#list>

使用FreeMarker填充模板

引入Maven坐标

.xml 复制代码
<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.31</version>
</dependency>

实体类:最好不要用内部类,因为FreeMarker会访问实体类的get方法,如果访问不到会报错的。

java 复制代码
import lombok.Data;

@Data
public class TestInfo {
    private String name;
    private String sex;
    private String idCard;
    private String year;
    private String month;
    private String day;
    private String title;
    private String checkName;
}

填充模板并生成文件

java 复制代码
public class Test01 {
    public static void main(String[] args) {
        List<TestInfo> testData = new ArrayList<>();
        // 第一组测试数据
        TestInfo info1 = new TestInfo();
        info1.setName("张三");
        info1.setSex("男");
        info1.setIdCard("110101199003071234");
        info1.setYear("1990");
        info1.setMonth("03");
        info1.setDay("07");
        info1.setTitle("软件工程师");
        info1.setCheckName("李四");
        testData.add(info1);
        downloadFile(testData);
    }

    public static void downloadFile(List<TestInfo> detail) {
        Map<String, Object> data = new HashMap<>();
        data.put("elems", detail);
        // 预加载模板文件
        File xmlFile = new File("D:\test01.xml");
        InputStream templateStream = null;
        try {
            templateStream = new FileInputStream(xmlFile);
        } catch (FileNotFoundException e) {
            throw new RuntimeException(e);
        }
        try {
            Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
            cfg.setDirectoryForTemplateLoading(xmlFile.getParentFile());
            cfg.setDefaultEncoding("UTF-8");
            Template template = cfg.getTemplate(xmlFile.getName());
            // 4. 加载模板并生成文件
            File outputFile = new File("D:\testfile" + System.currentTimeMillis() + ".docx");
            try (Writer out = new BufferedWriter(new OutputStreamWriter(Files.newOutputStream(outputFile.toPath()), StandardCharsets.UTF_8))) {
                template.process(data, out);
            }
        } catch (IOException | TemplateException e) {
            throw new RuntimeException(e);
        } finally {
            // 关闭 InputStream
            try {
                templateStream.close();
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }
}

导出效果:

填充模板并写入响应体返回给前端

可以参考这个,先创建一个填充好的临时文件,返回给前端后,将临时文件删除。

java 复制代码
// 创建临时文件
File tempFile = null;
try {
    tempFile = File.createTempFile(fileName, ".xml");
    Files.copy(templateStream, tempFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
} catch (IOException e) {
    throw new RuntimeException(e);
}
try {
    Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
    cfg.setDirectoryForTemplateLoading(tempFile.getParentFile());
    cfg.setDefaultEncoding("UTF-8");

    // 3. 设置响应头信息
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    response.setHeader("Content-Disposition", "attachment;");
    response.setCharacterEncoding("UTF-8");
    // 4. 加载模板并生成文件
    Template template = cfg.getTemplate(tempFile.getName());
    Writer out = response.getWriter();
    template.process(data, out);
} catch (IOException | TemplateException e) {
    throw new RuntimeException(e);
} finally {
    // 关闭 InputStream
    try {
        templateStream.close();
    } catch (IOException e) {
        throw new RuntimeException(e);
    }
    tempFile.delete();
}

写在最后:导出Excel的方法,和这个差不多,有空可以试一试

相关推荐
IT_陈寒9 分钟前
Redis持久化丢失数据的坑,这次终于被我填平了
前端·人工智能·后端
葫芦和十三1 小时前
图解 MongoDB 24|分片为什么存在:垂直扩容的天花板
后端·mongodb·agent
有趣的老凌1 小时前
用 Vibe Coding 搭了一个完整小程序「一定能成」
前端·javascript·后端
葫芦和十三9 小时前
图解 MongoDB 23|两地三中心:跨可用区部署怎么扛机房故障
后端·mongodb·agent
勇哥java实战分享11 小时前
PaddleOCR 太慢?我换成 RapidOCR 后,速度直接起飞
后端
苏三说技术15 小时前
LangChain4j 和 LangGraph4j,哪个更好?
后端
ServBay16 小时前
7 个AI开发中真正用得上的 MCP Server,配合Claude Code食用效果更佳
后端·claude·mcp
妙码生花16 小时前
从 PHP 到 AI + Golang,程序员自救转型手记(十五):优化细节、网络请求封装
前端·后端·ai编程
用户67570498850217 小时前
Go 语言里判断字符串为空,90% 的人都写错了!
后端·go