Tạo PDF Data Matrix với Mã vạch HIBC trong Java

Nếu bạn đang xây dựng phần mềm logistics dược phẩm hoặc chăm sóc sức khỏe, có thể bạn đã gặp phải vấn đề theo dõi bằng giấy, chữ ký mất, và những cơn ác mộng kiểm toán. Tạo PDF Data Matrix nhúng mã vạch HIBC LIC giải quyết những vấn đề này bằng cách cung cấp một dấu vết không thể bị giả mạo, có thể đọc bằng máy, tồn tại qua việc in, quét và kiểm tra quy định. Trong hướng dẫn này, bạn sẽ thấy chính xác cách thêm hỗ trợ PDF mã QR, cũng như các định dạng Aztec và Data Matrix, bằng cách sử dụng GroupDocs.Signature cho Java.

Câu trả lời nhanh

  • Thư viện nào xử lý mã vạch HIBC trong Java? GroupDocs.Signature for Java.
  • Định dạng mã vạch nào gọn nhất? Data Matrix – lý tưởng cho nhãn nhỏ.
  • Tôi có thể thêm cả QR và Data Matrix vào cùng một PDF không? Có, chỉ cần tạo các QrCodeSignOptions riêng biệt.
  • Tôi có cần kết nối internet khi chạy không? Không, thư viện hoạt động hoàn toàn offline sau khi cài đặt.
  • Phiên bản Java nào được khuyến nghị? Java 11+ cho hiệu suất cấp sản xuất.

Chữ ký PDF mã vạch HIBC là gì?

Lớp Signature trong GroupDocs.Signature cho Java đại diện cho một tài liệu PDF và cung cấp các phương thức để nhúng mã vạch HIBC như chữ ký số. Bằng cách ký một PDF với mã vạch HIBC, bạn tạo ra một bản ghi có thể xác minh, không thể bị giả mạo và có thể được quét ở bất kỳ điểm nào trong chuỗi cung ứng.

Tại sao lại sử dụng Data Matrix và mã QR cùng nhau?

GroupDocs.Signature hỗ trợ hơn 50 định dạng đầu vào và đầu ra và có thể xử lý các PDF hàng trăm trang mà không cần tải toàn bộ tệp vào bộ nhớ. Sử dụng Data Matrix cho các nhãn dày đặc, diện tích nhỏ và QR cho các tài liệu rộng rãi hơn mang lại sự cân bằng tốt nhất giữa khả năng đọc, dung lượng dữ liệu (lên tới 4.296 ký tự cho QR) và hiệu quả sử dụng không gian in.

Yêu cầu trước

  • JDK 11 hoặc cao hơn (Java 8 vẫn hoạt động nhưng Java 11+ được khuyến nghị để đạt hiệu suất tối ưu).
  • IDE như IntelliJ IDEA, Eclipse, hoặc VS Code với các tiện ích mở rộng Java.
  • Maven hoặc Gradle để quản lý phụ thuộc (các ví dụ bên dưới).
  • PDF mẫu (ví dụ, sample.pdf) để kiểm tra triển khai.
  • Giấy phép GroupDocs.Signature hợp lệ (bản dùng thử miễn phí cho phát triển, giấy phép trả phí cho sản xuất).

Cài đặt GroupDocs.Signature cho Java

Cấu hình Maven

Thêm phụ thuộc vào pom.xml của bạn:

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

Cấu hình Gradle

Đối với các dự án Gradle, thêm đoạn này vào build.gradle của bạn:

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

Tùy chọn tải xuống trực tiếp

Bạn cũng có thể tải tệp JAR trực tiếp từ GroupDocs.Signature for Java releases và thêm nó vào classpath của dự án một cách thủ công. Cách tiếp cận này hoạt động tốt trong môi trường mạng hạn chế.

Nhận giấy phép

Yêu cầu bản dùng thử miễn phí hoặc giấy phép tạm thời từ GroupDocs để loại bỏ watermark và mở khóa tất cả tính năng. Triển khai sản xuất yêu cầu mua giấy phép.

Khởi tạo cơ bản

Lớp Signature là điểm khởi đầu cho tất cả các thao tác ký. Nó tải PDF, áp dụng mã vạch và ghi tệp đã ký.

import com.groupdocs.signature.Signature;

class InitializeSignature {
    public static void main(String[] args) {
        Signature signature = new Signature("sample.pdf");
        // Proceed with signing operations...
    }
}

Cách tạo PDF Data Matrix với mã vạch HIBC?

Tải PDF nguồn của bạn, cấu hình đối tượng QrCodeSignOptions cho định dạng Data Matrix, và gọi sign() – đó là tất cả những gì bạn cần để nhúng mã vạch HIBC Data Matrix tuân thủ. Các bước sau sẽ hướng dẫn bạn qua mã chính xác cần thiết. QrCodeSignOptions định nghĩa các cài đặt cho chữ ký mã vạch, như loại, nội dung, kích thước và vị trí.

  1. Nhập các lớp cần thiết – chúng cho phép bạn truy cập vào engine ký và các tùy chọn Data Matrix.
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.QrCodeSignOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;
  1. Tạo đối tượng Signature với đường dẫn tuyệt đối cho tệp nguồn và đích.
String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY";
String destinFilePath = "YOUR_OUTPUT_DIRECTORY/SignWithHIBCLICQR.pdf";

final Signature signature = new Signature(sourceFilePath);
  1. Cấu hình các tùy chọn Data Matrix – đặt chuỗi HIBC, chọn QrCodeTypes.HIBCLICDataMatrix, và xác định tọa độ đặt. QrCodeTypes liệt kê các định dạng mã vạch được hỗ trợ cho chữ ký HIBC.
QrCodeSignOptions hibcLic_QR = new QrCodeSignOptions("A123PROD30917/75#422011907#GP293", QrCodeTypes.HIBCLICQR);
hibcLic_QR.setLeft(1); // Set the position from left
hibcLic_QR.setTop(1);   // Set the position from top
hibcLic_QR.setReturnContent(true); // Return content after signing
hibcLic_QR.setReturnContentType(FileType.PNG); // Specify return content type as PNG
  1. Áp dụng chữ ký vào PDF.
signature.sign(destinFilePath, hibcLic_QR);
  1. Giải phóng tài nguyên để giải phóng các handle tệp và tránh rò rỉ bộ nhớ.
finally {
    if (signature != null) signature.dispose();
}

Ví dụ làm việc đầy đủ

Đây là toàn bộ luồng trong một khối duy nhất (các placeholder đại diện cho mã chính xác bạn sẽ dán từ các đoạn mã trước):

import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.QrCodeSignOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;

public class HibcQrSigning {
    public static void main(String[] args) {
        String sourceFilePath = "sample.pdf";
        String destinFilePath = "output/SignWithHIBCLICQR.pdf";
        
        Signature signature = null;
        try {
            signature = new Signature(sourceFilePath);
            
            QrCodeSignOptions hibcLic_QR = new QrCodeSignOptions(
                "A123PROD30917/75#422011907#GP293", 
                QrCodeTypes.HIBCLICQR
            );
            hibcLic_QR.setLeft(1);
            hibcLic_QR.setTop(1);
            hibcLic_QR.setReturnContent(true);
            hibcLic_QR.setReturnContentType(FileType.PNG);
            
            signature.sign(destinFilePath, hibcLic_QR);
            System.out.println("PDF signed successfully with HIBC QR code");
            
        } catch (Exception e) {
            System.err.println("Error signing PDF: " + e.getMessage());
            e.printStackTrace();
        } finally {
            if (signature != null) signature.dispose();
        }
    }
}

Câu trả lời trực tiếp (40–70 từ)

Để tạo PDF Data Matrix, khởi tạo Signature với PDF nguồn của bạn, đặt QrCodeSignOptions thành QrCodeTypes.HIBCLICDataMatrix và cung cấp một chuỗi HIBC được định dạng đúng, sau đó gọi signature.sign(outputPath, options). Thư viện sẽ ghi PDF đã ký vào đích, giữ nguyên bố cục và nhúng mã vạch như một chữ ký không thể bị giả mạo.

Cách thêm PDF mã QR bằng GroupDocs.Signature?

Tải PDF, cấu hình QrCodeSignOptions cho định dạng QR, và gọi sign(). Mẫu hai dòng này hoạt động cho bất kỳ kích thước PDF nào và tự động điều chỉnh kích thước hình ảnh QR để đạt độ đọc tối ưu. QrCodeSignOptions cấu hình chữ ký mã QR, bao gồm nội dung và thuộc tính hiển thị. Nó đặt mã dựa trên tọa độ bạn thiết lập, đảm bảo không chồng lên nội dung hiện có và vẫn có thể quét sau khi in.

  1. Nhập các lớp đặc thù QR
QrCodeSignOptions hibcLic_AZ = new QrCodeSignOptions("A123PROD30917/75#422011907#GP293", QrCodeTypes.HIBCLICAztec);
hibcLic_AZ.setLeft(1); // Set the position from left
hibcLic_AZ.setTop(200); // Set the position from top
hibcLic_AZ.setReturnContent(true); // Return content after signing
hibcLic_AZ.setReturnContentType(FileType.PNG); // Specify return content type as PNG
  1. Tạo và cấu hình tùy chọn QR – lưu ý việc sử dụng QrCodeTypes.HIBCLICQR.
signature.sign(destinFilePath, hibcLic_AZ);
  1. Ký tài liệu
QrCodeSignOptions hibcLic_DM = new QrCodeSignOptions("A123PROD30917/75#422011907#GP293", QrCodeTypes.HIBCLICDataMatrix);
hibcLic_DM.setLeft(1); // Set the position from left
hibcLic_DM.setTop(400); // Set the position from top
hibcLic_DM.setReturnContent(true); // Return content after signing
hibcLic_DM.setReturnContentType(FileType.PNG); // Specify return content type as PNG

Câu trả lời trực tiếp: Sử dụng QrCodeTypes.HIBCLICQR trong QrCodeSignOptions, đặt chuỗi nội dung HIBC, định vị mã bằng setLeft() và setTop(), sau đó gọi signature.sign(outputPath, options). Mã QR được nhúng ngay lập tức, sẵn sàng cho việc chụp bằng điện thoại thông minh hoặc máy quét.

Những sai lầm thường gặp cần tránh

1. Quên giải phóng tài nguyên

Sai:

Signature signature = new Signature("sample.pdf");
signature.sign(destinFilePath, options);
// Oops, no dispose() call

Sửa: Bao quanh việc sử dụng Signature trong khối try‑with‑resources hoặc gọi close() một cách rõ ràng trong khối finally.

2. Sử dụng chuỗi định dạng HIBC không đúng

Sai: Sử dụng các chuỗi chung như “12345”.
Sửa: Tuân theo tiêu chuẩn HIBCC (ví dụ, A123PROD30917/75#422011907#GP293). Xác thực với HIBCC online validator.

3. Ghi cứng đường dẫn tệp

Sai:

String sourceFilePath = "C:/Users/John/Documents/test.pdf";

Sửa: Lưu đường dẫn trong tệp cấu hình hoặc biến môi trường và đọc chúng khi chạy.

4. Bỏ qua xung đột vị trí mã vạch

Đặt mã vạch xa khỏi văn bản hoặc chữ ký hiện có. Sử dụng tọa độ PDF (gốc ở góc dưới‑trái) và kiểm tra với mẫu đã in.

5. Không kiểm tra với máy quét thực tế

In PDF đã ký và quét nó bằng phần cứng chính xác được sử dụng trong quy trình của bạn. Xác minh độ đọc ở các chất lượng in khác nhau.

Ứng dụng thực tiễn trong chăm sóc sức khỏe

ScenarioRecommended BarcodeWhy it fits
Phân phối dược phẩmQR CodeDung lượng dữ liệu cao, được quét rộng rãi bằng điện thoại thông minh.
Quản lý tồn khoData MatrixDiện tích nhỏ, lý tưởng cho nhãn kệ dày đặc.
Tuân thủ quy định (FDA 21 CFR Part 11)QR + Data MatrixĐịnh dạng kép cung cấp tính dư thừa và khả năng kiểm toán.
Theo dõi thiết bị y tếAztec CodeKích thước gọn nhẹ phù hợp với bao bì không gian hạn chế.

Các cân nhắc về hiệu suất và thực hành tốt nhất

Mẫu xử lý hàng loạt

List<String> filesToSign = getFileList();
for (String filePath : filesToSign) {
    Signature signature = null;
    try {
        signature = new Signature(filePath);
        // Sign and save
    } finally {
        if (signature != null) signature.dispose();
    }
}
  • Tạo một thể hiện Signature mới cho mỗi tệp để giữ mức sử dụng bộ nhớ thấp.
  • Sử dụng một pool luồng cố định (Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors() - 1)) cho xử lý song song, nhưng giám sát kích thước heap vì mỗi Signature giữ toàn bộ PDF trong bộ nhớ.

Giữ thư viện luôn cập nhật

Các bản phát hành của GroupDocs cải thiện tốc độ xử lý lên tới 20 % và thêm các tính năng tuân thủ HIBC mới. Lên lịch kiểm tra phụ thuộc hàng quý.

Bộ nhớ đệm mẫu

Tải một mẫu PDF một lần, sao chép nó cho mỗi biến thể mã vạch, và ký các bản sao. Điều này giảm I/O và tăng tốc quy trình làm việc khối lượng lớn.

Câu hỏi thường gặp

Q: GroupDocs.Signature có thể ký các loại tệp khác ngoài PDF không?
A: Có, nó cũng hỗ trợ DOCX, XLSX, PPTX, PNG, JPEG và TIFF với cùng API ký mã vạch.

Q: Làm thế nào để khắc phục lỗi “Invalid barcode content”?
A: Xác minh rằng chuỗi HIBC của bạn tuân theo cú pháp HIBCC chính xác, sử dụng trình xác thực trực tuyến, và đảm bảo bạn đang sử dụng hằng số QrCodeTypes đúng cho định dạng đã chọn.

Q: Dung lượng dữ liệu tối đa cho mỗi định dạng HIBC là bao nhiêu?
A: QR ≈ 4.296 ký tự alphanumeric, Aztec ≈ 3.832 số / 3.067 alphanumeric, Data Matrix ≈ 3.116 số / 2.335 alphanumeric. Giữ mã dưới 200 ký tự để độ tin cậy quét tối ưu.

Q: Có thể nhúng nhiều loại mã vạch trong một PDF không?
A: Chắc chắn. Tạo các đối tượng QrCodeSignOptions riêng biệt với vị trí khác nhau và gọi signature.sign() cho mỗi cái. Chỉ cần đảm bảo chúng không chồng lên nhau.

Q: Tôi có cần kết nối internet để ký tại thời gian chạy không?
A: Không. Sau khi JAR nằm trong classpath và giấy phép được kích hoạt, tất cả các thao tác được thực hiện cục bộ.

Tài nguyên bổ sung

Cập nhật lần cuối: 2026-05-16
Kiểm tra với: GroupDocs.Signature 23.12 cho Java
Tác giả: GroupDocs

signature.sign(destinFilePath, hibcLic_DM);

Các hướng dẫn liên quan