Aspose填充word数据

本文介绍了如何使用aspose进行word文档的生成,并提供了工具类供参考。

有问题欢迎 call 微信:905369866,小弟尽力而为。。毕竟这玩意没吃透。

1. 建立一个word模板

1.1 定义单个变量

  1. 在word文档中,在菜单栏中依次点击插入->文档部件->
  2. 接着在弹出框中选择MergeField域,在域属性中填写域名,该域名即为变量名,填写完毕后点击确定即可;



    生成如图所示的样式,即为添加成功

1.2 定义集合变量

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

  1. 模板关键字:TableStart:集合名称TableEnd:集合名称
  2. 同样的,在文本域中选择MergeField,域名要用TableStart打头,紧接冒号:,再然后就是定义集合的名称。需要注意的是,TableStart意为集合的开始,所以我们再集合结束的地方,需要添加结束标识TableEnd
  3. TableStartTableEnd 之间的变量,就是集合中每个属性的变量名称。



    添加完毕之后,如图所示

1.3 定义图片变量

图片变量与单个变量一致。

Word模板书写到此结束

1.4 演示模板文档下载

点击此处下载演示文档

2. 入门使用

本人在公司里,合同这一块是起了一个微服务进行的,所以是稍加整理,把文档相关的操作给简化,整合到一个类里面,供大家参考。

2.1 使用前的准备工作

  1. 导入 aspose 的包,本人使用的是 aspose-words 16.8.0版本,各位可以去网上搜索一个下载,也可以克隆项目(参照:4. Demo 代码 Git 地址(含Jar包、模板文件))。
  2. 去除水印操作,同样的,各位可以去网上搜一个 license.xml 下载。(详细可以参照:3.1 水印说明

2.2 导入工具类

package com.chimmhuang.util;

import com.aspose.words.Document;
import com.aspose.words.DocumentBuilder;
import com.aspose.words.SaveFormat;
import com.aspose.words.SaveOptions;
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.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.util.HashMap;
import java.util.List;
import java.util.Map; /**
* @author Chimm Huang
* @author chimmhuang@163.com
* @date 2020/01/22
*/
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());
} else if(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);
}
}
return fillWordDataByMap(modelWordByte, data);
} catch (Exception e) {
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> en : data.entrySet()) {
String key = en.getKey();
Object value = en.getValue(); if (value instanceof List) {
//写入表数据
DataTable dataTable = fillListData((List) value, key, builder);
doc.getMailMerge().executeWithRegions(dataTable);
} if (value instanceof BufferedImage) {
builder.moveToMergeField(key);
builder.insertImage((BufferedImage) value);
} String valueStr = String.valueOf(en.getValue());
if (value == null || value.equals("null")) {
continue;
} 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;
} /**
* 封装 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 = new License();
// license.setLicense(is);
// } catch (Exception e) {
// throw new RuntimeException("自动加载aspose证书文件失败!");
// }
// }
}

2.3 开始使用

  1. 首先,我们先定义和模板对应的数据,我们先定义列表里面的 [员工薪资信息]Worker 的数据
package com.chimmhuang.pojo;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor; import java.math.BigDecimal; /**
* 员工薪资信息
*
* @author Chimm Huang
* @author chimmhuang@163.com
*/
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class Worker {
/** 员工姓名 */
private String name;
/** 年龄 */
private Integer age;
/** 性别 */
private String sex;
/** 工资 */
private BigDecimal salary;
}
  1. 接着我们定义整个模板的基本数据:SalaryData
package com.chimmhuang.pojo;

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 Chimm Huang
* @author chimmhuang@163.com
*/
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class SalaryData {
/** 公司名称 */
private String companyName;
/** 员工薪资列表 */
private List<Worker> workerList;
/** 工资总和 */
private BigDecimal totalSalary;
/** 公司log */
private BufferedImage logImg;
}
  1. 定义好以上数据之后,我们就可以开始进行数据的填充,工具类提供两种填充方法

    1. 一种是传递 Object 数据进行数据填充
    2. 另一种是传递 Map 数据进行数据填充

我在这里采用第一种方式进行数据的填充,个人也比较推荐使用domain数据。

package com.chimmhuang.run;

import com.chimmhuang.pojo.SalaryData;
import com.chimmhuang.pojo.Worker;
import com.chimmhuang.util.ContractUtil; import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.math.BigDecimal;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Arrays;
import java.util.List; /**
* @author Chimm Huang
* @author chimmhuang@163.com
*/
public class App { public static void main(String[] args) throws IOException { // 封装员工薪资信息
Worker worker1 = Worker.builder()
.name("张三")
.age(18)
.sex("男")
.salary(BigDecimal.valueOf(1000))
.build();
Worker worker2 = Worker.builder()
.name("李四")
.age(16)
.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 接受图片
BufferedImage image = ImageIO.read(new FileInputStream("C:\\Users\\huangshuai\\Desktop\\鱼.png"));
BufferedImage bufferedImage = ContractUtil.resizeBufferedImage(image, 50, 50, true); // 封装文档模板数据
SalaryData data = SalaryData.builder()
.companyName("王多鱼股份有限公司")
.workerList(workerList)
.totalSalary(totalSalary)
.logImg(bufferedImage)
.build(); // 读取模板文件
byte[] modelByte = Files.readAllBytes(Paths.get("C:\\Users\\huangshuai\\Desktop\\模板.docx")); // 调用工具类,获取填充数据后的文件
byte[] resultByte = ContractUtil.fillWordDataByDomain(modelByte, data); // 处理该二进制文件,此处处理为输出到桌面
File resultFile = new File("C:\\Users\\huangshuai\\Desktop\\员工薪资统计表.docx");
FileOutputStream fos = new FileOutputStream(resultFile);
fos.write(resultByte);
fos.close();
}
}

2.4 结果展示

3. 注意事项

3.1 水印说明

看上方的图相比大家也不难发现,文档生成的同时,也多了红色的一串字体。

由于 aspose 是收费的,所以想要去水印使用,需要添加 license.xml,由于本人使用的是公司提供的凭证,所以我就不传上来了,如有需要,可以选择购买 aspose 的服务,或者上网搜一个 license.xml

3.2 如何添加 license

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

4. Demo 代码 Git 地址(含Jar包、模板文件)

码云地址:https://gitee.com/chimmhuang/Aspose-word-demo

欢迎 Star、fork

使用Aspose.word (Java) 填充word文档数据(包含图片填充)的更多相关文章

  1. 使用Freemarker导出Word文档(包含图片)代码实现及总结

    .personSunflowerP { background: rgba(51, 153, 0, 0.66); border-bottom: 1px solid rgba(0, 102, 0, 1); ...

  2. 用 Freemarker 生成 word 文档(包含图片)

    1. 用word写一个需要导出的word模板,然后存为xml格式. 2. 将xml中需要动态修改内容的地方,换成freemarker的标识符,例如: <w:p wsp:rsidR="0 ...

  3. 将多个 docx 文件使用 POI 进行合并,生成单个文档,包含图片

    1 添加 maven 依赖,需要使用 poi 的依赖项 <!-- https://mvnrepository.com/artifact/org.apache.poi/poi-scratchpad ...

  4. Java 用Freemarker完美导出word文档(带图片)

    Java  用Freemarker完美导出word文档(带图片) 前言 最近在项目中,因客户要求,将页面内容(如合同协议)导出成word,在网上翻了好多,感觉太乱了,不过最后还是较好解决了这个问题. ...

  5. 【Java】用Freemarker完美导出word文档(带图片)

    Java  用Freemarker完美导出word文档(带图片) 前言 最近在项目中,因客户要求,将页面内容(如合同协议)导出成word,在网上翻了好多,感觉太乱了,不过最后还是较好解决了这个问题. ...

  6. 将Word,PDF文档转化为图片

    #region 将Word文档转化为图片 /// <summary> /// 将Word文档转化为图片 /// </summary> /// <param name=&q ...

  7. C# 提取Word文档中的图片

    C# 提取Word文档中的图片 图片和文字是word文档中两种最常见的对象,在微软word中,如果我们想要提取出一个文档内的图片,只需要右击图片选择另存为然后命名保存就可以了,今天这篇文章主要是实现使 ...

  8. 如何取出word文档里的图片

    在生活当中,Word办公是必不可少的.但是在工作中也会遇到一些麻烦,比如说如何取出word文档里的图片呢?有的人会通过复制粘贴,通过画图保存,可是这种方法未免太繁琐了吧.下面我就来分享一下我的经验. ...

  9. word中怎样把文档里的中文以及中文字符全选?

    word中怎样把文档里的中文以及中文字符全选? 参考: 百度 案例: 有个文档是中英文混杂的 现在需要把中文以及中文字符全部设置成别的颜色 应该怎样操作? 有80多页 别说让我一个一个的设置 以wor ...

随机推荐

  1. POI 导入excel数据自动封装成model对象--介绍

    1.项目开发中,导入输入应该是常用的基本功能.我们经常会使用excel将数据导入到数据库,在导入之前必须得将excel数据转换成javaBean对象 2.由于此功能经常使用,所以开发此工具类方便日后轻 ...

  2. java 查询指定月份的工作日(不包括法定节假日)

    /** * 日期工具类 用于获取指定月份的工作日(除去周末和法定节假日) */ public class DateUtils { public static void main(String[] ar ...

  3. Unity3D的UGUI布局锚点自动绑定关系

    [MenuItem("CONTEXT/RectTransform/Auto")] public static void AutoRectAnior() { Debug.Log(&q ...

  4. vs2015 cppunit配置及使用

    目录 第一步 第二步 第三步 编译生成lib库 使用 calculator类测试 代码部分 第一步 下载源代码 http://sourceforge.net/projects/cppunit/file ...

  5. 7.2 Go type assertion

    7.2 Go type assertion 类型断言是使用在接口值上的操作. 语法x.(T)被称为类型断言,x代表接口的类型,T代表一个类型检查. 类型断言检查它操作对象的动态类型是否和断言类型匹配. ...

  6. flask之Blueprint蓝图

    flask_Blueprint.py ''' flask中的Blueprint蓝图: (1)新建模块,例如Bp1.py,Bp2.py,在模块中创建蓝图实例 (2)通过app.register_blue ...

  7. kubernetes flannel pod CrashLoopBackoff解决

    背景 某环境客户部署了一个kubernetes集群,发现flannel的pod一直重启,始终处于CrashLoopBackOff状态. 排查 对于始终CrashLoopBackOff的pod,一般是应 ...

  8. CSS类与选择器【转】http://www.cnblogs.com/duanhuajian/archive/2012/12/17/2821524.html

    1.在 HTML 中,一个 class 值中可能包含一个词列表,各个词之间用空格分隔.例如,如果希望将一个特定的元素同时标记为重要(important)和警告(warning),就可以写作(这两个词的 ...

  9. HDU-6393 Traffic Network in Numazu

    题意:给你一个n边n点的无向连通图,两个操作,操作一改变某个边的权值,操作二查询某两个点之间的路径长度. 题解:随便删掉环上一条边搞一棵树出来,因为两点间距离是两点各自到根的距离之和减去2*lca两点 ...

  10. UVALive8518 Sum of xor sum

    题目链接:https://vjudge.net/problem/UVALive-8518 题目大意: 给定一个长度为 $N$ 的数字序列 $A$,进行 $Q$ 次询问,每次询问 $[L,R]$,需要回 ...