在 PDF 中添加或删除数字签名：一份详尽的 Java 教程

在数字化办公日益普及的今天，PDF文档的安全性与真实性变得尤为重要。数字签名作为一种电子加密技术，能够有效验证文档的来源、确保内容完整性，并提供不可抵赖的法律效力。本文将深入探讨如何在Java环境中，利用强大的Spire.PDF for Java库，对PDF文档进行数字签名的添加与删除操作。

1. Spire.PDF for Java 库介绍与安装

Spire.PDF for Java是一款功能丰富的PDF处理库，它允许开发者在Java应用程序中轻松创建、读写、编辑和转换PDF文档。其突出优势在于对PDF标准的高度兼容性、强大的渲染能力以及对复杂PDF特性（如数字签名、表单、图层等）的良好支持。对于数字签名操作，Spire.PDF for Java提供了直观易用的API，极大地简化了开发流程。

Maven 依赖配置：

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.pdf</artifactId>
        <version>11.10.3</version>
    </dependency>
</dependencies>

2. Java 在 PDF 中添加数字签名

添加数字签名通常涉及加载PDF、加载数字证书、设置签名外观和信息，最后保存文档。

步骤详解：

加载PDF文档： 使用PdfDocument类加载目标PDF文件。
加载数字证书： 数字证书通常以PKS12（.pfx或.p12）格式存储，包含私钥和公钥。使用PdfCertificate类加载证书文件及密码。
创建签名对象： 实例化PdfSignature对象，指定PDF文档、签名页、证书和签名名称。
设置签名区域： 定义签名在页面上的位置和大小，通过setBounds方法设置。
配置签名外观： Spire.PDF支持多种签名外观模式，例如只显示图像、只显示签名详情、同时显示图像和详情等。可以通过setGraphicMode方法进行设置。
设置签名信息： 包括签名者姓名、联系信息、签名地点、签名原因等。
保存PDF： 将带有数字签名的PDF文档保存到新文件或覆盖原文件。

Java 代码示例：

java 复制代码

    
    
    
  import com.spire.pdf.graphics.*;
import com.spire.pdf.security.GraphicMode;
import com.spire.pdf.security.PdfCertificate;
import com.spire.pdf.security.PdfCertificationFlags;
import com.spire.pdf.security.PdfSignature;

import java.awt.*;
import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;

public class AddDigitalSignature {

    public static void main(String[] args) {

        //加载PDF文档
        PdfDocument doc = new PdfDocument();
        doc.loadFromFile("C:\\Users\\Administrator\\Desktop\\sample.pdf");

        //加载pfx证书
        PdfCertificate cert = new PdfCertificate("C:\\Users\\Administrator\\Desktop\\gary.pfx", "e-iceblue");

        //添加数字签名，设置其位置和大小
        PdfSignature signature = new PdfSignature(doc, doc.getPages().get(0), cert, "MySignature");
        Rectangle2D rect = new Rectangle2D.Float();
        rect.setFrame(new Point2D.Float((float) doc.getPages().get(0).getActualSize().getWidth() - 340, (float) doc.getPages().get(0).getActualSize().getHeight() - 150), new Dimension(270, 100));
        signature.setBounds(rect);

        //设置签名为图片加文本模式
        signature.setGraphicMode(GraphicMode.Sign_Image_And_Sign_Detail);

        //设置签名的内容
        signature.setNameLabel("签字者：");
        signature.setName("Gary");
        signature.setContactInfoLabel("联系电话：");
        signature.setContactInfo("02881705109");
        signature.setDateLabel("日期：");
        signature.setDate(new java.util.Date());
        signature.setLocationInfoLabel("地点：");
        signature.setLocationInfo("成都");
        signature.setReasonLabel("原因：");
        signature.setReason("我是文档所有者");
        signature.setDistinguishedNameLabel("DN: ");
        signature.setDistinguishedName(signature.getCertificate().get_IssuerName().getName());
        signature.setSignImageSource(PdfImage.fromFile("C:\\Users\\Administrator\\Desktop\\logo-2.png"));

        //设置签名的字体
        signature.setSignDetailsFont(new PdfTrueTypeFont(new Font("宋体", Font.PLAIN, 12)));

        //设置文档权限为禁止更改
        signature.setDocumentPermissions(PdfCertificationFlags.Forbid_Changes);
        signature.setCertificated(true);

        //保存文档
        doc.saveToFile("output/AddSignature.pdf");
        doc.close();
    }
}

上述代码将会在PDF文档的第一页的指定区域添加一个包含证书信息、签名者姓名、联系方式、地点和原因的数字签名。

3. Java 在 PDF 中删除数字签名

删除数字签名相对简单，主要步骤是识别并移除签名域。

步骤详解：

加载PDF文档： 加载包含数字签名的PDF文件。
获取表单字段： PDF中的数字签名通常被视为一种特殊的表单字段。通过doc.getForm().getFields()获取所有表单字段。
遍历并识别签名域： 遍历字段列表，判断字段类型是否为PdfSignatureField。
移除签名域： 从表单字段列表中移除找到的签名域。
保存PDF： 保存修改后的PDF文档。

Java 代码示例：

java 复制代码

    
    
    
  import com.spire.pdf.PdfDocument;
import com.spire.pdf.widget.PdfFieldWidget;
import com.spire.pdf.widget.PdfFormWidget;
import com.spire.pdf.widget.PdfSignatureFieldWidget;

public class RemoveSignature {

    public static void main(String[] args) {

        //创建PdfDocument对象 
        PdfDocument pdf = new PdfDocument();

        //加载PDF文档
        pdf.loadFromFile("C:\\Users\\Administrator\\Desktop\\Signature.pdf");

        //从文档获取form widget集合
        PdfFormWidget widgets = (PdfFormWidget) pdf.getForm();

        //遍历集合中的每一个元素
        for (int i = 0; i < widgets.getFieldsWidget().getList().size(); i++)
        {
            //获取指定widget
            PdfFieldWidget widget = (PdfFieldWidget)widgets.getFieldsWidget().getList().get(i);

            //判断widget是否为PdfSignatureFieldWidget
            if (widget instanceof PdfSignatureFieldWidget)
            {
                //删除数字签名widget
                widgets.getFieldsWidget().remove(widget);
            }
        }

        //保存文档
        pdf.saveToFile("RemoveSignature.pdf");
    }
}

注意事项：

删除数字签名会破坏原始文档的完整性，通常用于测试或特殊场景。

如果文档被多个数字签名保护，上述代码会移除所有签名。若需选择性删除，则需要根据签名名称或其他属性进行判断。

总结

本文详细介绍了如何使用Spire.PDF for Java库在PDF文档中添加和删除数字签名。通过直观的API和清晰的代码示例，开发者可以轻松地实现PDF文档的数字签名操作，从而增强文档的安全性、真实性和法律效力。数字签名在合同签署、电子票据、证书管理等领域发挥着不可替代的作用，掌握这一技术对于构建安全的数字化应用至关重要。