如何在 PDF 中加入條碼(使用 GroupDocs.Signature for Java)

將機器可讀的資料直接嵌入 PDF(或任何支援的文件)可讓您自動化驗證、簡化資料擷取,並保留防篡改的稽核追蹤。在本教學中,您將學習如何使用 GroupDocs.Signature for Java 將條碼加入 PDF 檔案,涵蓋從 QR Code 建立到驗證與管理的全部內容。此函式庫支援超過 55 種檔案格式,因此相同程式碼可用於 Word、影像、壓縮檔等。

快速解答

  • 需要哪個函式庫? GroupDocs.Signature for Java(可透過 Maven Central 取得)。
  • 需要哪個 Java 版本? Java 8 或更新版本。
  • 我可以將條碼加入 PDF 以及其他格式嗎? 可以 — API 支援 55 種以上的格式,包括 PDF、DOCX、XLSX、PNG、TAR、ZIP 等。
  • 支援哪些條碼類型? QR Code、Data Matrix、Code128、Code39、HIBC、GS1 Composite 等多種。
  • 商業使用需要授權嗎? 必須擁有有效的 GroupDocs.Signature 授權才能商業使用;亦提供免費試用版供測試。
  • 需要多少行程式碼? 通常只需 5‑10 行即可建立並嵌入 QR Code 條碼。

如何使用 GroupDocs.Signature for Java 在 PDF 中加入條碼?

載入目標 PDF,設定條碼選項,然後呼叫 sign 方法——這就是全部需求。API 直接將條碼寫入文件,同時保留原始檔案結構,最終得到可供掃描或自動驗證的已簽署 PDF。

您只需三個簡單步驟即可在 PDF 中加入條碼:初始化 Signature 處理器、使用所需條碼類型與視覺設定配置 BarcodeSignOptions,最後呼叫 sign 以嵌入條碼並儲存輸出檔案。

什麼是 QR Code 簽章?

QR Code 簽章是一種基於條碼的數位簽章,將自訂資料儲存在附加於文件的 QR Code 視覺元素中。透過掃描 QR Code 可取得嵌入的資訊,實現自動驗證與資料擷取,且不會更改檔案的原始內容。

為何在文件中使用條碼簽章?

條碼簽章解決了一個常見問題:在不更改文件內容的前提下,安全地附加機器可讀的中繼資料。它們可實現自動化資料擷取、提升驗證效率,並簡化工作流程,使企業更容易將文件處理與現有系統整合,同時維持完整性與合規性。

使用 Java 建立 QR Code 簽章的入門指南

在撰寫任何程式碼之前,請確保您已具備以下條件:

  • 已安裝 Java 8 或更新版本。
  • 已將 GroupDocs.Signature for Java 加入專案(Maven 依賴或手動 JAR)。
  • 已放置有效的 GroupDocs.Signature 授權檔案(或試用金鑰),讓 SDK 能讀取。

典型的工作流程如下:

  1. 使用來源檔案路徑初始化 Signature 物件。
  2. 設定 BarcodeSignOptions —— 選擇條碼類型、設定資料字串、大小、顏色與位置。
  3. 呼叫 sign 以嵌入條碼並將已簽署的文件寫入磁碟。

如何選擇適合的條碼類型

不確定該使用哪種條碼?以下是一個快速決策指南:

  • 針對 URL 或長文字(約 4,000 個字元) — QR Code 最具彈性,且可用任何智慧手機相機掃描。
  • 醫療或藥品追蹤 — HIBC LIC 條碼(QR、Aztec 或 Data Matrix 變體)符合業界規範。
  • 零售或供應鏈(GS1 標準) — GS1 Composite 或 GS1‑128 提供所需的資料結構。
  • 緊湊的數字資料 — Code128 或 Code39 非常適合追蹤編號或序號。
  • 大型資料集且需錯誤更正 — Data Matrix 或 Aztec 可在更小的區域內容納更多資料,即使部分受損仍可讀取。

專業提示: 若不確定,請先使用 QR Code;它提供最高的相容性與錯誤更正選項。

如何在 Java 中建立 QR Code 簽章

要建立 QR Code 簽章,首先將 PDF 檔載入 Signature 實例,接著實例化 BarcodeSignOptions,指定 BarcodeTypes.QR 以及要嵌入的資料(例如 URL 或 JSON 負載)。依需求調整大小、顏色與位置,最後呼叫 sign 方法,該方法會在文件上繪製 QR Code,並回傳表示成功與簽章位置的結果。

步驟 1:初始化 Signature 處理器

Signature 是所有簽署、搜尋與驗證操作的入口點。它抽象化了 PDF、Word 文件、影像與壓縮檔等格式的檔案處理。

步驟 2:設定 BarcodeSignOptions

BarcodeSignOptions 是用於在條碼簽章套用至文件前,指定所有視覺與資料屬性的選項類別。

常見設定包括:

  • 條碼類型 – BarcodeTypes.QR
  • 要嵌入的資料 – 任意 UTF‑8 字串,例如 URL 或 JSON 負載
  • 大小 – 以點為單位的寬度與高度(例如 120 × 120)
  • 位置 – 頁碼、X/Y 座標,或對齊旗標
  • 視覺樣式 – 前景/背景顏色、不透明度、旋轉角度

步驟 3:簽署並儲存文件

呼叫 sign 會將條碼寫入文件,並回傳結果物件,告知操作是否成功以及條碼的放置位置。

常見使用情境

開發者使用 QR Code 簽章於:

  • 發票處理 – 編碼發票號碼與金額;會計軟體掃描後自動填入付款系統。
  • 文件追蹤 – 為合約加入唯一條碼;掃描後即時取得版本歷史與批准狀態。
  • 倉儲管理 – 在出貨標籤上簽署產品 SKU;掃描器即時更新庫存。
  • 合規與稽核追蹤 – 嵌入驗證碼,證明文件自簽署以來未被更改。
  • 醫療紀錄 – 在患者檔案上使用符合 HIBC 標準的條碼,以確保正確追蹤與符合法規。

可用教學

以下列出每項條碼簽章操作的逐步指南。每篇教學皆包含完整、可執行的 Java 程式碼,您可依需求調整。

條碼簽章的最佳實踐

  • 保持條碼內容簡短 — 建議不超過 500 個字元;較小的條碼掃描更快,低解析度下也更清晰。
  • 在正式環境前測試掃描 — 確認使用者實際使用的掃描器能讀取所選格式。
  • 條碼放置要一致 — 右下角或其他固定位置可提升自動掃描的可靠性。
  • 啟用錯誤更正 — 使用 QR Code 的 “H” 級別或 Data Matrix 的高 ECC 模式,以提升對損壞的韌性。
  • 結合視覺簽章 — 將條碼與傳統數位簽章配合,實現機器與人工雙重驗證。
  • 優雅處理驗證失敗 — 記錄任何不符情況;這可能表示被竄改,應觸發安全警報。

常見問答

Q: 我可以在商業應用程式中使用條碼簽章嗎?
A: 可以,只要您擁有有效的 GroupDocs.Signature 授權。亦提供免費試用供評估。

Q: 條碼簽章能在受密碼保護的 PDF 上使用嗎?
A: 完全可以。建立 Signature 實例時提供文件密碼,API 會自動解密、簽署並重新加密檔案。

Q: 推薦哪種條碼格式適合手機掃描?
A: QR Code 與 Data Matrix 具最佳的智慧手機相容性與內建錯誤更正,適合現場工作人員使用。

Q: 如何在不重新簽署整份文件的情況下更新現有條碼?
A: 使用 “初始化與更新” 教學中示範的 BarcodeSignOptions 更新方法——可就地修改內容、大小或位置,保留檔案其他部分。

Q: 簽署數千份 PDF 時會有效能影響嗎?
A: API 已針對批次操作進行最佳化;重複使用單一 Signature 實例並關閉詳細日誌,可最大化吞吐量。一般在標準 8 核心伺服器上,每分鐘可處理超過 200 份文件。

資源

結論

使用 GroupDocs.Signature for Java 在 PDF 中加入 QR Code 或其他條碼相當簡單。依照上述步驟,您即可將安全的機器可讀資料嵌入任何支援的文件類型,實現自動化資料擷取,並保證文件完整性。探索相關教學以深入了解——無論是大規模管理條碼、在壓縮檔中驗證,或遵循 HIBC、GS1 等行業標準。


最後更新: 2026-11-01
測試環境: GroupDocs.Signature for Java 23.12(撰寫時的最新版本)
作者: GroupDocs

相關教學

Initialize a `Signature` instance with the source file, create a `BarcodeSignOptions` object set to QR code type, assign the data you want to embed, specify position and size, then call `sign` to produce the output file.