使用 GroupDocs.Signature 掌握 Java 中的文件簽名

透過使用 GroupDocs.Signature for Java 簽署、驗證、搜尋、更新和刪除條碼簽章來簡化您的數位文件工作流程。

在快節奏的數位互動世界中，高效管理文件至關重要。無論是處理合約或其他重要文書工作，能夠簽署、驗證、搜尋、更新和刪除文件簽名都能顯著提高工作效率和安全性。本指南將指導您如何使用 GroupDocs.Signature for Java——一個強大的函式庫，它透過條碼簽章簡化了這些任務。

您將學到什麼：

  • 如何使用條碼簽名簽署文件。
  • 驗證簽名文件真實性的技術。
  • 搜尋、更新和刪除文件中現有條碼簽署的方法。
  • 實際應用和效能優化技巧。

在深入實施細節之前，請確保您已準備好開始實施所需的一切。

先決條件

要學習本教程，您需要：

  • Java 開發工具包 (JDK)： 確保您的系統上安裝了 JDK 8 或更高版本。
  • 整合開發環境（IDE）： 我們建議使用 IntelliJ IDEA 或 Eclipse 進行 Java 開發。
  • GroupDocs.Signature 庫： 該程式庫對於簽署和驗證文件至關重要。

所需的庫和依賴項

您可以使用 Maven、Gradle 或直接下載 JAR 將 GroupDocs.Signature 新增至您的專案：

Maven

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

Gradle

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

對於喜歡直接下載的用戶，可以在以下位置找到最新版本 GroupDocs.Signature Java 版本.

許可證獲取

若要探索 GroupDocs.Signature 的全部功能，請考慮取得臨時授權或購買訂閱。您可以先免費試用，測試其功能：

環境設定

確保已在首選 IDE 中準備好 Java 專案。配置建置路徑或 pom.xml （對於 Maven）或 build.gradle （適用於 Gradle）文件，其中包含 GroupDocs.Signature 依賴項。設定完成後，透過建立 Signature。

為 Java 設定 GroupDocs.Signature

GroupDocs.Signature 使用各種簽章類型（包括條碼）簡化文件簽章和驗證流程。首先導入必要的類別：

import com.groupdocs.signature.Signature;

基本初始化

若要在 Java 應用程式中初始化 GroupDocs.Signature，請建立一個 Signature 具有目標文檔路徑的物件：

Signature signature = new Signature("path/to/your/document.pdf");

透過此設置，您就可以實現 GroupDocs.Signature 提供的各種功能。

實施指南

使用條碼簽名簽署文件

概述： 此功能可讓您在任何文件中新增條碼簽名。條碼可以包含姓名或身分證號碼等文本，以增強安全性並方便驗證。

逐步實施：

  1. 定義路徑： 指定輸入和輸出文件的路徑：

    String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
String outputFilePath = "YOUR_OUTPUT_DIRECTORY/signed_sample.docx";

  2. 建立簽名對象： 初始化一個 Signature 帶有文檔路徑的物件：

    Signature signature = new Signature(filePath);

  3. 設定條碼選項： 配置條碼標誌選項，包括文字、類型、對齊方式、大小和顏色：

    BarcodeSignOptions signOptions = new BarcodeSignOptions("John Smith", BarcodeTypes.Code128);
signOptions.setVerticalAlignment(VerticalAlignment.Top);
signOptions.setHorizontalAlignment(HorizontalAlignment.Center);
signOptions.setWidth(100);
signOptions.setHeight(40);
signOptions.setMargin(new java.awt.Rectangle(20, 20, 0, 0));
signOptions.setForeColor(Color.RED);

SignatureFont signatureFont = new SignatureFont();
signatureFont.setSize(12);
signatureFont.setFamilyName("Comic Sans MS");
signOptions.setFont(signatureFont);

  4. 簽署文件： 將配置的條碼簽名套用到文件：

    signature.sign(outputFilePath, signOptions);

驗證文件條碼簽名

概述： 透過驗證條碼簽名來確保簽名文件的完整性和真實性。

逐步實施：

  1. 設定驗證： 將簽署的文檔載入到 Signature 目的：

    Signature signature = new Signature("YOUR_OUTPUT_DIRECTORY/signed_sample.docx");

  2. 配置驗證選項： 設定驗證選項以符合特定的條碼簽名：

    BarcodeVerifyOptions verifyOptions = new BarcodeVerifyOptions();
verifyOptions.setAllPages(false); // 僅驗證第一頁
verifyOptions.setPageNumber(1);
verifyOptions.setEncodeType(BarcodeTypes.Code128);
verifyOptions.setText("John Smith");

  3. 執行驗證： 執行驗證程序並檢查簽名是否有效：

    boolean isValid = signature.verify(verifyOptions) != null;

搜尋文件中的條碼簽名

概述： 快速找到文件中的條碼簽名以確認其存在或收集資訊。

逐步實施：

  1. 初始化搜尋： 將您的文件載入到 Signature 班級：

    Signature signature = new Signature("YOUR_OUTPUT_DIRECTORY/signed_sample.docx");

  2. 設定搜尋選項： 定義選項以在文件的所有頁面上搜尋條碼簽名：

    BarcodeSearchOptions searchOptions = new BarcodeSearchOptions();
searchOptions.setAllPages(true);

  3. 執行搜尋： 檢索找到的條碼簽名清單：

    java.util.List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, searchOptions);

更新文件條碼簽名

概述： 修改文件中現有的條碼簽章以反映變更或更新。

逐步實施：

  1. 準備更新： 假設您有一個從先前的搜尋操作中檢索到的簽名清單：

    List<BarcodeSignature> signaturesToUpdate = new ArrayList<>();

  2. 修改簽名屬性： 調整位置和大小等屬性來更新簽章：

    if (!signaturesToUpdate.isEmpty()) {
    BarcodeSignature bcSignature = signaturesToUpdate.get(0);
    bcSignature.setLeft(bcSignature.getLeft() + 100);
    bcSignature.setTop(bcSignature.getTop() + 100);
    bcSignature.setWidth(200);
    bcSignature.setHeight(50);
}

  3. 應用程式更新： 儲存對文檔的變更：

    ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
signature.update(outputStream, signaturesToUpdate);

刪除文件條碼簽名

概述： 從文件中刪除不必要的或過時的條碼簽名。

逐步實施：

  1. 準備刪除： 假設您有一個從先前的搜尋操作中檢索到的簽名清單：

    List<BarcodeSignature> signaturesToDelete = new ArrayList<>();

  2. 刪除簽名： 從您的文件中刪除指定的條碼簽名：

    signature.delete(signaturesToDelete);