Java 实现 Word 文档加密与权限解除

在日常的文档处理任务中，我们经常需要对 Word 文件进行安全性控制，例如限制编辑权限、防止内容被随意修改，或者在协作结束后解除文档保护。这类操作如果完全依赖人工手动完成，在面对大量文档时会非常低效。借助程序化手段，可以显著提升处理效率和准确性。

本文将基于一款 Java 组件，介绍如何使用 Java 实现对 Word 文档的保护与取消保护，涵盖常见的保护类型和基本操作流程。

环境准备

在开始编写代码之前，需要先在项目中引入相关依赖。如果使用 Maven 构建项目，可以在 pom.xml 中添加如下配置：

xml 复制代码

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>14.6.0</version>
    </dependency>
</dependencies>

如果未使用 Maven，也可手动下载 jar 包并引入到项目中。

Word 文档保护的基本概念

在 Word 中，文档保护通常指对文件设置编辑限制，确保接收者只能在特定范围内进行修改。常见的保护类型包括：

只读：不允许任何修改。
修订：只能以修订模式进行修改，便于跟踪变更。
批注：只允许添加批注，正文内容不可修改。
填写窗体：仅允许填写窗体域，其他部分锁定。

此外，保护操作还可以设置密码，进一步增强安全性。没有正确密码的用户将无法解除保护。

使用 Java 保护 Word 文档

以下示例演示如何对 Word 文档设置保护，并指定保护类型和密码。

java 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.ProtectionType;

public class ProtectDocument {
    public static void main(String[] args) {
        // 加载待保护的 Word 文档
        Document doc = new Document();
        doc.loadFromFile("input.docx");

        // 设置保护类型为只允许修订，并设置密码
        doc.protect(ProtectionType.Allow_Only_Revisions, "password123");

        // 保存受保护的文档
        doc.saveToFile("ProtectedOutput.docx", FileFormat.Docx_2013);
        doc.close();

        System.out.println("文档保护已完成。");
    }
}

在上述代码中，ProtectionType 枚举提供了多种保护模式，可以根据实际需求选择，例如：

Allow_Only_Reading：只读
Allow_Only_Revisions：允许修订
Allow_Only_Comments：允许批注
Allow_Only_Form_Fields：允许填写窗体
No_Protection：无保护

设置保护并保存后，当用户打开文档时，Word 会根据保护类型限制编辑操作，并在需要时提示输入密码才能解除保护。

使用 Java 取消 Word 文档保护

对于已经加密保护的文档，如果需要恢复完全编辑权限，可以通过代码移除保护。前提是需要提供正确的密码。

java 复制代码

import com.spire.doc.*;

public class UnprotectDocument {
    public static void main(String[] args) {
        // 加载受保护的文档
        Document doc = new Document();
        doc.loadFromFile("ProtectedOutput.docx");

        // 使用正确的密码解除保护
        doc.unprotect("password123");

        // 保存解除保护后的文档
        doc.saveToFile("UnprotectedOutput.docx", FileFormat.Docx_2013);
        doc.close();

        System.out.println("文档保护已解除。");
    }
}

运行上述代码后，生成的文档将不再有编辑限制，用户可以正常进行修改。

需要说明的是，如果输入的密码错误，程序会抛出 IllegalArgumentException。在实际开发中，建议对此类异常进行捕获和处理，以保证程序的稳定性。

检测文档是否处于保护状态

在某些场景下，我们可能只需要判断文档是否已被保护，而不立即执行保护或解除操作。可以通过以下代码检测保护状态：

java 复制代码

import com.spire.doc.*;

public class CheckProtection {
    public static void main(String[] args) {
        Document doc = new Document();
        doc.loadFromFile("ProtectedOutput.docx");

        if (doc.isProtected()) {
            System.out.println("当前文档处于保护状态。");
            System.out.println("保护类型：" + doc.getProtectionType());
        } else {
            System.out.println("当前文档未设置保护。");
        }

        doc.close();
    }
}

通过 isProtected() 和 getProtectionType() 方法，可以快速了解文档的保护情况，便于后续逻辑判断。

注意事项

密码管理：如果设置了密码保护，务必妥善保管密码。一旦遗忘，通过常规方式将难以恢复文档的编辑权限。
格式兼容性 ：保护与取消保护操作适用于 .docx、.doc 等常见格式。在不同格式之间转换时，部分保护设置可能会存在行为差异，建议在目标格式下进行验证。
批量处理：以上示例均针对单个文件。实际项目中，可以结合文件遍历和循环逻辑，实现大批量文档的处理。

结语

通过程序化方式，开发者可以用简洁的代码实现对 Word 文档的自动化保护与解除保护，有效提升文档安全管理的效率。无论是限制编辑权限、防止内容篡改，还是在流程结束后解除限制，这些操作都可以无缝集成到 Java 应用中。

希望本文的内容能对你在文档处理方面的开发工作有所帮助。