专业网站优化制作公司,网站设计的几大标准,临沂天元建设集团,动漫制作专业必须会画画吗背景#xff1a;Aspose系列的控件#xff0c;功能实现都比较强大#xff0c;可以实现多样化的报表设计及输出。 通过这次业务机会#xff0c;锂宝碳审核中业务功需要实现Word文档表格的动态导出功能#xff0c;因此学习了相关内容#xff0c;在学习和参考了官方API文档的… 背景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 -DfileD:\software\Jar\aspose-words-15.12.0-jdk16.jar -DgroupIdcom.aspose -DartifactIdaspose-words -Dversion15.12.0 -Dpackagingjar3解释一下这些参数意思
-Dfile: jar包所在本地的绝对路径
-DgroupId 在导入包后会在本地仓库创建一个com.aspose的路径包就会存放在jar里面
-DartifactIdspring 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 3TableStart 和 TableEnd 之间的变量就是集合中每个属性的变量名称 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来存储字段名和字段值MapString, 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, MapString, 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);// 用于存储需要替换的字段和对应的值MapString, String toData new HashMap();// 遍历数据Mapfor (Map.EntryString, 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.EntryString, 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(ListObject 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 MapString, Object getStringObjectMap(Object obj) throws IntrospectionException, IllegalAccessException, InvocationTargetException {Class? aClass obj.getClass();Field[] fields aClass.getDeclaredFields();MapString, 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, MapString, 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);MapString, String toData new HashMap();// 遍历数据填充模板for (Map.EntryString, 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.EntryString, 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 ListWorker 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();ListWorker 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();// 读取模板文件MapString, 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 之后放入对应的目录将注释部分去掉即可
