如何使用 GroupDocs.Signature for Java 實作數位簽章載入和簽名

介紹

在當今的數位時代,確保文件的真實性和完整性對於金融、法律和醫療保健等各個領域都至關重要。無論您是在線上簽署合約還是管理敏感數據,使用數位簽名都可以簡化流程並確保安全。本教學將指導您使用 GroupDocs.Signature for Java 實作數位簽章載入和文件簽章。

您將學到什麼:

  • 從憑證儲存區載入數位簽章。
  • 使用已載入的憑證對文件進行數位簽署。
  • 透過整合 GroupDocs.Signature 優化您的 Java 應用程式。

讓我們深入了解開始所需的先決條件!

先決條件

在實現本教程中討論的功能之前,請確保您具備以下條件:

  • 所需的庫和版本:

    • GroupDocs.Signature 適用於 Java 版本 23.12 或更高版本。
  • 環境設定要求:

    • 確保您的開發環境已安裝 JDK(Java 開發工具包)。
  • 知識前提:

    • 熟悉Java程式設計。
    • 對數位證書及其在安全中的作用有基本的了解。

為 Java 設定 GroupDocs.Signature

首先,您需要將 GroupDocs.Signature 整合到您的專案中。您可以使用 Maven 或 Gradle 來完成此操作,也可以直接下載該程式庫。

使用 Maven

將以下相依性新增至您的 pom.xml 文件:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

使用 Gradle

將其包含在您的 build.gradle 文件:

implementation 'com.groupdocs:groupdocs-signature:23.12'

直接下載

或者,從下載最新版本 GroupDocs.Signature Java 版本.

許可證取得步驟

  • 免費試用: 從免費試用開始探索功能。
  • 臨時執照: 如果您需要擴展測試能力,請取得臨時許可證。
  • 購買: 考慮購買長期使用的許可證。

基本初始化和設定

若要初始化 GroupDocs.Signature,請建立一個實例 Signature 班級:

import com.groupdocs.signature.Signature;

// 使用文檔路徑初始化簽名對象
Signature signature = new Signature("path/to/your/document.pdf");

實施指南

讓我們將實作分解為兩個主要功能:載入數位簽章和簽署文件。

功能 1:從憑證儲存載入數位簽名

此功能示範如何使用 GroupDocs.Signature for Java 從憑證儲存區載入數位簽章。

逐步實施

1.導入所需的類別

首先導入必要的類別:

import com.groupdocs.signature.domain.signatures.DigitalSignature;
import java.util.ArrayList;
import java.util.List;

2.建立 LoadDigitalSignatures 類

實作從憑證儲存區載入數位簽章的方法:

public class LoadDigitalSignatures {
    public List<DigitalSignature> run() {
        List<DigitalSignature> signatures = new ArrayList<>();
        try {
            // 從「我的」憑證儲存區載入數位簽章。
            List<DigitalSignature> signaturesFromStore = DigitalSignature.loadDigitalSignatures(StoreName.My);
            signatures.addAll(signaturesFromStore);
        } catch (Exception e) {
            System.out.println("Error loading certificates: " + e.getMessage());
        }
        return signatures;
    }
}

3. 解釋

  • 參數: StoreName.My 指定要使用的憑證儲存。
  • 傳回值: 已載入的數位簽章清單。

功能2:使用數位簽章簽署文檔

一旦您有了數位簽名,您就可以使用這些憑證來簽署文件。

逐步實施

1.導入所需的類別

import com.groupdocs.signature.Signature;
import com.groupdocs.signature.domain.signatures.DigitalSignature;
import com.groupdocs.signature.options.sign.DigitalSignOptions;
import java.io.File;
import java.security.KeyStore;

2.創建SignDocumentWithDigital類

實作使用數位簽章對文件進行簽章的方法:

public class SignDocumentWithDigital {
    public void run(String documentPath) {
        // 加載數位簽章。
        List<DigitalSignature> signatures = new LoadDigitalSignatures().run();
        
        int signatureNumber = 0;
        for (DigitalSignature digitalSignature : signatures) {
            signatureNumber++;
            String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY\