GroupDocs.Signature for Java を使用したイベント処理によるテキスト署名の実装

導入

今日のデジタル世界では、効率的なドキュメントワークフロー管理は、ビジネスプロフェッショナルと開発者双方にとって不可欠です。このチュートリアルでは、GroupDocs.Signature for Javaを使用してJavaでテキスト署名を実装する方法を解説します。特に、署名プロセスを効果的に監視するためのイベント処理に焦点を当てます。

学習内容:

GroupDocs.Signature for Java の設定と使用
署名プロセス中に開始、進行、完了のイベントを実装する
テキスト署名オプションを処理し、配置をカスタマイズします

環境の設定を始めましょう!

前提条件

イベント処理によるテキスト署名を実装する前に、次の前提条件を満たしていることを確認してください。

必要なライブラリと依存関係

GroupDocs.Signature for Javaを使用するには、プロジェクトに含めてください。ビルドツールに応じて、以下の手順に従ってください。

メイヴン:

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

グレード:

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

または、最新バージョンを以下からダウンロードしてください。 GroupDocs.Signature for Java リリース.

環境設定

開発環境が次のように構成されていることを確認します。

JDK 8以上
互換性のある IDE（例：IntelliJ IDEA、Eclipse）
Maven または Gradle を使用している場合はインストールしてください

知識の前提条件

実装の詳細を検討する際には、Java プログラミングとイベント駆動型アーキテクチャの基本的な理解が役立ちます。

Java 用 GroupDocs.Signature の設定

GroupDocs.Signature for Java の使用を開始するには:

インストール上記のように、プロジェクトのビルドファイル (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);
    }
});

テキスト署名の署名

イベント処理が設定されたので、テキスト署名の署名を実装します。

概要

この機能は、GroupDocs.Signature for Java を使用してテキストベースの署名でドキュメントに署名する方法を示します。

手順

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

結論

このガイドでは、GroupDocs.Signature for Javaとイベント処理を使用して、Javaでテキスト署名を実装する方法を学びました。このアプローチはアプリケーションの機能を強化し、ドキュメント署名プロセスのリアルタイムな洞察を提供します。

次のステップ:

GroupDocs.Signature で利用できるさまざまな署名オプションを試してください。
デジタル署名や画像ベースの署名などの追加機能を調べます。
ワークフロー自動化を強化するために、このソリューションを大規模なアプリケーションに統合することを検討してください。