如何在 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 能讀取。
典型的工作流程如下:
- 使用來源檔案路徑初始化
Signature物件。 - 設定
BarcodeSignOptions—— 選擇條碼類型、設定資料字串、大小、顏色與位置。 - 呼叫
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 程式碼,您可依需求調整。
- 高效 Java 條碼簽章管理使用 GroupDocs.Signature
- 如何使用 GroupDocs.Signature for Java 建立並簽署帶條碼的 PDF
- 如何在 Java 中使用 GroupDocs.Signature 實作條碼簽章搜尋
- 如何在 Java 中使用 GroupDocs.Signature 初始化與更新條碼簽章
- 使用 GroupDocs.Signature for Java 簽署帶 HIBC LIC 代碼的 PDF:完整指南
- 如何在 Java 中使用 GroupDocs.Signature 驗證條碼簽章
- Java PDF 條碼搜尋使用 GroupDocs.Signature API:完整指南
- Java PDF 簽署帶條碼使用 GroupDocs:完整指南
- 使用 GroupDocs.Signature for Java 簽署帶條碼的 PDF 文件:完整指南
- 使用 GroupDocs.Signature for Java 簽署帶 GS1 Composite 條碼的 PDF
- 使用 GroupDocs.Signature 在 Java 中為 TAR 壓縮檔簽署條碼與 QR Code
- 使用 GroupDocs.Signature for Java 驗證 ZIP 檔中的條碼簽章
條碼簽章的最佳實踐
- 保持條碼內容簡短 — 建議不超過 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 文件
- GroupDocs.Signature for Java API 參考
- 下載 GroupDocs.Signature for Java
- GroupDocs.Signature 論壇
- 免費支援
- 臨時授權
結論
使用 GroupDocs.Signature for Java 在 PDF 中加入 QR Code 或其他條碼相當簡單。依照上述步驟,您即可將安全的機器可讀資料嵌入任何支援的文件類型,實現自動化資料擷取,並保證文件完整性。探索相關教學以深入了解——無論是大規模管理條碼、在壓縮檔中驗證,或遵循 HIBC、GS1 等行業標準。
最後更新: 2026-11-01
測試環境: GroupDocs.Signature for Java 23.12(撰寫時的最新版本)
作者: GroupDocs
相關教學
- Java 文件 QR Code 驗證 - 完整的 GroupDocs.Signature
- 如何使用 Java 與 GroupDocs.Signature 讀取 QR Code PDF
- 在 Java 中建立條碼簽章 – 更新 PDF 條碼
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.