Java용 GroupDocs.Signature를 사용하여 이벤트 처리를 통한 텍스트 서명 구현

소개

오늘날의 디지털 세상에서 효율적인 문서 워크플로 관리는 비즈니스 전문가와 개발자 모두에게 매우 중요합니다. 이 튜토리얼에서는 GroupDocs.Signature for Java를 사용하여 Java에서 텍스트 서명을 구현하는 방법을 안내하며, 서명 프로세스를 효과적으로 모니터링하기 위한 이벤트 처리에 중점을 둡니다.

배울 내용:

Java용 GroupDocs.Signature 설정 및 사용
서명 프로세스 중에 시작, 진행 및 완료 이벤트를 구현합니다.
텍스트 서명 옵션을 처리하고 배치를 사용자 정의합니다.

이제 환경 설정을 시작해 보겠습니다!

필수 조건

이벤트 처리를 통한 텍스트 서명을 구현하기 전에 다음 전제 조건이 충족되었는지 확인하세요.

필수 라이브러리 및 종속성

Java용 GroupDocs.Signature를 사용하려면 프로젝트에 포함하세요. 빌드 도구에 따라 다음 단계를 따르세요.

메이븐:

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

그래들:

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

또는 다음에서 최신 버전을 다운로드하세요. Java 릴리스용 GroupDocs.Signature.

환경 설정

개발 환경이 다음으로 구성되어 있는지 확인하세요.

JDK 8 이상
호환되는 IDE(예: IntelliJ IDEA, Eclipse)
해당 도구를 사용하는 경우 Maven 또는 Gradle이 설치되어 있어야 합니다.

지식 전제 조건

Java 프로그래밍과 이벤트 기반 아키텍처에 대한 기본적인 이해가 구현 세부 사항을 살펴보는 데 도움이 될 것입니다.

Java용 GroupDocs.Signature 설정

Java용 GroupDocs.Signature를 사용하려면:

설치: 위에 표시된 대로 프로젝트의 빌드 파일(Maven 또는 Gradle)에 종속성을 추가합니다.
라이센스 취득: 무료 평가판 라이센스를 받으세요 그룹닥스, 전체 라이센스를 구매하거나, 장기 테스트를 위해 임시 라이센스를 요청하세요.

라이브러리를 준비하고 환경을 설정한 후 Java 애플리케이션에서 GroupDocs.Signature를 초기화합니다.

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);
        
        // 이제 GroupDocs.Signature for Java를 사용하여 문서에 서명할 준비가 되었습니다.
    }
}

구현 가이드

서명 프로세스 시작 이벤트

서명 프로세스는 시작되는 순간부터 모니터링할 수 있습니다. 시작 이벤트를 처리하는 방법은 다음과 같습니다.

개요

이 기능을 사용하면 서명 작업이 시작될 때 애플리케이션이 응답하여 시작 세부 정보에 대한 통찰력을 제공할 수 있습니다.

단계

3.1 이벤트 핸들러 정의 서명 프로세스가 시작되었을 때 알리는 이벤트 핸들러 메서드를 만듭니다.

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 이벤트 구독 구독하기 SignStarted 주요 서명 방법의 이벤트:

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

진행 상황 이벤트

진행 상황을 추적하면 실시간 업데이트가 가능하고 장기 실행 프로세스를 효율적으로 처리할 수 있습니다.

개요

이 기능은 서명 작업의 진행 상황을 추적하고 상태 업데이트를 제공합니다.

단계

3.1 진행 이벤트 핸들러 정의 진행 상황 세부 정보를 캡처하는 방법을 설정합니다.

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 진행 이벤트 구독 진행 상황 업데이트를 위한 이벤트 리스너를 추가합니다.

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

간판 완성 이벤트

서명 프로세스가 완료되었는지 알면 후속 작업이나 로깅이 가능합니다.

개요

이 기능은 서명 작업이 완료되면 귀하의 애플리케이션에 알림을 보냅니다.

단계

3.1 완료 이벤트 핸들러 정의 프로세스가 완료되면 세부 정보를 캡처하세요.

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 완료 이벤트 구독 완료 이벤트를 수신합니다.

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

텍스트 서명 서명

이제 이벤트 처리가 설정되었으므로 텍스트 서명 서명을 구현합니다.

개요

이 기능은 Java용 GroupDocs.Signature를 사용하여 텍스트 기반 서명으로 문서에 서명하는 방법을 보여줍니다.

단계

3.1 문서 서명 실제 서명 작업을 수행하는 방법을 정의합니다.

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);

        // 서명 이벤트 구독하기
        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);
            }
        });

        // 텍스트 서명 옵션 정의
        TextSignOptions options = new TextSignOptions("John Smith");
        options.setLeft(100);  // 서명의 왼쪽 위치 설정
        options.setTop(100);   // 서명의 상단 위치 설정
        
        // 서명 작업 수행
        signature.sign(outputFilePath, options);
    }
}

결론

이 가이드를 따라 하면 Java용 GroupDocs.Signature를 사용하여 이벤트 처리 기능을 갖춘 Java에서 텍스트 서명을 구현하는 방법을 배우게 됩니다. 이 접근 방식은 애플리케이션의 기능을 향상시키고 문서 서명 프로세스에 대한 실시간 정보를 제공합니다.

다음 단계:

GroupDocs.Signature에서 제공하는 다양한 서명 옵션을 실험해 보세요.
디지털 서명이나 이미지 기반 서명과 같은 추가 기능을 살펴보세요.
더 큰 규모의 애플리케이션에 이 솔루션을 통합하여 워크플로 자동화를 강화하는 것을 고려해 보세요.