Spring Boot + FreeMarker 实现按模板导出 Word 文档

最新推荐文章于 2024-07-26 13:54:28 发布

买女孩的火柴盒

最新推荐文章于 2024-07-26 13:54:28 发布

阅读量83

点赞数

原文链接：https://mp.weixin.qq.com/s?__biz=MzkwNDY2Mjg3NA==&mid=2247484669&idx=2&sn=cebb40bf94d85525c48ecb1fe623cf4b&chksm=c082dec8f7f557de6623434bdb75c23b99756a637c4b875448e500cac71b971078a870396fc1&cur_album_id=3376231304547123201&scene=189#wechat_redirect

版权

SpringBoot是一个简化新Spring应用的初始搭建以及开发过程的框架，而FreeMarker是一个基于模板引擎的Java库，可以用来生成HTML网页、配置文件、电子邮件以及各种格式的文本文档。在这篇文章中，我们将结合使用SpringBoot和FreeMarker来生成和导出Word文档。

项目设置

首先，我们需要创建一个SpringBoot项目，并添加必要的依赖。我们使用 Maven作为构建工具。

Maven 依赖

在pom.xml文件中添加以下依赖：

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- FreeMarker -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-freemarker</artifactId>
    </dependency>
    
    <!-- Apache POI for Word document creation -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.0.0</version>
    </dependency>
</dependencies>

创建 FreeMarker 模板

接下来，我们需要创建一个FreeMarker模板文件。假设我们要生成一份简单的报告，模板文件report.ftl可以如下所示：

<#-- report.ftl -->
<html>
<head>
    <title>${title}</title>
</head>
<body>
    <h1>${title}</h1>
    <p>${content}</p>
</body>
</html>

将该模板文件放在src/main/resources/templates目录下。

实现导出功能

在这一步，我们将创建一个控制器来处理导出请求，并生成Word文档。

创建控制器

package com.example.demo.controller;

import freemarker.template.Configuration;
import freemarker.template.Template;
import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.apache.poi.xwpf.usermodel.XWPFRun;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import java.io.ByteArrayOutputStream;
import java.io.OutputStreamWriter;
import java.util.HashMap;
import java.util.Map;

@RestController
public class ExportController {

    @Autowired
    private Configuration freemarkerConfig;

    @GetMapping("/export")
    public void exportWord(HttpServletResponse response) throws Exception {
        // 设置 FreeMarker 模板参数
        Map<String, Object> dataModel = new HashMap<>();
        dataModel.put("title", "报告标题");
        dataModel.put("content", "这是报告的内容。");

        // 获取 FreeMarker 模板
        Template template = freemarkerConfig.getTemplate("report.ftl");

        // 将模板数据输出到字符串
        ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
        try (OutputStreamWriter outputStreamWriter = new OutputStreamWriter(byteArrayOutputStream)) {
            template.process(dataModel, outputStreamWriter);
        }

        // 创建 Word 文档
        XWPFDocument document = new XWPFDocument();
        XWPFParagraph paragraph = document.createParagraph();
        XWPFRun run = paragraph.createRun();
        run.setText(byteArrayOutputStream.toString());

        // 设置响应头
        response.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
        response.setHeader("Content-Disposition", "attachment; filename=report.docx");

        // 将 Word 文档写入响应输出流
        document.write(response.getOutputStream());
        response.getOutputStream().flush();
        document.close();
    }
}

配置 FreeMarker

在src/main/resources目录下创建application.properties文件，添加以下配置：

spring.freemarker.template-loader-path=classpath:/templatesspring.freemarker.default-encoding=UTF-8

运行与测试

启动SpringBoot应用，并在浏览器中访问http://localhost:8080/export，浏览器将下载生成的Word文档。

总结

本文介绍了如何使用SpringBoot和FreeMarker实现按模板导出Word文档。通过这种方式，我们可以轻松地生成复杂的文档内容，并导出为用户友好的 Word 格式。希望本教程对你有所帮助！

买女孩的火柴盒

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Spring Boot + FreeMarker 实现按模板导出 Word 文档

SpringBoot是一个简化新Spring应用的初始搭建以及开发过程的框架，而FreeMarker是一个基于模板引擎的Java库，可以用来生成HTML网页、配置文件、电子邮件以及各种格式的文本文档。通过这种方式，我们可以轻松地生成复杂的文档内容，并导出为用户友好的 Word 格式。希望本教程对你有所帮助！启动SpringBoot应用，并在浏览器中访问http://localhost:8080/export，浏览器将下载生成的Word文档。在这一步，我们将创建一个控制器来处理导出请求，并生成Word文档。
复制链接

扫一扫