Tạo chữ ký mã vạch java – cập nhật mã vạch PDF

Khi bạn cần di chuyển vị trí mã vạch trên hàng ngàn nhãn vận chuyển hoặc điều chỉnh vị trí mã vạch sau khi thiết kế lại mẫu, việc thực hiện thủ công dễ gây lỗi và tốn thời gian. Trong hướng dẫn này, bạn sẽ học cách tạo chữ ký mã vạch java và sau đó chỉnh sửa vị trí, kích thước và các thuộc tính khác một cách lập trình bằng GroupDocs.Signature cho Java. Phương pháp này hoạt động với PDF, Word, Excel, PowerPoint và các tệp hình ảnh, cung cấp cho bạn một API duy nhất, nhất quán cho tất cả các kịch bản tự động hoá tài liệu của bạn.

Câu trả lời nhanh

Tạo chữ ký mã vạch có nghĩa là gì? Nó có nghĩa là tạo một đối tượng BarcodeSignature có thể được đặt, di chuyển hoặc chỉnh sửa bên trong tài liệu thông qua API.
Tôi có thể thay đổi kích thước mã vạch sau khi tạo không? Có – sử dụng setWidth/setHeight hoặc điều chỉnh các tọa độ Left/Top.
Tôi có cần giấy phép để cập nhật mã vạch không? Bản dùng thử hoạt động cho phát triển; giấy phép đầy đủ cần thiết cho môi trường sản xuất.
Điều này chỉ hoạt động với PDF không? Không – cùng một đoạn mã hoạt động với Word, Excel, PowerPoint và các định dạng hình ảnh phổ biến.
Tôi có thể xử lý bao nhiêu tài liệu cùng lúc? Xử lý hàng loạt được hỗ trợ; chỉ cần quản lý bộ nhớ bằng try‑with‑resources.

Tạo chữ ký mã vạch java là gì?

Tạo chữ ký mã vạch java là quá trình khởi tạo một đối tượng BarcodeSignature đại diện cho một mã vạch được nhúng như một chữ ký kỹ thuật số trong tài liệu. Sử dụng API GroupDocs.Signature, bạn có thể lập trình thêm một mã vạch mới, tìm vị trí các mã vạch hiện có, hoặc chỉnh sửa các thuộc tính của chúng như vị trí, kích thước và nội dung đã mã hoá, mà không cần mở tệp trong trình chỉnh sửa trực quan.

Tại sao nên sử dụng GroupDocs.Signature cho Java?

GroupDocs.Signature hỗ trợ hơn 50 định dạng đầu vào và đầu ra—bao gồm PDF, DOCX, XLSX, PPTX và các loại hình ảnh phổ biến—và có thể xử lý các PDF hàng trăm trang trong khi giữ mức sử dụng bộ nhớ dưới 100 MB. API xử lý hàng loạt của nó có thể xử lý tới 10.000 tài liệu mỗi lần chạy trên một máy chủ tiêu chuẩn, giúp việc cập nhật quy mô lớn khả thi.

Yêu cầu trước

GroupDocs.Signature cho Java ≥ 23.12 (các phiên bản trước thiếu các phương thức cập nhật được sử dụng ở đây).
Java Development Kit 8 hoặc cao hơn.
Một IDE như IntelliJ IDEA, Eclipse, hoặc VS Code.
Kiến thức cơ bản về Java (lớp, đối tượng, xử lý ngoại lệ).

Thư viện cần thiết

Thêm GroupDocs.Signature vào dự án của bạn bằng công cụ xây dựng ưa thích.

Maven

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

Gradle

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

Direct download – tải JAR mới nhất từ GroupDocs.Signature for Java releases và thêm vào classpath của bạn.

Nhận giấy phép

GroupDocs.Signature hoạt động với cả bản dùng thử và giấy phép đầy đủ:

Free trial – lý tưởng cho công việc chứng minh khái niệm.
Temporary license – cho việc đánh giá kéo dài trên một dự án cụ thể.
Full license – loại bỏ watermark và giới hạn sử dụng cho môi trường sản xuất.

Pro tip: Bắt đầu với bản dùng thử miễn phí, sau đó nâng cấp khi bạn đã xác nhận quy trình làm việc.

Cách tạo chữ ký mã vạch java

Bước 1: khởi tạo thể hiện signature

Signature là lớp đầu vào chính, tải tài liệu và cung cấp các phương thức để tìm kiếm, thêm và cập nhật chữ ký.

Direct answer

Tạo một đối tượng Signature bằng cách truyền đường dẫn của tài liệu bạn muốn chỉnh sửa; điều này sẽ tải tệp vào bộ nhớ và chuẩn bị cho các thao tác mã vạch. Lớp Signature là cổng vào cho tất cả các hành động liên quan đến chữ ký. Nó đọc tệp và cung cấp các phương thức để tìm kiếm, thêm hoặc cập nhật chữ ký.

import com.groupdocs.signature.Signature;
import java.nio.file.Paths;

String filePath = "YOUR_DOCUMENT_DIRECTORY/your_document.pdf";

Signature signature = new Signature(filePath);

Pro tip: Xác thực đường dẫn tệp trước khi tạo thể hiện Signature để tránh FileNotFoundException.

Bước 2: tìm kiếm chữ ký mã vạch

BarcodeSearchOptions định nghĩa tiêu chí được sử dụng khi quét tài liệu để tìm chữ ký mã vạch.

Direct answer

Sử dụng BarcodeSearchOptions cùng với phương thức search để lấy danh sách tất cả các chữ ký mã vạch trong tài liệu. Bạn không thể cập nhật những gì bạn không thể tìm thấy. GroupDocs.Signature cung cấp một API tìm kiếm mạnh mẽ cho phép lọc chữ ký theo loại, số trang hoặc định dạng mã vạch.

import com.groupdocs.signature.options.search.BarcodeSearchOptions;
import com.groupdocs.signature.domain.signatures.BarcodeSignature;
import java.util.List;

BarcodeSearchOptions options = new BarcodeSearchOptions();

List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

Bạn hiện có danh sách các đối tượng BarcodeSignature, mỗi đối tượng cung cấp các thuộc tính như Left, Top, Width, Height, Text và EncodeType.

Performance note: Đối với các PDF rất lớn, hãy thu hẹp phạm vi tìm kiếm tới các trang hoặc loại mã vạch cụ thể để tăng tốc thực thi.

Bước 3: cập nhật thuộc tính mã vạch

BarcodeSignature đại diện cho một mã vạch riêng lẻ được nhúng trong tài liệu và cung cấp các setter cho các thuộc tính hiển thị của nó.

Direct answer

Chỉnh sửa Left, Top, Width, và Height của BarcodeSignature đã lấy được và gọi signature.update để ghi các thay đổi vào một tệp mới. Điều này cho phép bạn thay đổi kích thước mã vạch hoặc di chuyển vị trí của nó bất cứ nơi nào bạn cần, trong khi tệp nguồn gốc vẫn không bị thay đổi.

import java.io.File;
import com.groupdocs.signature.exception.GroupDocsSignatureException;

String fileName = Paths.get(filePath).getFileName().toString();
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY/UpdateBarcode/" + fileName).getPath();
checkDir(outputFilePath);

if (signatures.size() > 0) {
    BarcodeSignature barcodeSignature = signatures.get(0);
    
    // Update the barcode's position and size
    barcodeSignature.setLeft(100);
    barcodeSignature.setTop(100);
    
    // Apply the changes to the document
    boolean result = signature.update(outputFilePath, barcodeSignature);
    
    if (result) {
        System.out.println("Signature with Barcode '" +
            barcodeSignature.getText() + "' and encode type '"+
            barcodeSignature.getEncodeType().getTypeName() + "' was updated in the document ['" +
            fileName + "'].");
    }
} catch (GroupDocsSignatureException e) {
    System.err.println("Error updating signature: " + e.getMessage());
}

Các điểm chính

setLeft / setTop di chuyển mã vạch (tọa độ đo từ góc trên‑trái).
update ghi một tệp mới; tệp gốc vẫn không thay đổi.
Bao bọc lời gọi trong một khối try‑catch để xử lý GroupDocsSignatureException có thể xảy ra.

Khi nào bạn nên cập nhật chữ ký mã vạch?

Bạn nên cập nhật chữ ký mã vạch bất cứ khi nào bố cục tài liệu thay đổi, yêu cầu quy định thay đổi, hoặc bạn cần xử lý hàng loạt các tệp hiện có sau khi di chuyển dữ liệu. Cập nhật bằng lập trình tránh việc chỉnh sửa thủ công, giảm tỷ lệ lỗi và đảm bảo vị trí nhất quán trên hàng ngàn tệp.

Các vấn đề thường gặp & giải pháp

Vấn đề 1: “Không tìm thấy chữ ký mã vạch”

Symptom: Tìm kiếm trả về danh sách rỗng mặc dù các mã vạch hiển thị trong PDF.

Nguyên nhân có thể

Mã vạch được nhúng dưới dạng hình ảnh hoặc trường biểu mẫu, không phải là đối tượng chữ ký.
Tài liệu được bảo vệ bằng mật khẩu.
Bạn đang lọc theo một loại mã vạch cụ thể không khớp.

Giải pháp

BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setAllPages(true); // Search all pages, not just the first
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

if (signatures.isEmpty()) {
    System.out.println("No barcode signatures found. The barcodes might be images, not signature objects.");
}

Vấn đề 2: Tài liệu đã cập nhật bị hỏng

Symptom: PDF không mở được sau khi cập nhật.

Nguyên nhân có thể

Không đủ dung lượng đĩa.
Thư mục đầu ra không tồn tại.
Quyền hệ thống tệp ngăn ghi.

Giải pháp

File outputDir = new File("YOUR_OUTPUT_DIRECTORY/UpdateBarcode/");
if (!outputDir.exists()) {
    outputDir.mkdirs(); // Create directories if they don't exist
}

// Check write permissions
if (!outputDir.canWrite()) {
    throw new IOException("Cannot write to output directory: " + outputDir.getAbsolutePath());
}

Vấn đề 3: Giảm hiệu năng với tài liệu lớn

Symptom: Quá trình xử lý chậm đáng kể đối với PDF trên khoảng 50 trang.

Giải pháp

BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setPageNumber(1); // Start with page 1
options.setPagesSetup(new PagesSetup());
options.getPagesSetup().setFirstPage(true);
options.getPagesSetup().setLastPage(false);

Mẹo tối ưu hoá hiệu năng

Quản lý bộ nhớ cho các thao tác batch

Xử lý một tài liệu tại một thời điểm và để Java tự động giải phóng tài nguyên:

List<String> documentPaths = getDocumentList();
for (String path : documentPaths) {
    try (Signature sig = new Signature(path)) {
        // Process one document at a time
        // Signature instance is auto‑closed after each iteration
    }
}

Lưu trữ kết quả tìm kiếm

Nếu bạn cần chỉnh sửa nhiều thuộc tính trên cùng một mã vạch, hãy tìm kiếm một lần và tái sử dụng danh sách:

List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

// Update multiple properties
for (BarcodeSignature barcode : signatures) {
    barcode.setLeft(100);
    barcode.setTop(100);
    barcode.setWidth(200);
    barcode.setHeight(50);
}

// Single update call with all changes
signature.update(outputPath, signatures);

Xử lý song song cho các batch lớn

Tận dụng Java streams để tăng tốc xử lý hàng ngàn tài liệu:

documentPaths.parallelStream().forEach(path -> {
    try (Signature sig = new Signature(path)) {
        List<BarcodeSignature> barcodes = sig.search(BarcodeSignature.class, new BarcodeSearchOptions());
        if (!barcodes.isEmpty()) {
            BarcodeSignature barcode = barcodes.get(0);
            barcode.setLeft(50);  // New position for smaller boxes
            barcode.setTop(10);
            sig.update(generateOutputPath(path), barcode);
        }
    } catch (Exception e) {
        logError(path, e);
    }
});

Ứng dụng thực tiễn

Trường hợp sử dụng 1: cập nhật nhãn logistics tự động

Một công ty vận chuyển thay đổi kích thước hộp, yêu cầu di chuyển vị trí mã vạch trên 50.000 nhãn hiện có. Đoạn mã xử lý song song ở trên đã giảm thời gian công việc từ vài ngày xuống chỉ vài giờ.

Trường hợp sử dụng 2: chuẩn hoá mẫu hợp đồng

Tư vấn pháp lý yêu cầu vị trí mã vạch cố định để quét. Bằng cách tìm kiếm và cập nhật tất cả các PDF hợp đồng trong một batch duy nhất, đội ngũ đã tránh được việc in lại tốn kém.

Trường hợp sử dụng 3: tích hợp hệ thống tồn kho

Sau khi nâng cấp ERP, mã vạch sản phẩm cần căn chỉnh với máy in nhãn mới. Cập nhật kích thước và vị trí mã vạch bằng lập trình đã tiết kiệm thời gian và chi phí vật liệu.

Danh sách kiểm tra khắc phục sự cố

Trước khi liên hệ hỗ trợ, hãy kiểm tra danh sách này:

Đường dẫn tệp đúng và tệp tồn tại.
Quyền đọc/ghi đã được cấp cho nguồn và đích.
Phiên bản GroupDocs.Signature là 23.12 hoặc mới hơn.
Giấy phép được cấu hình đúng (nếu sử dụng giấy phép đầy đủ).
Thư mục đầu ra tồn tại hoặc được tạo bằng chương trình.
Đủ dung lượng đĩa cho các tệp đầu ra.
Không có tiến trình nào khác đang khóa tệp nguồn.
Xử lý ngoại lệ đã được thiết lập để bắt lỗi.

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

Q: Tôi có thể cập nhật mã Java cho chữ ký mã vạch cho nhiều mã vạch trong một tài liệu không?
A: Chắc chắn. Lặp qua List<BarcodeSignature> trả về từ tìm kiếm và gọi signature.update() cho mỗi mã, hoặc truyền toàn bộ danh sách vào một lời gọi update duy nhất.

Q: GroupDocs.Signature hỗ trợ những loại mã vạch nào?
A: Hàng chục loại, bao gồm Code 128, QR Code, EAN‑13, UPC‑A, DataMatrix, PDF417, và nhiều hơn nữa. Sử dụng barcodeSignature.getEncodeType() để kiểm tra loại.

Q: Tôi có thể thay đổi nội dung thực tế của mã vạch (dữ liệu đã mã hoá) không?
A: Có, thông qua setText(), nhưng nhớ tạo lại mã vạch hiển thị để máy quét đọc đúng.

Q: Làm thế nào để xử lý tài liệu có mã vạch trên nhiều trang?
A: Mỗi BarcodeSignature bao gồm getPageNumber(). Lọc hoặc xử lý các mã vạch theo trang khi cần.

Q: Điều gì xảy ra với tài liệu gốc sau khi cập nhật?
A: Tệp nguồn vẫn không bị thay đổi. GroupDocs ghi các thay đổi vào đường dẫn đầu ra bạn chỉ định, giữ nguyên bản gốc để an toàn.

Q: Tôi có thể cập nhật mã vạch trong PDF được bảo vệ bằng mật khẩu không?
A: Có. Sử dụng overload LoadOptions của hàm tạo Signature để cung cấp mật khẩu.

Q: Làm thế nào để xử lý hàng ngàn tài liệu hàng loạt một cách hiệu quả?
A: Kết hợp parallel streams với try‑with‑resources (như trong ví dụ xử lý song song) và giám sát việc sử dụng bộ nhớ.

Q: Điều này có hoạt động với các định dạng khác ngoài PDF không?
A: Có. Cùng một API hoạt động với Word, Excel, PowerPoint, hình ảnh và nhiều định dạng khác được GroupDocs.Signature hỗ trợ.

Kết luận

Bạn giờ đã có một hướng dẫn đầy đủ, sẵn sàng cho sản xuất để tạo chữ ký mã vạch java và cập nhật vị trí, kích thước và các thuộc tính khác của chúng. Chúng tôi đã đề cập đến khởi tạo, tìm kiếm, sửa đổi, khắc phục sự cố và tối ưu hoá hiệu năng cho cả trường hợp tài liệu đơn lẻ và batch quy mô lớn.

Các bước tiếp theo

Thử nghiệm cập nhật các thuộc tính bổ sung như xoay hoặc độ trong suốt trong cùng một lần chạy.
Đóng gói logic trong một dịch vụ REST để cung cấp cập nhật mã vạch như một endpoint API.
Khám phá các loại chữ ký khác (văn bản, hình ảnh, kỹ thuật số) bằng cùng mẫu để tự động hoá toàn bộ quy trình công việc tài liệu của bạn.

Resources

Last Updated: 2026-08-19
Tested With: GroupDocs.Signature 23.12
Author: GroupDocs

Tạo chữ ký mã vạch java – cập nhật mã vạch PDF

Câu trả lời nhanh

Tạo chữ ký mã vạch java là gì?

Tại sao nên sử dụng GroupDocs.Signature cho Java?

Yêu cầu trước

Thư viện cần thiết

Nhận giấy phép

Cách tạo chữ ký mã vạch java

Bước 1: khởi tạo thể hiện signature

Direct answer

Bước 2: tìm kiếm chữ ký mã vạch

Direct answer

Bước 3: cập nhật thuộc tính mã vạch

Direct answer

Khi nào bạn nên cập nhật chữ ký mã vạch?

Các vấn đề thường gặp & giải pháp

Vấn đề 1: “Không tìm thấy chữ ký mã vạch”

Vấn đề 2: Tài liệu đã cập nhật bị hỏng

Vấn đề 3: Giảm hiệu năng với tài liệu lớn

Mẹo tối ưu hoá hiệu năng

Quản lý bộ nhớ cho các thao tác batch

Lưu trữ kết quả tìm kiếm

Xử lý song song cho các batch lớn

Ứng dụng thực tiễn

Trường hợp sử dụng 1: cập nhật nhãn logistics tự động

Trường hợp sử dụng 2: chuẩn hoá mẫu hợp đồng

Trường hợp sử dụng 3: tích hợp hệ thống tồn kho

Danh sách kiểm tra khắc phục sự cố

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

Kết luận

Các bước tiếp theo

Hướng dẫn liên quan