当前位置： 首页 > news >正文

FreeMarker生成word文档，固定word模板

news 2025/6/30 5:58:43

该方法也就是通过freemarker生成固定的word文档，动态的word模板布局不能用该方法。

也就是必须有一个固定的模板文档是.ftl类型

如果初始文件为

 需要手动改为：

 也就是所有需要替换的地方，都需要有${XX}替换。

 

主要步骤为：

  1. 将 word 中需要填充的数据用占位符${变量名}替换。
  2. 将该 word 另存为 .xml 的格式，并检查看格式是否有误（主要看占位符有没被分割开来）。
  3. 将后缀.xml改成.ftl后，再调用相关 API 即可生成 word 文档。

特别注意，一定是将word另存为xml格式，而不是在外面修改后缀，不然会乱码。

其次一定要在xml或者ftl格式下检查格式，查询${XX}是否正确，看是否有占位符被分隔开的情况，如果有，只需将中间多余的部分删除即可。

处理普通文本
处理文本比较简单，在原文件中直接用占位符 ${} 替换即可。

处理表格
处在生成 word 表格时，FreeMarker 是利用列表一行一行循环填充的，而表头只会生成一次，因此我们还需手动改动一下 .ftl 文件。

注意：<w:tbl> 表示一个表格 、<w: tr> 表示一行、<w: tc> 表示一列，我们先找到第一行填充数据的那行，在前后分别加上如下语句即可：
 

<#list itemList as item>
</#list>

在这里插入图片描述

 

另一种情况：还有一种情况，即需要进行单元格的合并操作，前面和上面都差不多，不过还要加上另一种标签：

<w:vmerge w:val='restart'/>
<w:vmerge/>

我们先用 ${item.startMerge}（开始合并）和 ${item.endMerge}（结束合并）分别替换上面2行。

我们可以看到第一列分组是有合并单元格存在的，因此，找到第一列的 <w: tc> 那，如下图所示：

在这里插入图片描述 

 

1.导入相关依赖

我们主要用到了 FreeMarker，在这里，只需要导入以下依赖即可：

 <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>

2.生成 word 的工具类

此方法将生成的文档传到前端；


import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.Version;import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.*;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.Map;public class WordUtils {/*** 生成 word 文档方法** @param dataMap      要填充的数据* @param templateName 模版名称* @param fileName     要输出的文件路径* @throws Exception 抛出的异常*/public static void generateWord(HttpServletResponse response,Map<String, Object> dataMap, String templateName, String fileName) throws Exception {// 设置FreeMarker的版本和编码格式Configuration configuration = new Configuration(new Version("2.3.28"));configuration.setDefaultEncoding("UTF-8");// 设置FreeMarker生成Word文档所需要的模板的路径// configuration.setDirectoryForTemplateLoading(new File("/Users/xxx/Desktop/"));// 此处把模版文件都放在 resources 下的 templates 中configuration.setClassForTemplateLoading(WordUtils.class, "/templates");// 设置FreeMarker生成Word文档所需要的模板Template tem = configuration.getTemplate(templateName, "UTF-8");// 创建一个Word文档的输出流
//        Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(new File(fileName)), StandardCharsets.UTF_8));
//         FreeMarker使用Word模板和数据生成Word文档
//        response.setCharacterEncoding("UTF-8");response.setContentType("multipart/form-data");
//        response.setHeader("content-type", "application/octet-stream");
//        response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8"));response.setCharacterEncoding("utf-8");response.setContentType("applicaiton/msword");
//        response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".docx");response.addHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode(fileName, "UTF-8"));PrintWriter writer = response.getWriter();//tem.process(dataMap,new FileWriter("C:\\Users\\14017\\Desktop\\word.docx"));tem.process(dataMap, writer);writer.close();//tem.process(dataMap,response.getWriter());
//        writer.flush();
//        writer.close();
//        tem.process(dataMap,out);
//        out.flush();
//        out.close();}
}

此方法是将生成的文档存储到固定位置--目前在桌面

package com.iwiti.qcc.manage;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.Version;import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.*;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.Map;public class WordUtils {/*** 生成 word 文档方法** @param dataMap      要填充的数据* @param templateName 模版名称* @param fileName     要输出的文件路径* @throws Exception 抛出的异常*/public static void generateWord(HttpServletResponse response,Map<String, Object> dataMap, String templateName, String fileName) throws Exception {// 设置FreeMarker的版本和编码格式Configuration configuration = new Configuration(new Version("2.3.28"));configuration.setDefaultEncoding("UTF-8");// 设置FreeMarker生成Word文档所需要的模板的路径// configuration.setDirectoryForTemplateLoading(new File("/Users/xxx/Desktop/"));// 此处把模版文件都放在 resources 下的 templates 中configuration.setClassForTemplateLoading(WordUtils.class, "/templates");// 设置FreeMarker生成Word文档所需要的模板Template tem = configuration.getTemplate(templateName, "UTF-8");// 创建一个Word文档的输出流
//        Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(new File(fileName)), StandardCharsets.UTF_8));
//         FreeMarker使用Word模板和数据生成Word文档
//        response.setCharacterEncoding("UTF-8");response.setContentType("multipart/form-data");
//        response.setHeader("content-type", "application/octet-stream");
//        response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8"));//        response.setCharacterEncoding("utf-8");
//        response.setContentType("applicaiton/msword");response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".docx");
//        response.addHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode(fileName, "UTF-8"));
//        PrintWriter writer = response.getWriter();tem.process(dataMap,new FileWriter("C:\\Users\\14017\\Desktop\\word.docx"));
//        tem.process(dataMap, writer);
//        writer.close();//tem.process(dataMap,response.getWriter());
//        writer.flush();
//        writer.close();
//        tem.process(dataMap,out);
//        out.flush();
//        out.close();}
}

3.准备填充所需的数据

一般来说，我们的数据可能是从数据库中查询出来的各种对象，这里为了方便，就直接利用 HashMap 存储数据了。

 public static Map<String,Object> initData(){// 对应单元格的合并final String startMerge = "<w:vmerge w:val='restart'/>";final String endMerge = "<w:vmerge/>";final LocalDate nowDate = LocalDate.now();Map<String, Object> data = new HashMap<>();data.put("name", "张三");data.put("dept", "办公室");data.put("time", nowDate);List<Item> itemList = new ArrayList<>();Item item1 = new Item();item1.setProject("分组A").setProjectDetail.setTime("2-13").setProjectDetail.setPeople("小米")..setProjectDetail.setAddress("北京").setStartMerge(startMerge);itemList.add(item1);Item item2 = new Item();item2.setProject("分组A").setProjectDetail.setTime("2-13").setProjectDetail.setPeople("小米")..setProjectDetail.setAddress("北京").setEndMerge(endMerge);itemList.add(item2);ProjectItem item3 = new Item();item3.setProject("分组B").setProjectDetail.setTime("2-13").setProjectDetail.setPeople("小米")..setProjectDetail.setAddress("北京")itemList.add(item3);data.put("itemList", itemList);return data;}

注意的是表格的map的value是实体类，且这个实体类还有一个实体类嵌套，其次在修改模板是，将itemList  as item, 所以占位符就是${item.project}与${item.projectDetail.time}

4.生成 word 文档

 

         String templateName = QCC_TEMPLATE_WORD;String fileName = DateUtil.format(new Date(), "yyyyMMddHH") + QCC__WORD ;WordUtils.generateWord(response,data, templateName, fileName);//Qcc模板文件public static final String QCC_TEMPLATE_WORD = "QccTemplate.ftl";//Qcc生成文件名public static final String QCC__WORD = "QCC_REPORT.docx";

http://www.lryc.cn/news/8782.html

相关文章：

  • 前端必学的CSS制作Switch动画开关按钮演示
  • C语言运算符（左值右值，基本运算符）
  • 【自学Python】一文读懂Python字符串是否是数字
  • 【PTA Advanced】1146 Topological Order（C++）
  • 基于stm32mp157的嵌入式linux+qt项目实战物联网毕业设计选题之智慧医疗项目
  • Java实现邮件发送功能
  • springboot+vue简单对接支付宝完整流程
  • Map 查找表
  • python--石头剪刀布游戏（列表）
  • Project Caliper：目标是打造最佳VR手柄
  • 自动驾驶：BEV开山之作LSS（lift,splat,shoot）原理代码串讲
  • C# 如何实现对“属性”的扩展
  • EBS 物料属性 先后台对应关系 MTL_SYSTEM_ITEMS_B
  • MYSQL数据库-主从复制(原理及搭建）
  • 3GPP-NR Band25标准定义频点和信道（3GPP V17.7.0 (2022-12)）
  • 微信小程序 之 原生开发
  • 常用vim命令和vim基本使用及Linux用户的管理，用户和组相关文件
  • 阿里云服务器部署前后端分离项目
  • 内核经典数据结构list 剖析
  • 华为OD机试 - 考优选核酸检测点（Python）| 真题+思路+考点+代码+岗位
  • 在魔改PLUS-F5280开发板上使用合封qsp iflash
  • uni-app 瀑布流
  • 华为OD机试 - 去除多余空格（Python）| 真题+思路+考点+代码+岗位
  • MyBatis 二级缓存简单使用步骤
  • kubeadmin kube-apiserver Exited 始终起不来查因记录
  • 论文投稿指南——中文核心期刊推荐（工程材料学）
  • 【动态规划】背包问题题型及方法归纳
  • 全球十大资质正规外汇期货平台排行榜（最新版汇总）
  • 使用Paramiko时遇到的一些问题
  • 数据预处理（无量纲化、缺失值、分类特征、连续特征）