当前位置:   article > 正文

Spring Boot + FreeMarker 实现动态Word文档导出_freemarker导出动态word段落

freemarker导出动态word段落

Spring Boot + FreeMarker 实现动态Word文档导出

在现代企业应用中,文档自动化生成是一项提升工作效率的重要功能。Spring Boot与FreeMarker的组合,为开发者提供了一个强大的平台,可以轻松实现动态Word文档的导出。本文将指导你如何使用Spring Boot与FreeMarker模板引擎,创建一个简单的应用,用于根据数据库数据动态生成Word文档并下载。

技术栈简介

  • Spring Boot:简化Spring应用初始搭建以及开发过程的框架,提供了快速开发、运行、部署的解决方案。
  • FreeMarker:一款用Java编写的模板引擎,特别适合生成HTML、XML、RTF、Java源代码等文本格式的输出,当然也包括Word文档。

准备工作

1. 创建Spring Boot项目

使用Spring Initializr创建一个新的Spring Boot项目,记得勾选Thymeleaf(虽然我们用FreeMarker,但Thymeleaf依赖也会带来Spring MVC的支持,便于后续配置)。

2. 添加FreeMarker依赖

pom.xml中加入FreeMarker的依赖。

<dependency> 
  <groupId>org.springframework.boot</groupId> 
  <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
  • 1
  • 2
  • 3
  • 4

3. 配置FreeMarker

application.properties中配置FreeMarker的路径。

spring.freemarker.template-loader-path=classpath:/templates/
  • 1

创建FreeMarker模板

src/main/resources/templates目录下,创建一个名为document.ftl的FreeMarker模板文件,内容如下:

<!DOCTYPE html>
<html> <head> <#assign document = { "title": "动态Word文档", "content": [ {"header": "章节一", "text": "这里是章节一的内容..."}, {"header": "章节二", "text": "这里是章节二的内容..."} ] }> </head> <body> <h1>${document.title}</h1> <#list document.content as section> <h2>${section.header}</h2> <p>${section.text}</p> </#list> </body> </html>
  • 1
  • 2

编写Controller

创建一个Controller来处理请求,读取模板并填充数据,最后将Word文档返回给用户下载。

java import org.springframework.beans.factory.annotation.Autowired; import org.springframework.ui.freemarker.FreeMarkerTemplateUtils; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import freemarker.template.Configuration; import freemarker.template.Template; import org.springframework.http.HttpHeaders; import org.springframework.http.MediaType; import org.springframework.http.ResponseEntity;
import java.io.IOException; import java.util.HashMap; import java.util.Map;
@RestController public class DocumentController {
@Autowired
private Configuration freemarkerConfig;

@GetMapping("/export")
public ResponseEntity<byte[]> exportDocument() throws IOException {
    // 假设数据是从数据库获取的,这里为了简化直接构造示例数据
    Map<String, Object> dataModel = new HashMap<>();
    dataModel.put("title", "来自数据库的标题");
    dataModel.put("content", getDatabaseContent());

    Template template = freemarkerConfig.getTemplate("document.ftl");
    String processedHtml = FreeMarkerTemplateUtils.processTemplateIntoString(template, dataModel);

    // 将HTML转换为Word文档(此处简化处理,实际可能需要使用Apache POI等库)
    byte[] wordBytes = convertHtmlToWord(processedHtml);

    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
    headers.setContentDispositionFormData("attachment", "document.docx");

    return new ResponseEntity<>(wordBytes, headers, HttpStatus.OK);
}

private List<Map<String, String>> getDatabaseContent() {
    // 此处模拟从数据库获取数据
    return Arrays.asList(
            Map.of("header", "数据库章节一", "text", "数据库内容一"),
            Map.of("header", "数据库章节二", "text", "数据库内容二")
    );
}

// 简化的HTML转Word逻辑,实际应用中可能需要更复杂的转换过程
private byte[] convertHtmlToWord(String html) {
    // 这里省略了HTML转Word的具体实现,可以使用第三方库如Apache POI等
    return html.getBytes(); // 这只是示例,实际返回的应该是Word文档的字节流
}
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40

总结

通过上述步骤,我们使用Spring Boot与FreeMarker成功构建了一个简单的应用,能够根据模板和数据库数据动态生成Word文档并提供下载。实际应用中,你可能需要引入额外的库(如Apache POI等)来更精确地控制Word文档的样式和结构,以及更高效地处理HTML到Word的转换过程。此外,确保处理好模板的安全性,避免注入攻击等问题。

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/盐析白兔/article/detail/853394
推荐阅读
相关标签
  

闽ICP备14008679号