Implémentation de la signature de texte avec gestion des événements à l’aide de GroupDocs.Signature pour Java
Introduction
Dans le monde numérique actuel, une gestion efficace des flux de documents est essentielle pour les professionnels comme pour les développeurs. Ce tutoriel vous guidera dans la mise en œuvre de la signature de texte en Java avec GroupDocs.Signature pour Java, en mettant l’accent sur la gestion des événements pour un suivi efficace du processus de signature.
Ce que vous apprendrez :
- Configurer et utiliser GroupDocs.Signature pour Java
- Mettre en œuvre des événements de démarrage, de progression et de fin pendant le processus de signature
- Gérez les options de signature de texte et personnalisez le placement
Commençons par configurer votre environnement !
Prérequis
Avant d’implémenter la signature de texte avec gestion des événements, assurez-vous d’avoir couvert ces prérequis :
Bibliothèques et dépendances requises
Pour utiliser GroupDocs.Signature pour Java, incluez-le dans votre projet. Suivez ces étapes en fonction de votre outil de build :
Expert :
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-signature</artifactId>
<version>23.12</version>
</dependency>
Gradle :
implementation 'com.groupdocs:groupdocs-signature:23.12'
Vous pouvez également télécharger la dernière version à partir de Versions de GroupDocs.Signature pour Java.
Configuration de l’environnement
Assurez-vous que votre environnement de développement est configuré avec :
- JDK 8 ou supérieur
- Un IDE compatible (par exemple, IntelliJ IDEA, Eclipse)
- Maven ou Gradle installé si vous utilisez ces outils
Prérequis en matière de connaissances
Une compréhension de base de la programmation Java et de l’architecture pilotée par événements sera bénéfique lorsque nous explorerons les détails de mise en œuvre.
Configuration de GroupDocs.Signature pour Java
Pour commencer à utiliser GroupDocs.Signature pour Java :
- Installation: Ajoutez la dépendance au fichier de build de votre projet (Maven ou Gradle) comme indiqué ci-dessus.
- Acquisition de licence: Obtenez une licence d’essai gratuite auprès de Documents de groupe, achetez une licence complète ou demandez une licence temporaire pour des tests prolongés.
Une fois la bibliothèque prête et votre environnement configuré, initialisez GroupDocs.Signature dans votre application Java :
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);
// Votre document est maintenant prêt à être signé avec GroupDocs.Signature pour Java.
}
}
Guide de mise en œuvre
Événement de démarrage du processus de signature
Le processus de signature peut être surveillé dès son lancement. Voici comment gérer l’événement de démarrage :
Aperçu
Cette fonctionnalité permet à votre application de répondre lorsqu’une opération de signature démarre, fournissant des informations sur les détails d’initiation.
Mesures
3.1 Définir le gestionnaire d’événements Créez une méthode de gestionnaire d’événements qui notifie lorsque le processus de signature a commencé :
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 S’abonner à l’événement
Abonnez-vous au SignStarted événement dans votre méthode de signature principale :
signature.SignStarted.add(new ProcessStartEventHandler() {
public void invoke(Signature sender, ProcessStartEventArgs args) {
SignProcessStart.onSignStarted(sender, args);
}
});
Événement de progression de la signature
Le suivi des progrès permet des mises à jour en temps réel ou une gestion efficace des processus de longue durée.
Aperçu
Cette fonctionnalité suit la progression de l’opération de signature et fournit des mises à jour de statut.
Mesures
3.1 Définir le gestionnaire d’événements de progression Configurer une méthode pour capturer les détails de la progression :
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 S’abonner à l’événement Progress Ajoutez un écouteur d’événements pour les mises à jour de progression :
signature.SignProgress.add(new ProcessProgressEventHandler() {
public void invoke(Signature sender, ProcessProgressEventArgs args) {
SignProgress.onSignProgress(sender, args);
}
});
Événement d’achèvement de la signature
Savoir quand un processus de signature est terminé permet d’effectuer des actions ultérieures ou de procéder à une journalisation.
Aperçu
Cette fonctionnalité avertit votre application dès la fin d’une opération de signature.
Mesures
3.1 Définir le gestionnaire d’événements d’achèvement Capturez les détails une fois le processus terminé :
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 S’abonner à l’événement d’achèvement Écoutez les événements d’achèvement :
signature.SignCompleted.add(new ProcessCompleteEventHandler() {
public void invoke(Signature sender, ProcessCompleteEventArgs args) {
SignCompletion.onSignCompleted(sender, args);
}
});
Signature de texte
Maintenant que la gestion des événements est configurée, implémentez la signature de texte.
Aperçu
Cette fonctionnalité montre comment signer des documents avec une signature textuelle à l’aide de GroupDocs.Signature pour Java.
Mesures
3.1 Signer un document Définissez la méthode pour effectuer l’opération de signature réelle :
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);
// Abonnez-vous aux événements de dédicaces
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);
}
});
// Définir les options de signature de texte
TextSignOptions options = new TextSignOptions("John Smith");
options.setLeft(100); // Définir la position gauche de la signature
options.setTop(100); // Définir la position supérieure de la signature
// Effectuer une opération de signature
signature.sign(outputFilePath, options);
}
}
Conclusion
En suivant ce guide, vous avez appris à implémenter la signature de texte en Java à l’aide de GroupDocs.Signature pour Java avec gestion des événements. Cette approche améliore les fonctionnalités de votre application et fournit des informations en temps réel sur le processus de signature des documents.
Prochaines étapes :
- Expérimentez avec différentes options de signature disponibles dans GroupDocs.Signature.
- Découvrez des fonctionnalités supplémentaires telles que les signatures numériques ou les signatures basées sur des images.
- Envisagez d’intégrer cette solution dans des applications plus volumineuses pour une automatisation améliorée du flux de travail.
