Java 建立 QR 代碼簽章教學：在 PDF 中新增、驗證與管理條碼

將機器可讀的資料直接嵌入文件是一種強大的自動化工作流程並保證完整性的方式。在本 Java create QR code signature 教學中，您將了解如何安全地在 PDF、Word 檔案、影像，甚至壓縮檔格式中編碼產品 ID、追蹤號碼或驗證碼。GroupDocs.Signature for Java 將多步驟流程簡化為幾行程式碼，同時保持原始文件不變。

快速解答

  • 需要的函式庫是什麼？ GroupDocs.Signature for Java（Maven 或直接下載）。
  • 支援哪個 Java 版本？ Java 8 或更新版本。
  • 我可以簽署 PDF、Word 和影像嗎？ 可以，API 支援超過 55 種格式。
  • 條碼簽章是否支援 QR、Data Matrix 與 GS1？ 以上全部加上 Code128、Code39、HIBC 等。
  • 生產環境需要授權嗎？ 商業使用需具有效的 GroupDocs.Signature 授權。
  • 需要多少行程式碼？ 完整的 QR 代碼簽章通常只需 5‑10 行程式碼。

什麼是 QR 代碼簽章？

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

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

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

  • 自動資料擷取 – 掃描條碼取代手動輸入資訊。非常適合倉庫、出貨部門或任何高吞吐量環境。
  • 文件驗證 – 編碼唯一識別碼或檢查碼以驗證文件真偽。若有人竄改檔案，條碼將不匹配。
  • 工作流程自動化 – 文件被掃描時觸發自動化流程。例如自動分配發票、更新庫存系統或記錄合規紀錄。
  • 節省空間 – 條碼可在極小的視覺佔位中容納大量資料——通常僅 1 吋方形。
  • 支援行業標準 – 可用於醫療保健（HIBC）、零售（GS1）、物流（Code128）或一般需求（QR Code、Data Matrix）。選擇合適的條碼類型即可符合行業要求。

開始使用 Java 建立 QR 代碼簽章

在深入程式碼之前，先了解基本要點。GroupDocs.Signature for Java 支援 55+ 種文件格式（PDF、DOCX、XLSX、影像、TAR、ZIP 等），並提供數十種條碼類型。典型的工作流程如下：

  1. 初始化 Signature 物件，使用來源文件的路徑。
  2. 設定 BarcodeSignOptions – 選擇條碼類型，設定內容、尺寸、顏色與放置位置。
  3. 套用簽章 並儲存已簽署的文件。
  4. 搜尋或驗證 條碼，以便在需要提取或驗證資料時使用。

您需要 Java 8 或更新版本，以及 GroupDocs.Signature 函式庫（可透過 Maven Central 或直接下載取得）。所有操作皆在記憶體中完成，原始檔案保持未變。

選擇適合的條碼類型

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

  • 適用於 URL 或長文字（約 4,000 個字元）：QR Code – 最具彈性且可用智慧手機讀取的選項。
  • 適用於醫療保健／藥品追蹤：HIBC LIC 條碼（QR、Aztec 或 Data Matrix 變體）。
  • 適用於零售／供應鏈（GS1 標準）：GS1 Composite 或 GS1‑128。
  • 適用於緊湊數字資料：Code128 或 Code39 – 適合追蹤號碼、序號或短識別碼。
  • 適用於大型資料集且需錯誤更正：Data Matrix 或 Aztec – 可容納比傳統 1D 條碼更多資料，即使部分受損仍能讀取。

專業提示： 若不確定，先使用 QR Code——它能處理大多數情境，且不需特殊掃描器。

如何在 Java 中建立 QR 代碼簽章

在 Java 中建立 QR 代碼簽章的流程包括載入目標文件、設定條碼選項的內容與視覺屬性，然後套用簽章。GroupDocs.Signature API 處理所有底層細節，確保條碼正確嵌入且保留原始檔案結構，並允許之後的驗證。

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.

步驟 1：初始化 Signature 處理器

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

步驟 2：設定 BarcodeSignOptions

BarcodeSignOptions 是用來定義條碼類型、內容、尺寸、顏色與頁面放置位置的設定類別。

定義說明： BarcodeSignOptions 是在條碼簽章套用至文件前，用來指定所有視覺與資料屬性的選項類別。

常見設定包括：

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

步驟 3：簽署並儲存文件

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

常見使用案例

以下是開發者實際使用 QR 代碼簽章的方式：

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

可用教學

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

使用 GroupDocs.Signature 的高效 Java 條碼簽章管理

如果您需要完整的生命週期，請從此開始：如何初始化簽章處理器、在文件中搜尋現有條碼，以及在不再需要時刪除簽章。非常適合構建條碼簽章需動態變更的文件管理系統。

如何使用 GroupDocs.Signature for Java 建立並簽署帶條碼的 PDF

此指南說明如何使用條碼簽章簽署全新 PDF。學習如何程式化產生文件並在建立時嵌入條碼——適用於自動化發票產生或證書列印工作流程。

如何在 Java 中使用 GroupDocs.Signature 實作條碼簽章搜尋

需要在一批文件中找出所有條碼嗎？本教學示範如何依條碼類型、內容或位置搜尋。對於稽核大型文件庫或從掃描檔提取資料非常重要。

如何在 Java 中使用 GroupDocs.Signature 初始化與更新條碼簽章

PDF 中已有條碼但需要變更內容或外觀？本指南說明如何在不重新建立整個文件的情況下更新現有條碼簽章——節省處理時間並保留文件歷史。

如何使用 GroupDocs.Signature for Java 簽署帶 HIBC LIC 代碼的 PDF：完整指南

醫療與製藥產業需要符合 HIBC（健康產業條碼）標準。學習如何實作 HIBC LIC QR、Aztec 與 Data Matrix 代碼以符合法規要求，包含設定、驗證與最佳實踐。

如何在 Java 中使用 GroupDocs.Signature 驗證條碼簽章

信任是關鍵。本教學說明如何驗證條碼簽章的真偽與未被竄改。您將學會驗證條碼內容、檢查編碼類型，並確保文件完整性——對於法律或金融文件尤為重要。

Java PDF 條碼搜尋使用 GroupDocs.Signature API：完整指南

深入探討 PDF 專屬的條碼搜尋。涵蓋進階篩選（依頁面、區域、條碼格式）以及如何提取條碼中繼資料供後續處理。非常適合構建自訂文件索引系統。

Java PDF 使用條碼簽署：完整指南

完整的端對端指南，說明如何在 PDF 中加入條碼簽章。包括自訂選項（顏色、字型、定位）、錯誤處理與高量文件處理的效能優化技巧。

使用 GroupDocs.Signature for Java 簽署帶條碼的 PDF 文件：完整指南

另一篇聚焦於安全性與專業工作流程的 PDF 條碼簽署指南。學習如何設定透明度、將條碼對齊至特定座標，並與數位簽章鏈結合。

使用 GroupDocs.Signature for Java 簽署帶 GS1 Composite 條碼的 PDF

需要符合供應鏈或零售的 GS1 標準嗎？本指南專門說明 GS1 Composite 條碼——結合線性與 2D 元件，用於產品驗證與可追溯性。對於運送標籤與國際物流至關重要。

使用 GroupDocs.Signature 在 Java 中為 TAR 壓縮檔簽署條碼與 QR 代碼

是的，您也可以為壓縮檔簽署！學習如何在 TAR 檔案中加入條碼簽章，以安全分發文件套件。非常適合軟體發佈、資料套件或安全檔案傳輸。

使用 GroupDocs.Signature for Java 在 ZIP 檔中驗證條碼簽章

透過驗證 ZIP 檔內的條碼簽章，確保封存文件的完整性。本教學涵蓋批次驗證工作流程以及如何驗證壓縮文件套件——對於合規稽核或自動化品質檢查非常有用。

條碼簽章最佳實踐

  • 保持條碼內容簡短 – 雖然 QR 代碼可容納上千字元，但較小的條碼掃描更快，且在較低解析度下呈現更清晰。除非需要大型資料集，建議不超過 500 個字元。
  • 在生產前測試掃描 – 並非所有條碼讀取器都能同等良好地處理每種格式。請使用使用者實際擁有的掃描器（智慧手機相機、專用讀取器等）測試條碼。
  • 位置很重要 – 在所有文件中將條碼放置於一致的位置（例如右下角）。這可大幅提升自動掃描的可靠性。
  • 使用錯誤更正 – QR 代碼與 Data Matrix 條碼支援錯誤更正等級。較高等級（如 QR 的 “H” 級）即使有 30 % 損毀或遮蔽仍能正常讀取。
  • 結合視覺簽章 – 對於同時需要人工與機器驗證的文件，可在傳統數位簽章旁加入條碼。如此可同時獲得自動化優勢與法律效力。
  • 優雅處理驗證失敗 – 在處理文件前務必檢查條碼驗證是否成功。無效條碼可能表示被竄改——將此類事件記錄下來以供安全稽核。

常見問與答

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 在 Java 中建立 QR 代碼簽章相當簡單。依照上述步驟，即可將安全、機器可讀的資料嵌入任何支援的文件類型，實現資料自動擷取並保證文件完整性。探索相關教學以深入了解——無論是大規模管理條碼、在壓縮檔中驗證，或遵循 HIBC、GS1 等行業特定標準，都能滿足需求。

最後更新： 2026-06-21
測試環境： GroupDocs.Signature for Java 23.12（撰寫時的最新版本）
作者： GroupDocs

相關教學