Aspose导出word使用记录

背景:Aspose系列的控件,功能实现都比较强大,可以实现多样化的报表设计及输出。
通过这次业务机会,锂宝碳审核中业务功需要实现Word文档表格的动态导出功能,因此学习了相关内容,在学习和参考了官方API文档的帮助下,将学习和简单的使用记录在wiki中。下面由我来简单介绍这个控件在实际业务中的使用过程。

一、开发前准备

1. 问题产生: 在实际的开发过程中会遇到Aspose依赖无法导入的情况,如下图所示
在这里插入图片描述

2. 原因分析: 主要原因是因为Maven的pom配置中使用的是阿里的镜像源,而阿里云镜像无法下载aspose依赖

3. 解决方法:
(1)先将 aspose的jar包 下载到本地,然后添加到本地的maven,再上传到公司的仓库(文档选择了第一种方式)
(2)提供aspose的仓库地址,将仓库地址加入nexusjar包下载地址
在这里插入图片描述

4. 方法步骤:
(1)在配置好后创建项目后,在配置文件需要引用依赖,可以选择本地依赖,而本地依赖需要导入, 所以就需要进行jar包的导入
在这里插入图片描述

(2)导入包的语句:

mvn install:install-file "-Dfile=D:\software\Jar\aspose-words-15.12.0-jdk16.jar" "-DgroupId=com.aspose" "-DartifactId=aspose-words" "-Dversion=15.12.0" "-Dpackaging=jar"

(3)解释一下这些参数意思:

-Dfile: jar包所在本地的绝对路径

-DgroupId: 在导入包后会在本地仓库创建一个com.aspose的路径,包就会存放在jar里面

-DartifactId=spring: jar包的名字

-Dversion: jar包的版本

-Dpackaging: 导入包的类型
在这里插入图片描述

(4)进入cmd运行上面的命令:显示如下即加入成功!这就是Maven的下载和在IDEA的配置以及jar包的导入
在这里插入图片描述

二、word表格的基本操作

1. 建立word模板

(1)在word文档中,在菜单栏中依次点击 插入 ->
(2)接着在弹出框中选择 邮件合并 域,在域属性中填写域名,该域名即为变量名,填写完毕后点击 确定 即可
在这里插入图片描述

(3)生成如图所示的样式,即为添加成功
在这里插入图片描述

2. 定义集合变量

当单一变量无法满足需求后,我们就需要定义集合变量,我就拿员工薪资统计来举例,一个表格里面会有多个数据。此时,我们应该插入List数据到模板文件中

(1)模板关键字:TableStart:集合名称TableEnd:集合名称
(2)同样的,在域中选择邮件合并,域名要用TableStart打头,紧接冒号:,再然后就是定义集合的名称。需要注意的是,TableStart意为集合的开始,所以我们再集合结束的地方,需要添加结束标识TableEnd
(3)TableStartTableEnd 之间的变量,就是集合中每个属性的变量名称
(4)添加完毕之后,如图所示,模板 也可点击这里下载(5vy5)
在这里插入图片描述

3. 员工薪资数据插入Demo案例

3.1 导入工具类

package org.example;import com.aspose.words.*;
import com.aspose.words.net.System.Data.DataRow;
import com.aspose.words.net.System.Data.DataTable;
import org.springframework.util.CollectionUtils;
import org.springframework.util.StringUtils;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.IntrospectionException;
import java.beans.PropertyDescriptor;
import java.io.*;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.HashMap;
import java.util.List;
import java.util.Map;/*** @author fangxiang* @date 2023/7/7 13:46*/
public class ContractUtil {private ContractUtil() {}/*** 调整图片的大小格式属性** @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());} else if (flag && sx <= sy) {sy = sx;targetH = (int) (sy * source.getHeight());}// 创建目标BufferedImageif (type == BufferedImage.TYPE_CUSTOM) {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模板** @param modelWordByte Word模板的二进制数据* @param obj           要填充的数据对象* @return 填充数据后的Word二进制数据*/public static byte[] fillWordDataByDomain(byte[] modelWordByte, Object obj) {try {// 获取对象的ClassClass<?> aClass = obj.getClass();// 获取对象的所有字段Field[] fields = aClass.getDeclaredFields();// 创建一个Map来存储字段名和字段值Map<String, Object> data = new HashMap<>(fields.length);// 遍历字段,获取字段值并存入Map中for (Field field : fields) {// 获取字段的属性描述器PropertyDescriptor pd = new PropertyDescriptor(field.getName(), aClass);// 获取字段的读取方法Method method = pd.getReadMethod();// 获取字段名String key = field.getName();// 调用读取方法获取字段值Object value = method.invoke(obj);// 如果字段值不为空,则将字段名和字段值存入Map中if (value != null) {data.put(key, value);}}// 使用Map数据填充Word模板并返回填充后的Word二进制数据return fillWordDataByBinary(modelWordByte, data);} catch (Exception e) {// 出现异常时返回空的字节数组return new byte[0];}}/*** 填充 word 模板(map数据格式)** @param file word二进制* @param data 要填充的数据* @return 组合数据之后的word二进制*/public static byte[] fillWordDataByBinary(byte[] file, Map<String, Object> data) throws Exception {byte[] ret = null;if (CollectionUtils.isEmpty(data)) {return ret;}try (InputStream is = new ByteArrayInputStream(file);ByteArrayOutputStream out = new ByteArrayOutputStream()) {// 读取Word文档Document doc = new Document(is);// 用于存储需要替换的字段和对应的值Map<String, String> toData = new HashMap<>();// 遍历数据Mapfor (Map.Entry<String, Object> en : data.entrySet()) {String key = en.getKey();Object value = en.getValue();// 如果值是List类型,则填充表格数据if (value instanceof List) {//写入表数据DataTable dataTable = fillListData((List) value, key);doc.getMailMerge().executeWithRegions(dataTable);}String valueStr = String.valueOf(en.getValue());// 如果值为空或者为字符串"null",则跳过该字段if (StringUtils.isEmpty(value)) {continue;}// 将字段和值存入toDatatoData.put(key, valueStr);}// 将toData中的字段和值分别存入两个数组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;}/*** 封装 list 数据到 word 模板中(word表格)** @param list      数据* @param tableName 表格列表变量名称* @return word表格数据DataTable*/private static DataTable fillListData(List<Object> list, String tableName) throws IntrospectionException, InvocationTargetException, IllegalAccessException {//创建DataTable,并绑定字段DataTable dataTable = new DataTable(tableName);// 遍历 list 中的每个对象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 的列中dataTable.getColumns().add(fields[i].getName());// 通过反射获取字段的值,并将其设置到 dataRow 中PropertyDescriptor pd = new PropertyDescriptor(field.getName(), objClass);Method method = pd.getReadMethod();dataRow.set(i, method.invoke(obj));}// 将 dataRow 添加到 dataTable 的行中dataTable.getRows().add(dataRow);}return dataTable;}/*** 利用反射将字段转为Map键值对** @param obj* @return* @throws IntrospectionException* @throws IllegalAccessException* @throws InvocationTargetException*/public static Map<String, Object> getStringObjectMap(Object obj) throws IntrospectionException, IllegalAccessException, InvocationTargetException {Class<?> aClass = obj.getClass();Field[] fields = aClass.getDeclaredFields();Map<String, Object> data = new HashMap<>(fields.length);// 遍历对象的所有属性for (Field field : fields) {// 获取属性的名称String fieldName = field.getName();// 创建属性描述器,用于获取属性的读取方法PropertyDescriptor pd = new PropertyDescriptor(fieldName, aClass);// 获取属性的读取方法Method method = pd.getReadMethod();// 获取属性的值Object value = method.invoke(obj);// 如果属性的值不为空,则将属性名和属性值添加到Map中if (value != null) {data.put(fieldName, value);}}return data;}/*** 通过Map的方式填充word模板** @param templatePath* @param targetPath* @param data* @param fileType*/public static void fillWordDataByMap(String templatePath, String targetPath, Map<String, Object> data, int fileType) {try (InputStream is = new FileInputStream(templatePath);OutputStream out = new FileOutputStream(targetPath)) {// 加载模板文件Document doc = new Document(is);DocumentBuilder builder = new DocumentBuilder(doc);Map<String, String> toData = new HashMap<>();// 遍历数据,填充模板for (Map.Entry<String, Object> en : data.entrySet()) {String key = en.getKey();Object value = en.getValue();if (key == null || value == null) {continue;}if (value instanceof List) {// 填充表格数据DataTable dataTable = fillListData((List) value, key);doc.getMailMerge().executeWithRegions(dataTable);}if (value instanceof BufferedImage) {// 填充图像数据builder.moveToMergeField(key);builder.insertImage((BufferedImage) value);}String valueStr = String.valueOf(en.getValue());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(fileType));} catch (Exception e) {throw new RuntimeException(e);}}//    private static License license = null;//    /**
//     * 加载 license
//     * 由于 aspose是商业组件,若没有license(可自行在网上查询license.xml),则会出现水印。
//     */
//    static {
//        try {
//            InputStream is = ContractUtil.class.getResourceAsStream("/license.xml");
//            license = new License();
//            license.setLicense(is);
//        } catch (Exception e) {
//            throw new RuntimeException("自动加载aspose证书文件失败!");
//        }
//    }}

3.2 创建实体Bean

(1)首先,我们先定义和模板对应的数据,我们先定义列表里面的 员工薪资信息中 Worker 的数据

package VO;import lombok.Data;
import lombok.AllArgsConstructor;
import lombok.Builder;
import java.math.BigDecimal;
import java.util.List;/*** 员工薪资信息** @author fangxiang* @date 2023/7/7 13:47*/
@Data
@Builder
@AllArgsConstructor
public class Worker {/*** 员工姓名*/private String name;/*** 年龄*/private Integer age;/*** 性别*/private String sex;/*** 工资*/private BigDecimal salary;
}

(2)接着我们定义整个模板的基本数据:SalaryData

package VO;import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.awt.image.BufferedImage;
import java.math.BigDecimal;
import java.util.List;/*** 文档模板数据** @author fangxiang* @date 2023/7/7 13:46*/
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class SalaryData {/*** 公司名称*/private String companyName;/*** 员工薪资列表*/private List<Worker> workerList;/*** 工资总和*/private BigDecimal totalSalary;/*** 公司log*/private BufferedImage logImg;
}

(3)定义好以上数据之后,我们就可以开始进行数据的填充,工具类提供两种填充方法(代码案例是在本地执行的,所以记得替换本地的图片和文件地址)

1.一种是传递 Object 数据进行数据填充
2.另一种是传递 Map 数据进行数据填充
这里采用第一种方式进行数据的填充,个人也比较推荐使用domain数据

package org.example;import VO.SalaryData;
import VO.Worker;
import com.aspose.words.SaveFormat;import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.beans.IntrospectionException;
import java.io.FileInputStream;
import java.io.IOException;
import java.lang.reflect.InvocationTargetException;
import java.math.BigDecimal;
import java.util.Arrays;
import java.util.List;
import java.util.Map;/**** @author fangxiang* @date 2023/7/7 13:47* */
public class Test {public static void main(String[] args) throws IOException, IntrospectionException, InvocationTargetException, IllegalAccessException {// 封装员工薪资信息Worker worker1 = Worker.builder().name("李雄").age(25).sex("男").salary(BigDecimal.valueOf(1000)).build();Worker worker2 = Worker.builder().name("李浩").age(25).sex("男").salary(BigDecimal.valueOf(2000)).build();List<Worker> workerList = Arrays.asList(worker1, worker2);// 计算工资总和BigDecimal totalSalary = workerList.stream().map(Worker::getSalary).reduce(BigDecimal.ZERO, BigDecimal::add);// 读取图片BufferedImage image = ImageIO.read(new FileInputStream("C:\\Users\\fangxiang\\Desktop\\鱼.png"));BufferedImage bufferedImage = ContractUtil.resizeBufferedImage(image, 100, 100, true);// 封装文档模板数据SalaryData data = SalaryData.builder().companyName("上班不摸鱼有限公司").workerList(workerList).totalSalary(totalSalary).logImg(bufferedImage).build();// 读取模板文件Map<String, Object> dataMap = ContractUtil.getStringObjectMap(data);String templatePath2 = "C:\\Users\\fangxiang\\Desktop\\模板.docx";String docxPath = "C:\\Users\\fangxiang\\Desktop\\员工薪资统计表.docx";ContractUtil.fillWordDataByMap(templatePath2, docxPath, dataMap, SaveFormat.DOCX);}
}

3.3 结果展示

![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

(1)水印说明
看上方的图相比大家也不难发现,文档生成的同时,也多了红色的一串字体。
由于aspose是商业组件的,所以想要去水印使用,需要添加 license.xml,由于实际业务中使用的是公司提供的凭证,所以我就不传上来了,如有需要,可以选择购买 aspose 的服务,或者上网搜一个 license.xml

(2)如何添加 license
我已经在工具类中提供了一个静态初始化方法,大家下载好 license.xml 之后,放入对应的目录,将注释部分去掉即可

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/65891.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

C#知识点、常见面试题

相关源码 https://github.com/JackYan666/CSharpCode/blob/main/CSharpCode.cs 0.简要概括 1.删除集合元素 1.For循环删除集合元素:从后面往前删除 从前往后删,有可能不能完全删除 #region 01.For循环删除集合元素void Test01_ForDelListElement(){//错误代码 虽然可以跑…

iSCSI存储服务器

目录 一、ISCSI是什么&#xff1f; 二、ISCSI产生背景 三、存储分类 四、ISCSI架构 五、ISCSI存储服务搭建案例 一、ISCSI是什么&#xff1f; ISCSI名为互联网小型计算机系统接口又称为IP-SAN&#xff0c;是一种新的远程存储技术&#xff0c;提供存储服务的目标服务器默认使用的…

【C++】学习STL中的stack和queue

❤️前言 今天这篇博客的内容主要关于STL中的stack、queue和priority_queue三种容器。 正文 stack和queue的使用方式非常简单&#xff0c;我们只要根据之前学习数据结构的经验和文档介绍就可以轻松上手。于是我们直接开始对它们的模拟实现。 stack和queue的模拟实现 stack和q…

大数据HBase学习圣经:一本书实现HBase学习自由

学习目标&#xff1a;三栖合一架构师 本文是《大数据HBase学习圣经》 V1版本&#xff0c;是 《尼恩 大数据 面试宝典》姊妹篇。 这里特别说明一下&#xff1a;《尼恩 大数据 面试宝典》5个专题 PDF 自首次发布以来&#xff0c; 已经汇集了 好几百题&#xff0c;大量的大厂面试…

实际并行workers数量不等于postgresql.conf中设置的max_parallel_workers_per_gather数量

1 前言 本文件的源码来自PostgreSQL 14.5&#xff0c;其它版本略有不同并行workers并不能显箸提升性能。个人不建议使用并行worker进程&#xff0c;大多数情况下采用postgresql.conf默认配置即可。 PostgreSQL的并行workers是由compute_parallel_worker函数决定的&#xff0c…

Java-Optional类

概述 Optional是JAVA 8引入的一个类&#xff0c;用于处理可能为null的值。 利用Optional可以减少代码中if-else的判断逻辑&#xff0c;增加代码的可读性。且可以减少空指针异常的发生&#xff0c;增加代码的安全性。 常用的方法 示例 代码 public class OptionalTest {pub…

[深度学习]大模型训练之框架篇--DeepSpeed使用

现在的模型越来越大&#xff0c;动辄几B甚至几百B。但是显卡显存大小根本无法支撑训练推理。例如&#xff0c;一块RTX2090的10G显存&#xff0c;光把模型加载上去&#xff0c;就会OOM&#xff0c;更别提后面的训练优化。 作为传统pytorch Dataparallel的一种替代&#xff0c;D…

基于java+springboot+vue的交流互动系统-lw

​ 系统介绍&#xff1a; 随着现在网络的快速发展&#xff0c;网上管理系统也逐渐快速发展起来&#xff0c;网上管理模式很快融入到了许多企业的之中&#xff0c;随之就产生了“交流互动系统”&#xff0c;这样就让交流互动系统更加方便简单。 对于本交流互动系统的设计来说&a…

继承【C++】

文章目录 继承的概念继承的定义继承方式和访问限定符继承基类成员访问方式的变化 默认继承方式 基类和派生类对象赋值转换继承中的作用域派生类的默认成员函数继承与友元静态成员菱形继承及菱形虚拟继承继承的方式 菱形虚拟继承菱形虚拟继承原理 继承的概念 继承(inheritance)…

【Unity笔记】TimeLine的详细使用介绍

文章目录 前言素材一、timeline基础介绍1. 打开timeline轨道面板2. 创建TimeLine轨道3. Timeline常用轨道4. 修改Timeline单位5. 锁定界面 二、timeline的通用轨道使用三、Cinemeachine虚拟相机结合Timeline实现场景移动四、DialogueTrack&#xff1a;自定义的对话轨道(自己编写…

swagger 接口测试,用 python 写自动化时该如何处理?

在使用Python进行Swagger接口测试时&#xff0c;可以使用requests库来发送HTTP请求&#xff0c;并使用json库和yaml库来处理响应数据。以下是一个简单的示例代码&#xff1a; import requests import json import yaml# Swagger API文档地址和需要测试的接口路径 swagger_url …

设计模式之原型模式

文章目录 概述克隆羊问题传统方式解决克隆羊问题传统的方式的优缺点原型模式原理结构图-uml 类图原理结构图说明 原型模式解决克隆羊问题的应用实例原型模式在Spring框架中的应用深入讨论-浅拷贝和深拷贝浅拷贝的介绍深拷贝基本介绍深拷贝应用实例注意事项 概述 原型模式&…

Linux - Docker 安装使用 常用命令 教程

Docker 官方文档地址: Get Started | Docker 中文参考手册: https://docker_practice.gitee.io/zh-cn/ 1.什么是 Docker 1.1 官方定义 最新官网首页 # 1.官方介绍 - We have a complete container solution for you - no matter who you are and where you are on your contain…

Linux学习之NAS服务器搭建

NAS是Network Attached Storage的缩写&#xff0c;也就是网络附属存储。可以使用自己已经不怎么使用的笔记本搭建一台NAS服务器。 fdisk -l可以看一下各个磁盘的状态。 可以看到有sda、sdb、sdc和sdd等四块硬盘。 lvs、vgs和pvs结合起来看&#xff0c;sdb和sdc没有被使用。 …

Mac“其他文件”存放着什么?“其他文件”的清理方法

很多Mac用户在清理磁盘空间时发现&#xff0c;内存占用比例比较大的除了有iCloud云盘、应用程序、影片、音频、照片等项目之外&#xff0c;还有一个“其他文件”的项目磁盘占用比也非常大&#xff0c;想要清理却无从下手。那么Mac“其他文件”里存放的是什么文件&#xff1f;我…

文本标注技术方案(NLP标注工具)

Doccano doccano 是一个面向人类的开源文本注释工具。它为文本分类、序列标记和序列到序列任务提供注释功能。您可以创建用于情感分析、命名实体识别、文本摘要等的标记数据。只需创建一个项目&#xff0c;上传数据&#xff0c;然后开始注释。您可以在数小时内构建数据集。 支持…

并发下的Map常见面试题

HashMap 和 HashTable 有什么区别&#xff1f;java中的另一个线程安全的与HashMap极其类似的类是什么&#xff1f;同样是线程安全&#xff0c;它与HashTable在线程同步上有什么不同&#xff1f;HashMap 与 ConcurrentHashMap的区别&#xff1f;为什么 ConcurrentHashMap 比 Has…

开源且强大的网络嗅探分析工具——Wireshark

Wireshark是一款强大的开源网络协议分析工具&#xff0c;旨在帮助用户深入了解网络通信的细节。通过捕获、解析和展示网络数据包&#xff0c;Wireshark能够帮助工程师诊断问题、优化性能&#xff0c;以及解决各种网络难题。无论是深入分析还是快速调试&#xff0c;Wireshark都是…

封装(个人学习笔记黑马学习)

1、格式 #include <iostream> using namespace std;const double PI 3.14;//设计一个圆类&#xff0c;求圆的周长 class Circle {//访问权限//公共权限 public://属性//半径int m_r;//行为//获取圆的周长double calculateZC() {return 2 * PI * m_r;} };int main() {//通…

QT day1登录界面设计

要设计如下图片&#xff1a; 代码如下&#xff1a; main.cpp widget.h widget.cpp 运行效果&#xff1a; 2&#xff0c;思维导图