Java填充Word模板

Ne0inhk

— 8 min read

文章目录

前言

最近有个Java填充Word模板的需求，包括文本，列表和复选框勾选，写一个工具类，以此记录。

提示：以下是本篇文章正文内容，下面案例可供参考

一、设置word模板

选择文档中要填充的地方点击->选择插入->文档部件->域->域名(mergeFeild)->填写变量名称.

普通字段

在这里插入图片描述


在这里插入图片描述


填充完毕：

在这里插入图片描述

列表字段

操作和普通字段一样，区别是需要在首行第一列插入列表开始域，首行最后一列插入结束域，中间正常字段。格式为：StartTable:<数组字段名>，EndTable:<数组字段名>

在这里插入图片描述

复选框

复选框找了好多种方法尝试没有成功，最后取巧，和普通字段一样设置占位符，通过代码逻辑处理.

在这里插入图片描述

二、代码

1. 引入POM

poi/hutool/aspose-words/gson：

<!-- hutool工具类 --><dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.7.14</version></dependency><!--word模板数据解析--><dependency><groupId>com.deepoove</groupId><artifactId>poi-tl</artifactId><version>1.9.0-beta</version></dependency><!-- word/pdf操作 --><dependency><groupId>com.aspose</groupId><artifactId>aspose-words</artifactId><version>18.8</version></dependency><dependency><groupId>com.google.code.gson</groupId><artifactId>gson</artifactId><version>2.8.9</version></dependency>

2. 模板放入项目

这里是放在项目里，也可以放在云上存储。

在这里插入图片描述


破解文件放入resouce,否则会有水印,aspose-words在maven仓库中也没有，需要下载后安装在本地仓库。

安装命令

mvn install:install-file -Dfile=路径/aspose-words-18.8.jar -DgroupId=com.aspose -DartifactId=aspose-words -Dversion=18.8-Dpackaging=jar

引入破解文件

在这里插入图片描述
<License><Data><Products><Product>Aspose.Total for Java</Product><Product>Aspose.Words for Java</Product></Products><EditionType>Enterprise</EditionType><SubscriptionExpiry>20991231</SubscriptionExpiry><LicenseExpiry>20991231</LicenseExpiry><SerialNumber>8bfe198c-7f0c-4ef8-8ff0-acc3237bf0d7</SerialNumber></Data><Signature>sNLLKGMUdF0r8O1kKilWAGdgfs2BvJb/2Xp8p5iuDVfZXmhppo+d0Ran1P9TKdjV4ABwAgKXxJ3jcQTqE/2IRfqwnPf8itN8aFZlV3TJPYeD3yWE7IT55Gz6EijUpC7aKeoohTb4w2fpox58wWoF3SNp6sK6jDfiAUGEHYJ9pjU=</Signature></License>

jar包和license下载地址

3.代码

实体类

 import lombok.AllArgsConstructor; import lombok.Data; import lombok.NoArgsConstructor; import java.io.Serializable; import java.util.Arrays; import java.util.List; @Data @AllArgsConstructor @NoArgsConstructor public class FillWordDTO implements Serializable { private String name; private String age; private String yuyan; private String yingyu; private String deyu; private String fayu; private String zhengshu; private String yiji; private String erji; private List<ExperienceList> experienceList; public static FillWordDTO create(){ FillWordDTO fillWordDTO = new FillWordDTO(); fillWordDTO.setName("小王"); fillWordDTO.setAge("18"); fillWordDTO.setYuyan("☑"); fillWordDTO.setYingyu("☑"); fillWordDTO.setDeyu("□"); fillWordDTO.setFayu("☑"); fillWordDTO.setZhengshu("☑"); fillWordDTO.setYiji("☑"); fillWordDTO.setErji("□"); fillWordDTO.setExperienceList(Arrays.asList( new ExperienceList("小王","2020-01-01","2020-01-01","小王"), new ExperienceList("小王","2020-01-01","2020-01-01","小王")));return fillWordDTO;}} @Data @AllArgsConstructor @NoArgsConstructor class ExperienceList { private String school; private String startTime; private String endTime; private String remark;}

工具类

 import com.aspose.words.*; import com.aspose.words.net.System.Data.DataRow; import com.aspose.words.net.System.Data.DataTable; import java.awt.*; import java.awt.geom.AffineTransform; import java.awt.image.BufferedImage; import java.awt.image.ColorModel; import java.awt.image.WritableRaster; import java.beans.PropertyDescriptor; import java.io.*; import java.lang.reflect.Field; import java.lang.reflect.Method; import java.util.HashMap; import java.util.List; import java.util.Map; public class ContractUtil { private ContractUtil(){}/** * 调整bufferedimage大小 * @param source BufferedImage 原始image * @param targetW int 目标宽 * @param targetH int 目标高 * @param flag boolean 是否同比例调整 * @return BufferedImage 返回新image */ public static BufferedImage resizeBufferedImage(BufferedImage source,int targetW,int targetH, boolean flag){int type = source.getType(); BufferedImage target = null;double sx =(double) targetW / source.getWidth();double sy =(double) targetH / source.getHeight();if(flag && sx > sy){ sx = sy; targetW =(int)(sx * source.getWidth());}elseif(flag && sx <= sy){ sy = sx; targetH =(int)(sy * source.getHeight());}if(type == BufferedImage.TYPE_CUSTOM){// handmade ColorModel cm = source.getColorModel(); WritableRaster raster = cm.createCompatibleWritableRaster(targetW, targetH); boolean alphaPremultiplied = cm.isAlphaPremultiplied(); target = new BufferedImage(cm, raster, alphaPremultiplied, null);}else{ target = new BufferedImage(targetW, targetH, type);} Graphics2D g = target.createGraphics(); g.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY); g.drawRenderedImage(source, AffineTransform.getScaleInstance(sx, sy)); g.dispose();return target;}/** * 填充 word 模板（object数据格式） * * @param modelWordByte word模版二进制文件 * @param obj 要填充的数据 * @return 组合数据之后的word二进制 */ public static byte[]fillWordDataByDomain(byte[] modelWordByte, Object obj){ try { Class<?> aClass = obj.getClass(); Field[] fields = aClass.getDeclaredFields(); Map<String, Object> data = new HashMap<>(fields.length);for(Field field : fields){ PropertyDescriptor pd = new PropertyDescriptor(field.getName(), aClass); Method method = pd.getReadMethod(); String key = field.getName(); Object value = method.invoke(obj);if(value != null){ data.put(key, value);}}returnfillWordDataByMap(modelWordByte, data);}catch(Exception e){ e.printStackTrace();return new byte[0];}}/** * 填充 word 模板（map数据格式） * * @param file word二进制 * @param data 要填充的数据 * @return 组合数据之后的word二进制 */ public static byte[]fillWordDataByMap(byte[] file, Map<String, Object> data) throws Exception { byte[] ret = null;if(data == null || data.isEmpty()){return ret;}try(InputStream is = new ByteArrayInputStream(file); ByteArrayOutputStream out = new ByteArrayOutputStream()){ Document doc = new Document(is); DocumentBuilder builder = new DocumentBuilder(doc); Map<String, String> toData = new HashMap<>();for(Map.Entry<String, Object> entry : data.entrySet()){ String key = entry.getKey(); Object value = entry.getValue();// 处理表格数据if(value instanceof List &&!key.equals("checkboxOptions")){ DataTable dataTable =fillListData((List) value, key, builder); doc.getMailMerge().executeWithRegions(dataTable);}// 图片插入elseif(value instanceof BufferedImage){ builder.moveToMergeField(key); builder.insertImage((BufferedImage) value);}// 其他普通字段正常填充else{ String valueStr = String.valueOf(value);if(value != null &&!"null".equals(valueStr)){ toData.put(key, valueStr);}}}// 执行普通字段合并 String[] fieldNames = new String[toData.size()]; String[] values = new String[toData.size()];int i =0;for(Map.Entry<String, String> entry : toData.entrySet()){ fieldNames[i]= entry.getKey(); values[i]= entry.getValue(); i++;} doc.getMailMerge().execute(fieldNames, values); doc.save(out, SaveOptions.createSaveOptions(SaveFormat.DOCX)); ret = out.toByteArray();}return ret;}/** * 勾选段落中的复选框字段（适用于 Aspose.Words 18.8） */ private staticvoidcheckTheCheckbox(Paragraph paragraph) throws Exception { FieldCollection fields = paragraph.getRange().getFields();int count = fields.getCount();for(int i =0; i < count; i++){ com.aspose.words.Field field = fields.get(i);if(field.getType()== FieldType.FIELD_FORM_CHECK_BOX){// 设置字段结果为 "✓" 表示勾选（或根据模板实际显示字符调整）setCheckboxChecked(field, true);}}} private staticvoidsetCheckboxChecked(com.aspose.words.Field field, boolean checked) throws Exception {if(checked){ field.setResult("✓");// 根据模板中实际勾选状态设置}else{ field.setResult("□");// 可选：取消勾选}}/** * 封装 list 数据到 word 模板中（word表格） * * @param list 数据 * @param tableName 表格列表变量名称 * @return word表格数据DataTable */ private static DataTable fillListData(List<Object> list, String tableName, DocumentBuilder builder) throws Exception {//创建DataTable,并绑定字段 DataTable dataTable = new DataTable(tableName);for(Object obj : list){//创建DataRow，封装该行数据 DataRow dataRow = dataTable.newRow(); Class<?> objClass = obj.getClass(); Field[] fields = objClass.getDeclaredFields();for(int i =0; i < fields.length; i++){ Field field = fields[i]; dataTable.getColumns().add(fields[i].getName()); PropertyDescriptor pd = new PropertyDescriptor(field.getName(), objClass); Method method = pd.getReadMethod(); dataRow.set(i, method.invoke(obj));} dataTable.getRows().add(dataRow);}return dataTable;}// private static License license = null;/** * 加载 license * 由于 aspose是收费的，若没有 license，则会出现水印。 */static{ try { InputStream is = ContractUtil.class.getResourceAsStream("/License.xml"); License license = new License(); license.setLicense(is);}catch(Exception e){ throw new RuntimeException("自动加载aspose证书文件失败!");}}}

三、测试

main方法测试，可以根据实际需求改为response输出或者上传到存储服务器后返回链接地址。

 public staticvoidmain(String[] args) throws IOException { FillWordDTO fillWordDTO = FillWordDTO.create();// 读取模板文件 byte[] modelByte = Files.readAllBytes(Paths.get("E:\\project\\spring-demo\\src\\main\\resources\\templates\\test.docx"));// 调用工具类，获取填充数据后的文件 byte[] resultByte = ContractUtil.fillWordDataByDomain(modelByte, fillWordDTO);// 处理该二进制文件，此处处理为输出到桌面 File resultFile = new File("C:\\Users\\Lenovo\\Desktop\\demo.docx"); FileOutputStream fos = new FileOutputStream(resultFile); fos.write(resultByte); fos.close();}

四、运行结果

在这里插入图片描述

五、注意事项

在编辑word域代码时，有时会有隐藏的代码导致填充失败

Found end of mail merge region 'experienceList' that does not match start of mail merge region 'jlList'.

出现以上错误或者想查看域代码，按如下操作：

在word中依次点击「文件→选项→高级」，在「显示文档内容」区域勾选「显示域代码而非域值」，找到报错域代码后删除，重新添加域就解决了。

Read more

【Linux】Linux基本使用和程序部署

【Linux】Linux基本使用和程序部署

🎬 那我掉的头发算什么：个人主页 🔥 个人专栏: 《javaSE》《数据结构》《数据库》《javaEE》 ⛺️待到苦尽甘来日 文章目录 * Linux环境搭建 * 环境搭建方式 * 使用云服务器 * 使用终端软件连接到Linux * Linux常用命令 * ls * pwd * cd * touch * cat * mkdir * rm * cp * mv * tail * vim * grep * ps * netstat * 搭建java部署环境 * apt * JDK * MYSQL * 部署web项目到Linux * 什么是部署 * 环境配置 * 构建项目并打包 * 上传jar包运行程序 * 杀死进程 Linux环境搭建 环境搭建方式 主要有四种： 1. 直接安装在物理机上。但是 Linux 桌面使用起来非常不友好。所以不建议。【不推荐】。 2. 使用虚拟机软件，

By Ne0inhk

Flutter 三方库 super_dates 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、强类型、更优雅的 DateTime 增强与时间逻辑审计引擎

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 三方库 super_dates 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、强类型、更优雅的 DateTime 增强与时间逻辑审计引擎 在鸿蒙（OpenHarmony）系统的日程管理、精密任务调度（如鸿蒙版闹钟/日历）、理财工具或带有复杂时间区间（Periods）计算的应用中，如何摆脱标准 DateTime 库中那些模糊的整数偏移，转而使用语义明确、强类型保障的现代日期 API？super_dates 为开发者提供了一套工业级的、基于 Extension 的 DateTime 深度增强方案。本文将深入实战其在鸿蒙时间维度逻辑层中的应用。 前言 什么是 SuperDates？它不是一个替代 DateTime 的庞大框架，而是对 Dart 原生时间类的一次“极致外科手术级”

By Ne0inhk
Flutter 三方库 index_generator — 赋能鸿蒙大型项目自动化生成 Export 导出索引，消除繁琐 Import 片段工程化利器（适配鸿蒙 HarmonyOS Next ohos

Flutter 三方库 index_generator — 赋能鸿蒙大型项目自动化生成 Export 导出索引，消除繁琐 Import 片段工程化利器（适配鸿蒙 HarmonyOS Next ohos

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net。 Flutter 三方库 index_generator — 赋能鸿蒙大型项目自动化生成 Export 导出索引，消除繁琐 Import 片段的工程化利器（适配鸿蒙 HarmonyOS Next ohos） 前言 在华为鸿蒙（OpenHarmony）生态的深度开发中，随着业务组件和模型类的爆发式增长，开发者经常会陷入“Import 迷宫”。当你需要引用某个页面时，发现上方堆叠了数十行细碎的文件引用，这不仅影响代码的可读性，更让后续的重构工作（如移动目录）变得极其痛苦。 index_generator 是一款极其高效的命令行工具。它能根据你定义的配置文件，自动扫描指定目录并生成一个统一的“索引文件（Barrel File，通常为 index.dart）”，将目录下的所有组件一键导出。在构建鸿蒙平台的复杂多模块（Multi-module）工程、管理庞大的 UI

By Ne0inhk

【OpenClaw 安装教程：Windows/macOS/Linux 全平台保姆级指南】

前言 OpenClaw（俗称"小龙虾"）是一款开源的个人 AI 助手项目，由 PSPDFKit 创始人 Peter Steinberger 开发。与传统聊天 AI 不同，OpenClaw 不仅能回答问题，还能主动操作系统、访问网页、处理邮件、整理文件、发送消息等，真正实现"会动手干活的 AI"。 本文将详细介绍在 Windows、macOS 和 Linux 三大平台上安装 OpenClaw 的完整步骤，适合零基础用户快速上手。 一、安装前准备 1.1 系统要求 在开始安装之前，请确保你的电脑满足以下基本要求： 配置项最低要求推荐配置操作系统Windows 10/11、macOS

By Ne0inhk