使用 GroupDocs.Signature for Java 掌握文件屬性檢索

利用 GroupDocs.Signature for Java 輕鬆擷取並列印文件屬性（例如格式、大小、頁數等），釋放文件管理的強大功能。本教學將引導您設定環境、實現各種功能，並在實際場景中應用這些功能。

介紹

在當今的數位時代，高效的文件管理對於各種規模的企業都至關重要。快速檢索文件屬性的能力可以確保合規性並簡化工作流程。本教學將引導您利用 GroupDocs.Signature for Java 輕鬆地從文件中提取重要資訊。

您將學到什麼：

設定與配置 Java 版 GroupDocs.Signature
檢索基本文件屬性，例如格式、副檔名、大小和頁數
存取文件中有關表單欄位、文字簽名、圖像簽名、數位簽章、條碼簽章和二維碼簽章的詳細信息

準備好了嗎？讓我們先來了解一下開始之前你需要滿足的先決條件。

先決條件

在開始使用 GroupDocs.Signature for Java 之前，請確保您具備以下條件：

Java 開發工具包 (JDK)： 版本 8 或更高版本。
整合開發環境（IDE）： 例如 IntelliJ IDEA、Eclipse 或 NetBeans。
基本理解： 熟悉 Java 程式設計概念和 Maven/Gradle 建置工具。

為 Java 設定 GroupDocs.Signature

正確設定環境是成功實施的基礎。請依照下列步驟使用 Maven 或 Gradle 將 GroupDocs.Signature 整合到您的 Java 專案中：

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 的授權頁面進行擴展測試。
購買： 如需完整存取權限，請訪問購買頁面.

基本初始化

將 GroupDocs.Signature 整合到您的專案後，請按如下方式初始化它：

import com.groupdocs.signature.Signature;

public class InitializeGroupDocs {
    public static void main(String[] args) {
        String filePath = "YOUR_DOCUMENT_DIRECTORY/sample_signed_multi";
        Signature signature = new Signature(filePath);
    }
}

實施指南

讓我們將實作分解為不同的功能，從文件屬性檢索開始。

文件屬性檢索

概述

檢索基本文件屬性有助於理解文件的結構和內容。使用 GroupDocs.Signature for Java，您可以輕鬆存取格式、副檔名、大小和頁數等資訊。

步驟1：初始化簽名對象

建立一個實例 Signature 透過傳遞文檔路徑：

final Signature signature = new Signature("YOUR_DOCUMENT_DIRECTORY/sample_signed_multi");

第 2 步：檢索文件資訊

使用 getDocumentInfo() 取得文件詳細資訊的方法：

import com.groupdocs.signature.domain.IDocumentInfo;

IDocumentInfo documentInfo = signature.getDocumentInfo();

步驟3：列印文件屬性

提取並顯示基本屬性，如格式、副檔名、大小和頁數：

System.out.println("Document properties:");
System.out.println(" - Format : " + documentInfo.getFileType().getFileFormat());
System.out.println(" - Extension : " + documentInfo.getFileType().getExtension());
System.out.println(" - Size : " + documentInfo.getSize());
System.out.println(" - Page Count : " + documentInfo.getPageCount());

// 遍歷每個頁面以顯示其屬性
import com.groupdocs.signature.domain.PageInfo;

for (PageInfo pageInfo : documentInfo.getPages()) {
    System.out.println(" - Page-" + pageInfo.getPageNumber() + ", Width: " + pageInfo.getWidth() + ", Height: " + pageInfo.getHeight());
}

故障排除提示： 確保檔案路徑正確且可存取。處理異常以捕獲屬性檢索期間的潛在錯誤。

文檔表單欄位資訊

概述

對於需要輸入資料或驗證的文件來說，存取表單欄位至關重要。此功能可讓您枚舉並檢查文件中存在的所有表單欄位。

步驟 1：存取表單字段

利用 getFormFields() 方法獲取有關每個表單欄位的資訊：

import com.groupdocs.signature.domain.signatures.formfield.FormFieldSignature;

for (FormFieldSignature formField : documentInfo.getFormFields()) {
    System.out.println(" - Type #" + formField.getType() + ": Name: " + formField.getName() + ", Value: " + formField.getValue());
}

文件文字簽章訊息

概述

文字簽名通常包含關鍵訊息，例如作者身份或真實性標記。提取這些數據可確保合規性和可驗證性。

步驟 1：檢索文字簽名

致電 getTextSignatures() 收集文字簽名詳細資訊的方法：

import com.groupdocs.signature.domain.signatures.TextSignature;

for (TextSignature textSignature : documentInfo.getTextSignatures()) {
    System.out.println(" - #" + textSignature.getSignatureId() + ": Text: " + textSignature.getText() + ", Location: " + textSignature.getLeft() + "x" + textSignature.getTop() + ". Size: " + textSignature.getWidth() + "x" + textSignature.getHeight());
}

文件影像簽名資訊

概述

圖像簽名可能包含徽標或唯一識別符。存取這些內容有助於驗證文件的真實性。

步驟 1：取得影像簽名詳細信息

使用 getImageSignatures() 檢索影像相關資訊的方法：

import com.groupdocs.signature.domain.signatures.ImageSignature;

for (ImageSignature imageSignature : documentInfo.getImageSignatures()) {
    System.out.println(" - #" + imageSignature.getSignatureId() + ": Size: " + imageSignature.getSize() + " bytes, Format: " + imageSignature.getFormat());
}

文件數位簽章資訊

概述

數位簽章提供了一種驗證文件完整性的安全方法。此功能使您能夠檢索和驗證數位簽章。

步驟 1：訪問數位簽名詳細信息

呼叫 getDigitalSignatures() 方法：

import com.groupdocs.signature.domain.signatures.DigitalSignature;

for (DigitalSignature digitalSignature : documentInfo.getDigitalSignatures()) {
    System.out.println(" - #" + digitalSignature.getSignatureId());
}

文件條碼簽名訊息

概述

條碼可以有效地對資料進行編碼，並且檢索條碼簽名對於庫存或追蹤目的至關重要。

步驟 1：檢索條碼簽名詳細信息

利用 getBarcodeSignatures() 方法：

import com.groupdocs.signature.domain.signatures.BarcodeSignature;

for (BarcodeSignature barcodeSignature : documentInfo.getBarcodeSignatures()) {
    System.out.println(" - #" + barcodeSignature.getSignatureId() + ": Type: " + barcodeSignature.getEncodeType().getTypeName());
}

結論

使用 GroupDocs.Signature for Java 輕鬆擷取文件屬性，為您提供強大的文件管理和驗證功能。遵循本指南，您可以有效增強文件管理工作流程。

後續步驟： 探索 GroupDocs.Signature 提供的更多功能，例如以電子方式簽署文件或實施高級驗證技術以豐富應用程式的功能集。