Signer un PDF avec un code‑barres en utilisant HIBC en Java

Si vous développez un logiciel de logistique pharmaceutique ou de santé, vous avez probablement rencontré le mur du suivi papier, des signatures perdues et des cauchemars d’audit. Signer un PDF avec un code‑barres—en particulier un Data Matrix HIBC ou un code QR—crée une trace anti‑altération, lisible par machine, qui survit à l’impression, à la numérisation et à la révision réglementaire. Dans ce tutoriel, vous verrez exactement comment ajouter à la fois des codes Data Matrix et QR à un PDF en utilisant GroupDocs.Signature pour Java.

Réponses rapides

  • Quelle bibliothèque gère les codes‑barres HIBC en Java ? GroupDocs.Signature for Java.
  • Quel format de code‑barres est le plus compact ? Data Matrix – idéal pour les petites étiquettes.
  • Puis‑je ajouter à la fois un QR et un Data Matrix au même PDF ? Oui, il suffit de créer des QrCodeSignOptions séparés.
  • Ai‑je besoin d’une connexion Internet à l’exécution ? Non, la bibliothèque fonctionne entièrement hors ligne après l’installation.
  • Quelle version de Java est recommandée ? Java 11+ pour des performances de niveau production.

Qu’est‑ce que la signature PDF avec code‑barres HIBC ?

Signature est la classe principale de GroupDocs.Signature qui représente un document PDF et permet l’intégration de signatures numériques. La classe Signature dans GroupDocs.Signature pour Java fournit des méthodes pour intégrer des codes‑barres HIBC en tant que signatures numériques. En signant un PDF avec un code‑barre HIBC, vous créez un enregistrement vérifiable et anti‑altération qui peut être scanné à tout moment de la chaîne d’approvisionnement.

Pourquoi utiliser ensemble les codes Data Matrix et QR ?

Data Matrix offre l’empreinte la plus petite tout en pouvant contenir jusqu’à 2 335 caractères alphanumériques, ce qui le rend parfait pour les zones d’étiquetage denses. Les codes QR, quant à eux, supportent jusqu’à 4 296 caractères et sont universellement lisibles par les smartphones. Combiner les deux vous donne le meilleur équilibre entre efficacité d’espace et capacité de données, garantissant que chaque partie prenante—des scanners d’entrepôt aux applications mobiles—puisse lire les informations nécessaires.

Prérequis

  • JDK 11 ou supérieur (Java 8 fonctionne mais Java 11+ est recommandé pour des performances optimales).
  • IDE tel qu’IntelliJ IDEA, Eclipse ou VS Code avec extensions Java.
  • Maven ou Gradle pour la gestion des dépendances (exemples ci‑dessous).
  • PDF d’exemple (par ex., sample.pdf) pour tester l’implémentation.
  • Licence valide GroupDocs.Signature (essai gratuit pour le développement, licence payante pour la production).

Configuration de GroupDocs.Signature pour Java

Configuration Maven

Ajoutez la dépendance à votre pom.xml :

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

Configuration Gradle

Pour les projets Gradle, ajoutez ceci à votre build.gradle :

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

Option de téléchargement direct

Vous pouvez également télécharger le fichier JAR directement depuis GroupDocs.Signature for Java releases et l’ajouter manuellement au classpath de votre projet. Cette approche fonctionne bien dans des environnements à réseau restreint.

Obtention d’une licence

Demandez un essai gratuit ou une licence temporaire auprès de GroupDocs pour supprimer les filigranes et débloquer toutes les fonctionnalités. Les déploiements en production nécessitent une licence achetée.

Initialisation de base

Signature est le point d’entrée pour toutes les opérations de signature. Il charge le PDF, applique le code‑barres et écrit le fichier signé.

import com.groupdocs.signature.Signature;

class InitializeSignature {
    public static void main(String[] args) {
        Signature signature = new Signature("sample.pdf");
        // Proceed with signing operations...
    }
}

Comment créer un PDF Data Matrix avec code‑barres HIBC ?

Instanciez Signature avec votre PDF source, définissez QrCodeSignOptions au format Data Matrix, fournissez une chaîne HIBC correctement formatée, puis appelez sign(). La bibliothèque écrit le PDF signé vers la destination, en préservant la mise en page et en intégrant le code‑barres comme une signature anti‑altération.

QrCodeSignOptions spécifie le type de code‑barres, le contenu, la taille et le placement pour une signature.

  1. Importer les classes requises – elles vous donnent accès au moteur de signature et aux options Data Matrix.
import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.QrCodeSignOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;
  1. Instancier l’objet Signature avec des chemins absolus pour les fichiers source et destination.
String sourceFilePath = "YOUR_DOCUMENT_DIRECTORY";
String destinFilePath = "YOUR_OUTPUT_DIRECTORY/SignWithHIBCLICQR.pdf";

final Signature signature = new Signature(sourceFilePath);
  1. Configurer les options Data Matrix – définissez la chaîne HIBC, choisissez QrCodeTypes.HIBCLICDataMatrix, et définissez les coordonnées de placement. QrCodeTypes énumère les formats de code‑barres pris en charge pour les signatures HIBC.
QrCodeSignOptions hibcLic_QR = new QrCodeSignOptions("A123PROD30917/75#422011907#GP293", QrCodeTypes.HIBCLICQR);
hibcLic_QR.setLeft(1); // Set the position from left
hibcLic_QR.setTop(1);   // Set the position from top
hibcLic_QR.setReturnContent(true); // Return content after signing
hibcLic_QR.setReturnContentType(FileType.PNG); // Specify return content type as PNG
  1. Appliquer la signature au PDF.
signature.sign(destinFilePath, hibcLic_QR);
  1. Libérer les ressources pour libérer les poignées de fichiers et éviter les fuites de mémoire.
finally {
    if (signature != null) signature.dispose();
}

Exemple complet fonctionnel

Voici le flux complet dans un seul bloc (les espaces réservés représentent le code exact que vous collerez à partir des extraits précédents) :

import com.groupdocs.signature.Signature;
import com.groupdocs.signature.options.sign.QrCodeSignOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;

public class HibcQrSigning {
    public static void main(String[] args) {
        String sourceFilePath = "sample.pdf";
        String destinFilePath = "output/SignWithHIBCLICQR.pdf";
        
        Signature signature = null;
        try {
            signature = new Signature(sourceFilePath);
            
            QrCodeSignOptions hibcLic_QR = new QrCodeSignOptions(
                "A123PROD30917/75#422011907#GP293", 
                QrCodeTypes.HIBCLICQR
            );
            hibcLic_QR.setLeft(1);
            hibcLic_QR.setTop(1);
            hibcLic_QR.setReturnContent(true);
            hibcLic_QR.setReturnContentType(FileType.PNG);
            
            signature.sign(destinFilePath, hibcLic_QR);
            System.out.println("PDF signed successfully with HIBC QR code");
            
        } catch (Exception e) {
            System.err.println("Error signing PDF: " + e.getMessage());
            e.printStackTrace();
        } finally {
            if (signature != null) signature.dispose();
        }
    }
}

Réponse directe (40–70 mots)

Pour créer un PDF Data Matrix, instanciez Signature avec votre PDF source, définissez QrCodeSignOptions sur QrCodeTypes.HIBCLICDataMatrix et fournissez une chaîne HIBC correctement formatée, puis appelez signature.sign(outputPath, options). La bibliothèque écrit le PDF signé vers la destination, en préservant la mise en page et en intégrant le code‑barres comme une signature anti‑altération.

Comment ajouter un code QR à un PDF avec GroupDocs.Signature ?

Chargez le PDF, configurez QrCodeSignOptions pour le format QR, et appelez sign(). La bibliothèque redimensionne l’image QR pour la lisibilité et la positionne en fonction des coordonnées que vous définissez, évitant le chevauchement avec le contenu existant. Cela garantit que le code‑barres reste scannable après impression et conforme aux normes HIBC.

QrCodeSignOptions définit le contenu, la taille et la position du code‑barres QR.

  1. Importer les classes spécifiques au QR
QrCodeSignOptions hibcLic_AZ = new QrCodeSignOptions("A123PROD30917/75#422011907#GP293", QrCodeTypes.HIBCLICAztec);
hibcLic_AZ.setLeft(1); // Set the position from left
hibcLic_AZ.setTop(200); // Set the position from top
hibcLic_AZ.setReturnContent(true); // Return content after signing
hibcLic_AZ.setReturnContentType(FileType.PNG); // Specify return content type as PNG
  1. Créer et configurer les options QR – notez l’utilisation de QrCodeTypes.HIBCLICQR.
signature.sign(destinFilePath, hibcLic_AZ);
  1. Signer le document
QrCodeSignOptions hibcLic_DM = new QrCodeSignOptions("A123PROD30917/75#422011907#GP293", QrCodeTypes.HIBCLICDataMatrix);
hibcLic_DM.setLeft(1); // Set the position from left
hibcLic_DM.setTop(400); // Set the position from top
hibcLic_DM.setReturnContent(true); // Return content after signing
hibcLic_DM.setReturnContentType(FileType.PNG); // Specify return content type as PNG

Réponse directe : Utilisez QrCodeTypes.HIBCLICQR dans QrCodeSignOptions, définissez la chaîne de contenu HIBC, positionnez le code avec setLeft() et setTop(), puis appelez signature.sign(outputPath, options). Le code QR est intégré instantanément, prêt pour la capture par smartphone ou scanner.

Erreurs courantes à éviter

1. Oublier de libérer les ressources

Incorrect :

Signature signature = new Signature("sample.pdf");
signature.sign(destinFilePath, options);
// Oops, no dispose() call

Correction : Enveloppez l’utilisation de Signature dans un bloc try‑with‑resources ou appelez explicitement close() dans un bloc finally.

2. Utiliser des chaînes de format HIBC incorrectes

Incorrect : Utilisation de chaînes génériques comme « 12345 ».
Correction : Suivez la norme HIBCC (par ex., A123PROD30917/75#422011907#GP293). Validez avec le validateur en ligne HIBCC.

3. Codage en dur des chemins de fichiers

Incorrect :

String sourceFilePath = "C:/Users/John/Documents/test.pdf";

Correction : Stockez les chemins dans un fichier de configuration ou une variable d’environnement et lisez‑les à l’exécution.

4. Ignorer les conflits de position du code‑barres

Placez les codes‑barres loin du texte ou des signatures existants. Utilisez les coordonnées PDF (l’origine est en bas‑à‑gauche) et testez avec un échantillon imprimé.

5. Ne pas tester avec de vrais scanners

Imprimez le PDF signé et scannez‑le avec le matériel exact utilisé dans votre flux de travail. Vérifiez la lisibilité à différentes qualités d’impression.

Applications pratiques dans le secteur de la santé

ScénarioCode‑barres recommandéPourquoi cela convient
Distribution pharmaceutiqueQR CodeGrande capacité de données, largement scanné par les smartphones.
Gestion des stocksData MatrixPetite empreinte, idéal pour les étiquettes d’étagères denses.
Conformité réglementaire (FDA 21 CFR Part 11)QR + Data MatrixLe double format offre redondance et auditabilité.
Suivi des dispositifs médicauxAztec CodeTaille compacte adaptée aux emballages à espace limité.

Considérations de performance et meilleures pratiques

Modèle de traitement par lots

List<String> filesToSign = getFileList();
for (String filePath : filesToSign) {
    Signature signature = null;
    try {
        signature = new Signature(filePath);
        // Sign and save
    } finally {
        if (signature != null) signature.dispose();
    }
}
  • Créez une nouvelle instance Signature par fichier pour maintenir une faible utilisation de la mémoire.
  • Utilisez un pool de threads fixe (Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors() - 1)) pour le traitement parallèle, mais surveillez la taille du tas car chaque Signature conserve le PDF complet en mémoire.

Maintenir les bibliothèques à jour

Les versions de GroupDocs améliorent la vitesse de traitement jusqu’à 20 % et ajoutent de nouvelles fonctionnalités de conformité HIBC. Planifiez des vérifications de dépendances chaque trimestre.

Mise en cache des modèles

Chargez un modèle PDF une fois, clonez‑le pour chaque variante de code‑barres, et signez les clones. Cela réduit les I/O et accélère les flux de travail à haut volume.

Questions fréquemment posées

Q : GroupDocs.Signature peut‑il signer des types de fichiers autres que le PDF ?
R : Oui, il prend également en charge DOCX, XLSX, PPTX, PNG, JPEG et TIFF avec la même API de signature de code‑barres.

Q : Comment dépanner les erreurs « Contenu du code‑barres invalide » ?
R : Vérifiez que votre chaîne HIBC suit exactement la syntaxe HIBCC, utilisez le validateur en ligne, et assurez‑vous d’utiliser la constante QrCodeTypes correcte pour le format choisi.

Q : Quelle est la capacité maximale de données pour chaque format HIBC ?
R : QR ≈ 4 296 caractères alphanumériques, Aztec ≈ 3 832 numériques / 3 067 alphanumériques, Data Matrix ≈ 3 116 numériques / 2 335 alphanumériques. Gardez les codes sous 200 caractères pour une fiabilité de scan optimale.

Q : Est‑il possible d’intégrer plusieurs types de code‑barres dans un même PDF ?
R : Absolument. Créez des objets QrCodeSignOptions séparés avec des positions différentes et appelez signature.sign() pour chacun. Assurez‑vous simplement qu’ils ne se chevauchent pas.

Q : Ai‑je besoin d’une connexion Internet pour signer à l’exécution ?
R : Non. Après que le JAR soit sur le classpath et que la licence soit activée, toutes les opérations sont effectuées localement.

Ressources supplémentaires

Dernière mise à jour : 2026-09-15
Testé avec : GroupDocs.Signature 23.12 pour Java
Auteur : GroupDocs

Tutoriels associés