Cách ký các tệp Java bằng mã vạch và mã QR
Giới thiệu
Bạn đã bao giờ tự hỏi làm thế nào để chứng minh các tệp của mình không bị thay đổi bằng các kỹ thuật how to sign java? Hoặc cần một cách để xác thực tài liệu một cách lập trình mà không cần thiết lập mật mã phức tạp? Chữ ký số truyền thống có thể quá mức đối với một số trường hợp. Đôi khi bạn chỉ cần một phương pháp nhẹ, có thể quét để xác minh tính toàn vẹn của tệp—đặc biệt khi làm việc với các kho lưu trữ, bản sao lưu hoặc quy trình tự động. Đó là nơi các chữ ký bằng mã vạch và mã QR xuất hiện.
Trong hướng dẫn này, bạn sẽ học cách triển khai how to sign java bằng GroupDocs.Signature. Chúng tôi sẽ tập trung vào việc ký các tệp TAR (hoàn hảo cho hệ thống sao lưu và phân phối phần mềm), nhưng các kỹ thuật này hoạt động với nhiều định dạng tài liệu khác nhau. Dù bạn đang xây dựng hệ thống quản lý tài liệu hay chỉ muốn thêm một lớp bảo mật bổ sung cho các tệp của mình, bạn đã đến đúng nơi.
Bạn sẽ nhận được:
- Một triển khai hoạt động của chữ ký mã vạch và mã QR trong Java
- Hiểu khi nào nên sử dụng mỗi loại chữ ký (và lý do quan trọng)
- Các giải pháp thực tế cho các thách thức ký thường gặp
- Mẫu tích hợp thực tế mà bạn có thể sử dụng ngay hôm nay
- Mẹo tối ưu hiệu năng cho hệ thống sản xuất
Hãy bắt đầu—không cần bằng cấp về mật mã.
Câu trả lời nhanh
- Thư viện nào xử lý chữ ký mã vạch trong Java? GroupDocs.Signature for Java.
- Loại chữ ký nào lưu trữ nhiều dữ liệu hơn? Mã QR (tối đa 4.296 ký tự chữ và số).
- Tôi có thể ký các tệp TAR lớn (>100 MB) không? Có—sử dụng luồng nền và tăng bộ nhớ heap của JVM.
- Có cần kết nối internet không? Không, thư viện hoạt động hoàn toàn offline.
- Có cần giấy phép cho môi trường sản xuất không? Có, cần giấy phép GroupDocs.Signature hợp lệ.
Chữ ký số Java là gì?
Chữ ký số Java là quá trình nhúng một token hình ảnh có thể xác minh—như mã vạch hoặc mã QR—trực tiếp vào tệp được tạo bằng Java để chứng minh tính xác thực và toàn vẹn của nó, cung cấp bằng chứng nhanh, có thể đọc được bởi con người rằng tệp không bị thay đổi kể từ khi ký đồng thời vẫn cho phép xác minh lập trình thông qua API của GroupDocs.Signature.
Tại sao nên sử dụng chữ ký bằng mã vạch hoặc mã QR?
GroupDocs.Signature hỗ trợ hơn 50 định dạng đầu vào và đầu ra (bao gồm PDF, DOCX, XLSX, HTML, PNG và TAR) và có thể xử lý các tài liệu hàng trăm trang mà không cần tải toàn bộ tệp vào bộ nhớ. Mã vạch và mã QR cung cấp cho bạn bằng chứng xác thực có thể quét, tự chứa, loại bỏ nhu cầu sử dụng các cơ quan chứng chỉ bên ngoài trong nhiều quy trình nội bộ.
| Yếu tố | Mã vạch (Code128) | Mã QR |
|---|---|---|
| Dung lượng dữ liệu | ~80 ký tự | Lên tới 4.296 ký tự chữ và số |
| Khả năng đọc | Cần máy quét mã vạch | Hoạt động với camera điện thoại thông minh |
| Hiệu quả không gian | Nhỏ gọn hơn theo chiều ngang | Cần khu vực hình vuông |
| Thích hợp cho | ID đơn giản, dấu thời gian, mã ngắn | URL, dữ liệu JSON, siêu dữ liệu chi tiết |
| Sửa lỗi | Tối thiểu | Tích hợp (có thể phục hồi sau hư hỏng) |
Nguyên tắc chung:
- Sử dụng mã vạch cho các ID hoặc dấu thời gian nhanh, có thể quét.
- Sử dụng mã QR khi bạn cần nhúng dữ liệu phong phú hơn hoặc muốn tương thích với điện thoại thông minh.
- Kết hợp cả hai để đạt độ dư thừa và khả năng kiểm toán tối đa.
Yêu cầu trước
- Thư viện GroupDocs.Signature cho Java – phiên bản 23.12 trở lên
- Bộ công cụ phát triển Java (JDK) – phiên bản 8 hoặc cao hơn
- IDE – IntelliJ IDEA, Eclipse, hoặc bất kỳ trình chỉnh sửa nào tương thích Java
- Kiến thức Java cơ bản – bạn nên quen thuộc với các lớp và import
Cài đặt môi trường
Nhận GroupDocs.Signature vào dự án của bạn rất đơn giản. Chọn công cụ xây dựng của bạn:
Maven (thêm đoạn này vào pom.xml của bạn):
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-signature</artifactId>
<version>23.12</version>
</dependency>
Gradle (thêm vào build.gradle của bạn):
implementation 'com.groupdocs:groupdocs-signature:23.12'
Tải xuống thủ công: Không sử dụng Maven hoặc Gradle? Tải JAR trực tiếp từ GroupDocs.Signature releases và thêm vào classpath của bạn.
Mua giấy phép
GroupDocs cung cấp các gói giấy phép linh hoạt:
- Dùng thử miễn phí: Hoàn hảo cho việc thử nghiệm—không cần thẻ tín dụng. Bắt đầu ở đây
- Giấy phép tạm thời: Cần thêm thời gian để đánh giá? Yêu cầu giấy phép tạm thời để truy cập đầy đủ tính năng trong quá trình phát triển
- Giấy phép sản xuất: Khi bạn sẵn sàng triển khai, mua giấy phép dựa trên nhu cầu của bạn
Liên kết hữu ích bổ sung
- Tài liệu GroupDocs.Signature cho Java
- Hướng dẫn Tham chiếu API
- Diễn đàn Hỗ trợ Cộng đồng
- Bản phát hành Thư viện Mới nhất
- Tải xuống Dùng thử Miễn phí
- Yêu cầu Giấy phép Tạm thời
- Mua Giấy phép Đầy đủ
Mẹo: Bắt đầu với bản dùng thử miễn phí để tạo mẫu giải pháp của bạn, sau đó lấy giấy phép tạm thời nếu bạn cần thêm thời gian trước khi cam kết.
Cài đặt GroupDocs.Signature cho Java
Lớp Signature là điểm vào cho tất cả các thao tác ký trong GroupDocs.Signature. Nó đại diện cho một tệp duy nhất được tải vào bộ nhớ và cung cấp các phương thức để thêm, tìm kiếm hoặc xóa các chữ ký hình ảnh.
Tạo một thể hiện Signature trỏ tới tệp TAR của bạn. Điều này sẽ tải tệp vào bộ nhớ để xử lý:
import com.groupdocs.signature.Signature;
public class InitializeSignature {
public static void main(String[] args) {
Signature signature = new Signature("your-document-path");
// Additional setup and usage here...
}
}
Quan trọng: Luôn đóng đối tượng Signature khi bạn hoàn thành (hoặc sử dụng try‑with‑resources) để tránh rò rỉ bộ nhớ với các tệp lớn.
Lựa chọn giữa chữ ký mã vạch và mã QR
Không chắc loại chữ ký nào nên dùng? Dưới đây là hướng dẫn quyết định nhanh:
| Yếu tố | Mã vạch (Code128) | Mã QR |
|---|---|---|
| Dung lượng dữ liệu | ~80 ký tự | Lên tới 4.296 ký tự chữ và số |
| Khả năng đọc | Cần máy quét mã vạch | Hoạt động với camera điện thoại thông minh |
| Hiệu quả không gian | Nhỏ gọn hơn theo chiều ngang | Cần khu vực hình vuông |
| Thích hợp cho | ID đơn giản, dấu thời gian, mã ngắn | URL, dữ liệu JSON, siêu dữ liệu chi tiết |
| Sửa lỗi | Tối thiểu | Tích hợp (có thể phục hồi sau hư hỏng) |
Nguyên tắc chung:
- Sử dụng mã vạch cho các ID hoặc dấu thời gian nhanh, có thể quét.
- Sử dụng mã QR khi bạn cần nhúng dữ liệu phong phú hơn hoặc muốn tương thích với điện thoại thông minh.
- Kết hợp cả hai để đạt độ dư thừa và khả năng kiểm toán tối đa.
Hướng dẫn triển khai
Ký tệp TAR bằng mã vạch
Tại sao ký bằng mã vạch?
Mã vạch là lựa chọn hoàn hảo cho các tệp TAR vì chúng gọn nhẹ và có thể quét. Bạn có thể nhúng dấu thời gian, số phiên bản, ID người dùng hoặc giá trị checksum để xác minh nhanh.
Các bước
1. Khởi tạo chữ ký
Đầu tiên, tạo một thể hiện Signature cho tệp TAR:
import com.groupdocs.signature.Signature;
final Signature signature = new Signature("path/to/your/archive.tar");
Mẹo: Đối với các tệp TAR lớn (hơn 100 MB), chạy thao tác ký trong một luồng nền để giao diện người dùng không bị treo.
2. Cấu hình tùy chọn mã vạch
Lớp BarcodeSignature định nghĩa nội dung, loại và vị trí của mã vạch. Đối tượng BarcodeOptions chứa các cài đặt này:
import com.groupdocs.signature.options.sign.BarcodeSignOptions;
import com.groupdocs.signature.domain.barcodes.BarcodeTypes;
BarcodeSignOptions bcOptions = new BarcodeSignOptions("12345678", BarcodeTypes.Code128);
bcOptions.setLeft(100); // X position in pixels
bcOptions.setTop(100); // Y position in pixels
BarcodeOptions cho phép bạn chỉ định giao diện hình ảnh và vị trí của mã vạch.BarcodeTypes là một enum liệt kê các ký hiệu mã vạch được hỗ trợ như Code128, Code39, v.v.
Điều gì đang xảy ra ở đây?
"12345678"là dữ liệu được mã hoá trong mã vạch—thay thế bằng ID, dấu thời gian hoặc mã xác minh thực tế của bạn.BarcodeTypes.Code128cân bằng dung lượng dữ liệu với độ tin cậy khi quét.- Giá trị vị trí (100, 100) đặt mã vạch cách góc trên‑trái 100 px.
Tùy chọn tùy chỉnh mà bạn có thể muốn:
bcOptions.setWidth(200); // Barcode width in pixels
bcOptions.setHeight(50); // Barcode height in pixels
bcOptions.setForeColor(Color.BLACK); // Barcode color
bcOptions.setBackgroundColor(Color.WHITE); // Background color
3. Ký và lưu tài liệu
Thực hiện thao tác ký và lưu trữ kho lưu trữ đã ký:
import com.groupdocs.signature.domain.SignResult;
String outputFilePath = "output/path/SignWithBarcode/archive_signed.tar";
SignResult signResult = signature.sign(outputFilePath, bcOptions);
Đối tượng SignResult trả về cho bạn biết liệu thao tác có thành công hay không và vị trí của chữ ký.
Lưu ý thường gặp: Đảm bảo thư mục đầu ra tồn tại trước khi gọi sign(). Thư viện sẽ không tự động tạo thư mục cha.
Ký tệp TAR bằng mã QR
Khi nào nên sử dụng mã QR
Mã QR tỏa sáng khi bạn cần lưu trữ dữ liệu có cấu trúc (JSON, XML), nhúng URL xác minh, hoặc cho phép quét bằng điện thoại thông minh.
Các bước
1. Khởi tạo chữ ký
Đầu tiên, tạo một thể hiện Signature cho tệp TAR:
final Signature signature = new Signature("path/to/your/archive.tar");
2. Cấu hình tùy chọn mã QR
Thiết lập mã QR của bạn với dữ liệu muốn nhúng:
import com.groupdocs.signature.options.sign.QrCodeSignOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;
QrCodeSignOptions qrOptions = new QrCodeSignOptions("12345678", QrCodeTypes.QR);
qrOptions.setLeft(400); // X position
qrOptions.setTop(400); // Y position
QrCodeTypes là một enum chỉ định loại mã QR sẽ tạo (QR tiêu chuẩn, DataMatrix, Aztec, v.v.).
Ví dụ thực tế – nhúng payload JSON với dữ liệu xác minh:
String verificationData = "{\"version\":\"1.0\",\"timestamp\":\"2025-01-02T10:30:00Z\",\"user\":\"john.doe\"}";
QrCodeSignOptions qrOptions = new QrCodeSignOptions(verificationData, QrCodeTypes.QR);
Các tùy chọn loại mã QR:
QrCodeTypes.QR– mã QR tiêu chuẩn (phổ biến nhất)QrCodeTypes.DataMatrix– gọn hơn cho dữ liệu nhỏQrCodeTypes.Aztec– phù hợp cho bề mặt cong
3. Ký và lưu tài liệu
Thực hiện thao tác ký và lưu trữ kho lưu trữ đã ký:
String outputFilePath = "output/path/SignWithQRCode/archive_signed.tar";
SignResult signResult = signature.sign(outputFilePath, qrOptions);
Lưu ý hiệu năng: việc tạo mã QR hơi chậm hơn một chút so với mã vạch do tính toán sửa lỗi, nhưng sự khác biệt không đáng kể cho hầu hết các trường hợp (thường chỉ vài mili giây).
Ký tệp TAR bằng nhiều chữ ký
Tại sao nên sử dụng nhiều chữ ký?
- Dư thừa – nếu một chữ ký bị hỏng, chữ ký còn lại vẫn có thể xác minh.
- Đối tượng khác nhau – mã vạch cho máy quét, mã QR cho điện thoại thông minh.
- Dữ liệu lớp – ID nhanh trong mã vạch, siêu dữ liệu chi tiết trong mã QR.
- Tuân thủ – một số quy định yêu cầu nhiều phương pháp xác minh.
Các bước
1. Khởi tạo chữ ký
final Signature signature = new Signature("path/to/your/archive.tar");
2. Cấu hình nhiều tùy chọn
Tạo cả hai loại chữ ký và kết hợp chúng trong một danh sách:
import java.util.ArrayList;
import java.util.List;
// Set up barcode (reusing from earlier example)
BarcodeSignOptions bcOptions = new BarcodeSignOptions("12345678", BarcodeTypes.Code128);
bcOptions.setLeft(100);
bcOptions.setTop(100);
// Set up QR code (different position to avoid overlap)
QrCodeSignOptions qrOptions = new QrCodeSignOptions("12345678", QrCodeTypes.QR);
qrOptions.setLeft(400);
qrOptions.setTop(400);
// Combine them
List<com.groupdocs.signature.options.sign.SignOptions> listOptions = new ArrayList<>();
listOptions.add(bcOptions);
listOptions.add(qrOptions);
Mẹo: Đặt chữ ký một cách chiến lược—góc hoặc các khu vực không can thiệp là tốt nhất cho các tệp TAR.
3. Ký và lưu tài liệu
String outputFilePath = "output/path/SignWithMultipleSignatures/archive_signed.tar";
SignResult signResult = signature.sign(outputFilePath, listOptions);
GroupDocs xử lý mỗi chữ ký theo thứ tự, nhúng chúng vào siêu dữ liệu tài liệu. Thứ tự trong danh sách của bạn không ảnh hưởng đến việc xác minh.
Các trường hợp thực tế
1. Quy trình phân phối phần mềm
Kịch bản: Phân phối các gói phần mềm dưới dạng tệp TAR và chứng minh chúng không bị thay đổi.
Giải pháp: Ký mỗi bản phát hành bằng mã QR chứa payload JSON:
String releaseData = String.format(
"{\"version\":\"%s\",\"buildDate\":\"%s\",\"sha256\":\"%s\"}",
version, buildDate, checksum
);
Lý do hoạt động: Người dùng có thể quét mã QR để xác minh tính toàn vẹn của gói trước khi cài đặt—không cần quản lý khóa GPG.
2. Hệ thống sao lưu tự động
Kịch bản: Các tệp TAR sao lưu hàng ngày cần có dấu vết kiểm toán.
Giải pháp: Thêm mã vạch với dấu thời gian sao lưu và ID máy chủ:
String backupId = String.format("SRV01-%s", LocalDateTime.now().format(formatter));
BarcodeSignOptions bcOptions = new BarcodeSignOptions(backupId, BarcodeTypes.Code128);
Lý do hoạt động: Xác minh nhanh bằng mắt tính xác thực của sao lưu mà không cần mở kho lưu trữ.
3. Hệ thống quản lý tài liệu
Kịch bản: Các tài liệu pháp lý được lưu trữ dưới dạng kho lưu trữ yêu cầu xác minh không thể bị giả mạo.
Giải pháp: Sử dụng cả mã vạch (quét nhanh) và mã QR (siêu dữ liệu chi tiết) trên cùng một kho lưu trữ.
4. Theo dõi chuỗi cung ứng
Kịch bản: Theo dõi các gói tệp qua nhiều tổ chức.
Giải pháp: Nhúng mã QR với URL theo dõi liên kết tới API xác minh:
String trackingUrl = "https://verify.yourcompany.com/track/" + uniqueId;
QrCodeSignOptions qrOptions = new QrCodeSignOptions(trackingUrl, QrCodeTypes.QR);
Các vấn đề thường gặp và giải pháp
Vấn đề 1: “Signature not found” after signing
Triệu chứng: sign() thành công, nhưng chữ ký không hiển thị.
Nguyên nhân: Vị trí sai, ghi đè tệp gốc, giới hạn của trình xem TAR.
Giải pháp:
// Always verify the signing succeeded
SignResult result = signature.sign(outputFilePath, bcOptions);
if (result.getSucceeded().size() > 0) {
System.out.println("Signature added successfully at: " + outputFilePath);
} else {
System.err.println("Signing failed: " + result.getFailed());
}
// Use absolute paths to avoid confusion
String absolutePath = new File(outputFilePath).getAbsolutePath();
Vấn đề 2: OutOfMemoryError with large TAR files
Triệu chứng: JVM sập khi xử lý các kho lưu trữ > 500 MB.
Giải pháp: Tăng kích thước heap (-Xmx) và giải phóng các đối tượng Signature kịp thời:
java -Xmx2G -jar your-application.jar
Hoặc triển khai xử lý theo khối:
// For very large files, consider signing metadata separately
// rather than embedding in the TAR itself
Vấn đề 3: Signature data gets truncated
Triệu chứng: Các chuỗi dài bị cắt ngắn.
Nguyên nhân: Vượt quá dung lượng của Code128 (≈ 80 ký tự).
Giải pháp: Chuyển sang mã QR cho payload dài hơn:
// Bad: Too much data for Code128
BarcodeSignOptions bcOptions = new BarcodeSignOptions(veryLongString, BarcodeTypes.Code128);
// Good: Use QR code instead
QrCodeSignOptions qrOptions = new QrCodeSignOptions(veryLongString, QrCodeTypes.QR);
Vấn đề 4: License validation errors
Triệu chứng: LicenseException hoặc cảnh báo “Phiên bản dùng thử” trong môi trường sản xuất.
Giải pháp: Tải giấy phép trước khi tạo bất kỳ thể hiện Signature nào:
import com.groupdocs.signature.License;
License license = new License();
license.setLicense("path/to/GroupDocs.Signature.lic");
// Now create signatures
Signature signature = new Signature("document.tar");
Mẹo: Tải giấy phép một lần khi khởi động ứng dụng, không phải trước mỗi thao tác ký.
Vấn đề 5: Position values don’t work as expected
Triệu chứng: Các chữ ký xuất hiện ở vị trí không mong muốn.
Nguyên nhân: Nhầm lẫn giữa pixel và điểm.
Giải pháp: GroupDocs mặc định sử dụng pixel. Để đặt chính xác:
bcOptions.setLeft(100); // 100 pixels from left edge
bcOptions.setTop(100); // 100 pixels from top edge
// If you need percentage-based positioning:
bcOptions.setHorizontalAlignment(HorizontalAlignment.Center);
bcOptions.setVerticalAlignment(VerticalAlignment.Center);
Mẫu tích hợp
Mẫu 1: Dịch vụ REST API
Tiết lộ việc ký dưới dạng microservice:
@RestController
@RequestMapping("/api/signature")
public class SignatureController {
@PostMapping("/sign")
public ResponseEntity<SignatureResponse> signFile(
@RequestParam("file") MultipartFile file,
@RequestParam("signatureType") String type) {
try {
// Save uploaded file temporarily
File tempFile = File.createTempFile("upload-", ".tar");
file.transferTo(tempFile);
// Sign based on type
Signature signature = new Signature(tempFile.getAbsolutePath());
SignOptions options = type.equals("barcode")
? createBarcodeOptions()
: createQROptions();
String outputPath = generateOutputPath();
SignResult result = signature.sign(outputPath, options);
// Return signed file
return ResponseEntity.ok(new SignatureResponse(outputPath, result));
} catch (Exception e) {
return ResponseEntity.status(500).body(null);
}
}
}
Mẫu 2: Quy trình xử lý hàng loạt
Ký nhiều kho lưu trữ trong một pipeline:
public class BatchSigner {
public void signArchiveBatch(List<File> archives) {
ExecutorService executor = Executors.newFixedThreadPool(4);
archives.forEach(archive -> {
executor.submit(() -> {
try {
signSingleArchive(archive);
} catch (Exception e) {
logger.error("Failed to sign: " + archive.getName(), e);
}
});
});
executor.shutdown();
executor.awaitTermination(1, TimeUnit.HOURS);
}
private void signSingleArchive(File archive) throws Exception {
Signature signature = new Signature(archive.getAbsolutePath());
// ... signing logic
}
}
Mẫu 3: Kiến trúc dựa trên sự kiện
Kích hoạt ký khi các kho lưu trữ được tạo:
@Component
public class ArchiveCreatedListener {
@EventListener
public void onArchiveCreated(ArchiveCreatedEvent event) {
CompletableFuture.runAsync(() -> {
signArchive(event.getFilePath());
});
}
private void signArchive(String filePath) {
// ... signing logic
}
}
Cân nhắc hiệu năng
Quản lý bộ nhớ
Vấn đề: Mỗi thể hiện Signature tải toàn bộ tệp vào bộ nhớ.
Thực hành tốt:
// Bad: Creating multiple instances for same file
Signature sig1 = new Signature("file.tar");
Signature sig2 = new Signature("file.tar"); // Loads again!
// Good: Reuse the instance
try (Signature signature = new Signature("file.tar")) {
signature.sign(output1, options1);
signature.sign(output2, options2); // Same instance, different outputs
}
Tối ưu kích thước tệp
- Tệp nhỏ (< 10 MB) – ký đồng bộ.
- Tệp trung bình (10‑100 MB) – sử dụng luồng nền.
- Tệp lớn (> 100 MB) – cân nhắc ký siêu dữ liệu riêng hoặc sử dụng API streaming.
Độ phức tạp chữ ký (thời gian ước tính trên máy chủ tiêu chuẩn)
| Loại chữ ký | Thời gian mỗi tài liệu |
|---|---|
| Mã vạch đơn | 50‑100 ms |
| Mã QR đơn | 100‑200 ms |
| Nhiều chữ ký | 150‑300 ms |
Mẹo tối ưu: Đối với hàng ngàn tệp, hãy gom chúng thành batch và sử dụng pool luồng (xem mẫu xử lý hàng loạt ở trên).
Cập nhật thư viện
GroupDocs phát hành các cải tiến hiệu năng thường xuyên. Luôn kiểm tra nhật ký thay đổi trước khi triển khai lớn.
Chiến lược cập nhật:
- Kiểm tra phiên bản mới trong môi trường staging.
- Xem xét các thay đổi gây phá vỡ.
- Đánh giá hiệu năng với các tệp thực tế.
- Triển khai dần dần.
Thực hành tốt cho môi trường sản xuất
1. Xác thực trạng thái giấy phép
License license = new License();
if (!license.isLicensed()) {
logger.warn("Running in trial mode - features may be limited");
}
2. Triển khai xử lý lỗi mạnh mẽ
try {
signature.sign(outputPath, options);
} catch (Exception e) {
logger.error("Signature failed", e);
// Don't just swallow exceptions - log or re-throw
throw new SignatureException("Failed to sign document", e);
}
3. Sử dụng dữ liệu chữ ký mô tả
// Bad: Meaningless ID
new BarcodeSignOptions("12345678", BarcodeTypes.Code128);
// Good: Self-documenting data
String signatureData = String.format("DOC-%s-%s",
docType,
LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME)
);
new BarcodeSignOptions(signatureData, BarcodeTypes.Code128);
4. Phiên bản hoá định dạng chữ ký: Bao gồm số phiên bản trong JSON nhúng để bảo vệ logic xác minh trong tương lai:
String qrData = String.format(
"{\"v\":\"1.0\",\"type\":\"archive\",\"timestamp\":\"%s\"}",
timestamp
);
5. Kiểm tra với các tệp thực tế – luôn xác thực với các kho lưu trữ kích thước sản xuất để sớm phát hiện vấn đề bộ nhớ và hiệu năng.
Kết luận
Bây giờ bạn đã có nền tảng vững chắc để triển khai how to sign java bằng mã vạch và mã QR. Đây là những gì bạn đã học:
- Cách ký các tệp TAR (và các tài liệu khác) bằng cả chữ ký mã vạch và mã QR
- Khi nào nên chọn mỗi loại chữ ký dựa trên nhu cầu cụ thể
- Cách khắc phục các vấn đề thường gặp trước khi chúng xuất hiện trong môi trường sản xuất
- Mẫu tích hợp thực tế cho REST API, xử lý hàng loạt và hệ thống dựa trên sự kiện
- Kỹ thuật tối ưu hiệu năng để xử lý tệp ở mọi kích thước
Bước tiếp theo:
- Khám phá xác minh chữ ký bằng phương thức
search(). - Thử các định dạng tài liệu khác—GroupDocs.Signature hỗ trợ PDF, DOCX, XLSX, PNG và nhiều hơn.
- Tùy chỉnh giao diện chữ ký (màu sắc, kích thước, viền).
- Xây dựng API xác minh để kiểm tra chữ ký một cách lập trình.
Sức mạnh của GroupDocs.Signature vượt xa hướng dẫn này. Hãy xem Tài liệu GroupDocs.Signature cho Java để khám phá các tính năng nâng cao như chữ ký văn bản, chữ ký hình ảnh và trích xuất siêu dữ liệu.
Có câu hỏi hoặc muốn chia sẻ cách triển khai của bạn? Tham gia diễn đàn cộng đồng GroupDocs để nhận trợ giúp từ các nhà phát triển khác.
Câu hỏi thường gặp
Q: Tôi có thể ký các tài liệu khác ngoài kho lưu trữ TAR không?
A: Chắc chắn! GroupDocs.Signature hỗ trợ hơn 50 định dạng tệp, bao gồm PDF, DOCX, XLSX, PNG và nhiều hơn nữa. Chỉ cần thay đổi phần mở rộng tệp trong hàm tạo Signature để làm việc với bất kỳ loại hỗ trợ nào.
Q: Làm sao tôi kiểm tra chữ ký sau khi ký?
A: Sử dụng phương thức search() để tìm và xác thực chữ ký:
Signature signature = new Signature("signed-document.tar");
BarcodeSearchOptions searchOptions = new BarcodeSearchOptions();
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, searchOptions);
Q: Các chữ ký có an toàn trước việc giả mạo không?
A: Chữ ký mã vạch và mã QR cung cấp xác minh bằng mắt nhưng không mạnh về mật mã như chứng chỉ số. Để bảo mật tối đa, kết hợp chúng với PKI truyền thống hoặc lưu trữ hash chữ ký trong cơ sở dữ liệu bên ngoài.
Q: Dung lượng dữ liệu tối đa tôi có thể lưu trong một chữ ký là bao nhiêu?
- Mã vạch Code128: ~80 ký tự chữ và số
- Mã QR (Phiên bản 40): lên tới 4.296 ký tự chữ và số hoặc 7.089 ký tự số
Q: Tôi có thể tùy chỉnh giao diện chữ ký không?
A: Có! Kiểm soát màu sắc, kích thước, viền và hơn thế nữa:
bcOptions.setForeColor(Color.BLUE);
bcOptions.setBackgroundColor(Color.YELLOW);
bcOptions.setBorder(new Border());
bcOptions.getBorder().setColor(Color.RED);
bcOptions.getBorder().setWeight(2);
Q: Điều gì xảy ra nếu tôi ký một tệp hai lần?
A: Mỗi lần gọi sign() sẽ thêm một chữ ký mới. Để thay thế một chữ ký hiện có, hãy xóa nó trước bằng phương thức delete().
Q: Làm sao tôi xử lý các tệp lớn mà không hết bộ nhớ?
A: Tăng heap JVM (-Xmx), giải phóng các đối tượng Signature kịp thời, và cân nhắc ký siêu dữ liệu riêng cho các kho lưu trữ đa gigabyte.
Q: Tôi có cần kết nối internet để ký tài liệu không?
A: Không. GroupDocs.Signature hoạt động hoàn toàn offline sau khi thư viện được cài đặt.
Cập nhật lần cuối: 2026-10-06
Kiểm tra với: GroupDocs.Signature 23.12 for Java
Tác giả: GroupDocs