Apose.words 功能集成示例

系列文章目录

---

---

前言

本文是 Apose.words 的一些常用功能的集成示例。

---

一、基本功能

1. word 文档合并

// 获取文档
Document doc1 = new Document("D:/doc1.docx");
Document doc2 = new Document("D:/doc2.docx");

// 将文档2追加到文档1（保留原格式）
doc1.appendDocument(document2, ImportFormatMode.KEEP_SOURCE_FORMATTING);

// 保存文档
doc1.save("D:/doc.docx");

二、个性化功能

1. 限制仅标签可编辑

限制文档编辑，并设置可编辑区域：

// 加载文档
Document doc = new Document("E:/test.docx");
// 设置只读
doc.protect(ProtectionType.READ_ONLY, "123456");

DocumentBuilder builder = new DocumentBuilder(doc); // 文档指针
// 获取所有标签
BookmarkCollection bookmarks = doc.getRange().getBookmarks();
// 循环所有标签
for (int i = 0; i < bookmarks.getCount(); i++) {
    Bookmark bookmark = bookmarks.get(i);
    builder.moveToBookmark(bookmark.getName(), true, true);
    builder.write(" "); // 插入空格，防止用户编辑清除标签内容时将文档标签也删除
    // 设置可编辑区域
    EditableRangeStart innerEditableRangeStart = builder.startEditableRange(); // 可编辑区域开始
    builder.moveToBookmark(bookmark.getName(), false, false);
    builder.endEditableRange(innerEditableRangeStart); // 可编辑区域结束
    builder.write(" "); // 插入空格，防止用户编辑清除标签内容时将文档标签也删除
}

// 保存文档
doc.save("E:/test1.docx");

编辑完成上传文件时，删除标签前部和尾部的空格：

// 加载文档
Document doc = new Document("E:/test1.docx");

DocumentBuilder builder = new DocumentBuilder(doc); // 文档指针
// 获取所有标签
BookmarkCollection bookmarks = doc.getRange().getBookmarks();
// 循环所有标签
for (int i = 0; i < bookmarks.getCount(); i++) {
    Bookmark bookmark = bookmarks.get(i);
    builder.moveToBookmark(bookmark.getName(), true, true);
    Node bookmarkStartNode = builder.getCurrentNode();
    bookmarkStartNode.remove(); // 将标签内容前部的空格删除
    builder.moveToBookmark(bookmark.getName(), false, false);
    Node bookmarkNextNode = builder.getCurrentNode();
    Node bookmarkEndNode = bookmarkNextNode.getPreviousSibling();
    bookmarkEndNode.remove(); // 将标签内容尾部的空格删除
}

// 保存文档
doc.save("E:/test2.docx");

2. 设置文档的数字签名

首先可安装 openssl：https://blog.csdn.net/HD243608836/article/details/137925745
生成证书文件 cert.pfx：https://www.volcengine.com/theme/1118836-O-7-1

设置文档数字签名：

Document inDoc = new Document("E:/test.docx");
Document outDoc = new Document("E:/test1.docx");

// 加载证书
CertificateHolder certificateHolder = CertificateHolder.create("E:/cert.pfx", "123456", null);
// 签署证书
DigitalSignatureUtil.sign(inDoc, outDoc, certificateHolder, "comments123456", new Date());

校验文档签名：

// 加载文档
Document signedDoc = new Document("E:/test2.docx");

// 检查文档是否经过数字签名
if (signedDoc.getDigitalSignatures().getCount() > 0) {
    // 验证数字签名
    DigitalSignature digitalSignature = signedDoc.getDigitalSignatures().get(0);
    String comments = digitalSignature.getComments();
    System.out.println(comments);
    boolean isValid = signedDoc.getDigitalSignatures().get(0).isValid();
    if (isValid) {
        System.out.println("Digital signature is valid.");
    } else {
        System.out.println("Digital signature is not valid.");
    }
} else {
    System.out.println("Document is not digitally signed.");
}

// 保存文档
signedDoc.save("E:/test2.docx");

3. 自定义文档 ID

设置文档 ID：

// 加载文档
Document doc = new Document("E:/test.docx");
// 添加文档属性
doc.getCustomDocumentProperties().add("custom_id", "custom_12345678");
// 保存文档
doc.save("E:/test1.docx");

校验文档 ID：

// 加载文档
Document doc = new Document("E:/test.docx");
// 获取文档属性
DocumentProperty custom_id = doc.getCustomDocumentProperties().get("custom_id");
System.out.println("custom_id: " + custom_id);