Triển khai chữ ký văn bản với xử lý sự kiện bằng GroupDocs.Signature cho Java

Giới thiệu

Trong thế giới số ngày nay, quản lý quy trình làm việc tài liệu hiệu quả là chìa khóa cho cả chuyên gia kinh doanh và nhà phát triển. Hướng dẫn này sẽ hướng dẫn bạn triển khai ký văn bản trong Java bằng GroupDocs.Signature for Java, tập trung vào xử lý sự kiện để giám sát hiệu quả quy trình ký.

Những gì bạn sẽ học:

Thiết lập và sử dụng GroupDocs.Signature cho Java
Triển khai các sự kiện bắt đầu, tiến trình và hoàn thành trong quá trình ký kết
Xử lý các tùy chọn chữ ký văn bản và tùy chỉnh vị trí

Hãy bắt đầu thiết lập môi trường của bạn!

Điều kiện tiên quyết

Trước khi triển khai chữ ký văn bản có xử lý sự kiện, hãy đảm bảo bạn đã đáp ứng các điều kiện tiên quyết sau:

Thư viện và phụ thuộc bắt buộc

Để sử dụng GroupDocs.Signature cho Java, hãy đưa nó vào dự án của bạn. Thực hiện theo các bước sau dựa trên công cụ xây dựng của bạn:

Chuyên gia:

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

Gradle:

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

Ngoài ra, hãy tải xuống phiên bản mới nhất từ GroupDocs.Signature cho các bản phát hành Java.

Thiết lập môi trường

Đảm bảo môi trường phát triển của bạn được cấu hình với:

JDK 8 trở lên
Một IDE tương thích (ví dụ: IntelliJ IDEA, Eclipse)
Maven hoặc Gradle được cài đặt nếu sử dụng các công cụ đó

Điều kiện tiên quyết về kiến thức

Hiểu biết cơ bản về lập trình Java và kiến trúc hướng sự kiện sẽ có lợi khi chúng ta khám phá các chi tiết triển khai.

Thiết lập GroupDocs.Signature cho Java

Để bắt đầu sử dụng GroupDocs.Signature cho Java:

Cài đặt: Thêm sự phụ thuộc vào tệp dựng của dự án (Maven hoặc Gradle) như được hiển thị ở trên.
Mua lại giấy phép: Nhận giấy phép dùng thử miễn phí từ GroupDocs, mua giấy phép đầy đủ hoặc yêu cầu giấy phép tạm thời để thử nghiệm kéo dài.

Sau khi thư viện đã sẵn sàng và môi trường đã được thiết lập, hãy khởi tạo GroupDocs.Signature trong ứng dụng Java của bạn:

import com.groupdocs.signature.Signature;

public class SignatureSetup {
    public static void main(String[] args) {
        String filePath = "path/to/your/document.pdf";
        Signature signature = new Signature(filePath);
        
        // Tài liệu của bạn hiện đã sẵn sàng để ký bằng GroupDocs.Signature cho Java.
    }
}

Hướng dẫn thực hiện

Sự kiện bắt đầu quá trình ký tên

Quá trình ký có thể được theo dõi ngay từ khi bắt đầu. Sau đây là cách bạn xử lý sự kiện bắt đầu:

Tổng quan

Tính năng này cho phép ứng dụng của bạn phản hồi khi hoạt động ký bắt đầu, cung cấp thông tin chi tiết về quá trình khởi tạo.

Các bước

3.1 Định nghĩa Trình xử lý sự kiện Tạo phương thức xử lý sự kiện thông báo khi quá trình ký kết bắt đầu:

import com.groupdocs.signature.handler.events.ProcessStartEventArgs;
import com.groupdocs.signature.handler.events.ProcessStartEventHandler;

public class SignProcessStart {
    public static void onSignStarted(Signature sender, ProcessStartEventArgs args) {
        System.out.println("Signing process started: " + args.getSignatureDefinition().getSignatureType());
    }
}

3.2 Đăng ký tham gia sự kiện Đăng ký để SignStarted sự kiện trong phương thức ký chính của bạn:

signature.SignStarted.add(new ProcessStartEventHandler() {
    public void invoke(Signature sender, ProcessStartEventArgs args) {
        SignProcessStart.onSignStarted(sender, args);
    }
});

Dấu hiệu tiến trình sự kiện

Theo dõi tiến độ cho phép cập nhật theo thời gian thực hoặc xử lý hiệu quả các quy trình chạy lâu.

Tổng quan

Tính năng này theo dõi tiến trình của hoạt động ký kết và cung cấp thông tin cập nhật trạng thái.

Các bước

3.1 Định nghĩa Trình xử lý sự kiện tiến trình Thiết lập phương pháp để nắm bắt thông tin chi tiết về tiến trình:

import com.groupdocs.signature.handler.events.ProcessProgressEventArgs;
import com.groupdocs.signature.handler.events.ProcessProgressEventHandler;

public class SignProgress {
    public static void onSignProgress(Signature sender, ProcessProgressEventArgs args) {
        System.out.println("Signing progress: " + args.getPercentCompleted() + "% completed");
    }
}

3.2 Đăng ký sự kiện tiến độ Thêm trình lắng nghe sự kiện để cập nhật tiến trình:

signature.SignProgress.add(new ProcessProgressEventHandler() {
    public void invoke(Signature sender, ProcessProgressEventArgs args) {
        SignProgress.onSignProgress(sender, args);
    }
});

Sự kiện hoàn thành dấu hiệu

Biết thời điểm quá trình ký kết hoàn tất sẽ cho phép thực hiện các hành động tiếp theo hoặc ghi nhật ký.

Tổng quan

Tính năng này sẽ thông báo cho ứng dụng của bạn khi hoàn tất thao tác ký.

Các bước

3.1 Định nghĩa Trình xử lý sự kiện hoàn thành Ghi lại thông tin chi tiết sau khi quá trình hoàn tất:

import com.groupdocs.signature.handler.events.ProcessCompleteEventArgs;
import com.groupdocs.signature.handler.events.ProcessCompleteEventHandler;

public class SignCompletion {
    public static void onSignCompleted(Signature sender, ProcessCompleteEventArgs args) {
        System.out.println("Signing completed: " + args.getSignatureDefinition().getSignatureType());
    }
}

3.2 Đăng ký sự kiện hoàn thành Lắng nghe các sự kiện hoàn thành:

signature.SignCompleted.add(new ProcessCompleteEventHandler() {
    public void invoke(Signature sender, ProcessCompleteEventArgs args) {
        SignCompletion.onSignCompleted(sender, args);
    }
});

Chữ ký văn bản

Bây giờ việc xử lý sự kiện đã được thiết lập, hãy triển khai chữ ký văn bản.

Tổng quan

Tính năng này trình bày cách ký tài liệu bằng chữ ký dạng văn bản bằng GroupDocs.Signature cho Java.

Các bước

3.1 Ký một tài liệu Xác định phương pháp thực hiện thao tác ký thực tế:

import com.groupdocs.signature.options.sign.TextSignOptions;
import java.io.File;
import java.nio.file.Paths;

public class SignWithTextSignature {
    public static void signDocument() throws Exception {
        String filePath = "YOUR_DOCUMENT_DIRECTORY";
        String fileName = Paths.get(filePath).getFileName().toString();
        
        String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY", "SignWithTextEvents/" + fileName).getPath();
        Signature signature = new Signature(filePath);

        // Đăng ký sự kiện ký tặng
        signature.SignStarted.add(new ProcessStartEventHandler() {
            public void invoke(Signature sender, ProcessStartEventArgs args) {
                SignProcessStart.onSignStarted(sender, args);
            }
        });

        signature.SignProgress.add(new ProcessProgressEventHandler() {
            public void invoke(Signature sender, ProcessProgressEventArgs args) {
                SignProgress.onSignProgress(sender, args);
            }
        });

        signature.SignCompleted.add(new ProcessCompleteEventHandler() {
            public void invoke(Signature sender, ProcessCompleteEventArgs args) {
                SignCompletion.onSignCompleted(sender, args);
            }
        });

        // Xác định các tùy chọn chữ ký văn bản
        TextSignOptions options = new TextSignOptions("John Smith");
        options.setLeft(100);  // Đặt vị trí bên trái của chữ ký
        options.setTop(100);   // Đặt vị trí trên cùng của chữ ký
        
        // Thực hiện thao tác ký
        signature.sign(outputFilePath, options);
    }
}

Phần kết luận

Bằng cách làm theo hướng dẫn này, bạn đã học cách triển khai ký văn bản trong Java bằng GroupDocs.Signature for Java với xử lý sự kiện. Phương pháp này nâng cao chức năng ứng dụng của bạn và cung cấp thông tin chi tiết theo thời gian thực về quy trình ký tài liệu.

Các bước tiếp theo:

Thử nghiệm với các tùy chọn chữ ký khác nhau có sẵn trong GroupDocs.Signature.
Khám phá các tính năng bổ sung như chữ ký số hoặc chữ ký dựa trên hình ảnh.
Hãy cân nhắc tích hợp giải pháp này vào các ứng dụng lớn hơn để tăng cường tự động hóa quy trình làm việc.