Créer une signature de code‑barres java – mettre à jour les codes‑barres PDF

Lorsque vous devez repositionner des codes‑barres sur des milliers d’étiquettes d’expédition ou ajuster leur emplacement après une refonte de modèle, le faire manuellement est source d’erreurs et très chronophage. Dans ce guide, vous apprendrez comment créer une signature de code‑barres java puis modifier sa position, sa taille et d’autres propriétés de façon programmatique avec GroupDocs.Signature pour Java. L’approche fonctionne pour les PDF, Word, Excel, PowerPoint et les fichiers image, vous offrant une API unique et cohérente pour tous vos scénarios d’automatisation de documents.

Réponses rapides

Que signifie « créer une signature de code‑barres » ? Cela consiste à générer un objet BarcodeSignature qui peut être placé, déplacé ou modifié à l’intérieur d’un document via l’API.
Puis‑je changer la taille du code‑barres après sa création ? Oui – utilisez setWidth/setHeight ou ajustez ses coordonnées Left/Top.
Ai‑je besoin d’une licence pour mettre à jour les codes‑barres ? Une version d’essai suffit pour le développement ; une licence complète est requise en production.
Cela ne fonctionne‑t‑il qu’avec les PDF ? Non – le même code fonctionne avec Word, Excel, PowerPoint et les formats d’image courants.
Combien de documents puis‑je traiter simultanément ? Le traitement par lots est pris en charge ; il suffit de gérer la mémoire avec try‑with‑resources.

Qu’est‑ce que créer une signature de code‑barres java ?

Créer une signature de code‑barres java, c’est le processus d’instanciation d’un objet BarcodeSignature qui représente un code‑barres intégré comme signature numérique dans un document. En utilisant l’API GroupDocs.Signature, vous pouvez ajouter programmétiquement un nouveau code‑barres, localiser ceux existants ou modifier leurs propriétés telles que la position, la taille et le texte encodé, le tout sans ouvrir le fichier dans un éditeur visuel.

Pourquoi utiliser GroupDocs.Signature pour Java ?

GroupDocs.Signature prend en charge plus de 50 formats d’entrée et de sortie — y compris PDF, DOCX, XLSX, PPTX et les types d’image courants—et peut traiter des PDF de plusieurs centaines de pages tout en maintenant l’utilisation de la mémoire en dessous de 100 Mo. Son API de traitement par lots gère jusqu’à 10 000 documents par exécution sur un serveur standard, rendant les mises à jour à grande échelle réalisables.

Prérequis

GroupDocs.Signature pour Java ≥ 23.12 (les versions antérieures ne contiennent pas les méthodes de mise à jour utilisées ici).
Java Development Kit 8 ou supérieur.
Un IDE tel qu’IntelliJ IDEA, Eclipse ou VS Code.
Connaissances de base en Java (classes, objets, gestion des exceptions).

Bibliothèques requises

Ajoutez GroupDocs.Signature à votre projet avec l’outil de construction de votre choix.

Maven

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

Gradle

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

Téléchargement direct – récupérez le JAR le plus récent depuis GroupDocs.Signature pour Java releases et ajoutez‑le à votre classpath.

Acquisition de licence

GroupDocs.Signature fonctionne avec les licences d’essai et les licences complètes :

Essai gratuit – idéal pour les preuves de concept.
Licence temporaire – pour une évaluation prolongée sur un projet spécifique.
Licence complète – supprime les filigranes et les limites d’utilisation en production.

Astuce pro : commencez avec l’essai gratuit, puis passez à la licence complète une fois le flux de travail validé.

Comment créer une signature de code‑barres java

Étape 1 : initialiser l’instance de signature

Signature est la classe principale qui charge un document et expose les méthodes de recherche, d’ajout et de mise à jour des signatures.

Réponse directe

Créez un objet Signature en passant le chemin du document à modifier ; cela charge le fichier en mémoire et le prépare aux opérations de code‑barres. La classe Signature est la porte d’entrée pour toutes les actions liées aux signatures. Elle lit le fichier et expose les méthodes de recherche, d’ajout ou de mise à jour des signatures.

import com.groupdocs.signature.Signature;
import java.nio.file.Paths;

String filePath = "YOUR_DOCUMENT_DIRECTORY/your_document.pdf";

Signature signature = new Signature(filePath);

Astuce pro : validez le chemin du fichier avant de construire l’instance Signature afin d’éviter FileNotFoundException.

Étape 2 : rechercher les signatures de code‑barres

BarcodeSearchOptions définit les critères utilisés lors du balayage d’un document à la recherche de signatures de code‑barres.

Réponse directe

Utilisez BarcodeSearchOptions avec la méthode search pour obtenir la liste de toutes les signatures de code‑barres présentes dans le document. Vous ne pouvez pas mettre à jour ce que vous ne trouvez pas. GroupDocs.Signature propose une API de recherche puissante qui filtre les signatures par type, numéro de page ou format de code‑barres.

import com.groupdocs.signature.options.search.BarcodeSearchOptions;
import com.groupdocs.signature.domain.signatures.BarcodeSignature;
import java.util.List;

BarcodeSearchOptions options = new BarcodeSearchOptions();

List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

Vous disposez maintenant d’une liste d’objets BarcodeSignature, chacun exposant des propriétés telles que Left, Top, Width, Height, Text et EncodeType.

Note de performance : pour les PDF très volumineux, limitez la recherche à des pages ou types de code‑barres spécifiques afin d’accélérer l’exécution.

Étape 3 : mettre à jour les propriétés du code‑barres

BarcodeSignature représente un code‑barres individuel intégré dans un document et fournit des setters pour ses attributs visuels.

Réponse directe

Modifiez les valeurs Left, Top, Width et Height du BarcodeSignature récupéré puis appelez signature.update pour écrire les changements dans un nouveau fichier. Cela vous permet de changer la taille du code‑barres ou de le repositionner où vous le souhaitez, tout en conservant le fichier source intact.

import java.io.File;
import com.groupdocs.signature.exception.GroupDocsSignatureException;

String fileName = Paths.get(filePath).getFileName().toString();
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY/UpdateBarcode/" + fileName).getPath();
checkDir(outputFilePath);

if (signatures.size() > 0) {
    BarcodeSignature barcodeSignature = signatures.get(0);
    
    // Update the barcode's position and size
    barcodeSignature.setLeft(100);
    barcodeSignature.setTop(100);
    
    // Apply the changes to the document
    boolean result = signature.update(outputFilePath, barcodeSignature);
    
    if (result) {
        System.out.println("Signature with Barcode '" +
            barcodeSignature.getText() + "' and encode type '"+
            barcodeSignature.getEncodeType().getTypeName() + "' was updated in the document ['" +
            fileName + "'].");
    }
} catch (GroupDocsSignatureException e) {
    System.err.println("Error updating signature: " + e.getMessage());
}

Points clés

setLeft / setTop déplacent le code‑barres (coordonnées mesurées depuis le coin supérieur gauche).
update crée un nouveau fichier ; l’original reste inchangé.
Enveloppez l’appel dans un bloc try‑catch pour gérer les éventuelles GroupDocsSignatureException.

Quand devez‑vous mettre à jour les signatures de code‑barres ?

Vous devez mettre à jour les signatures de code‑barres chaque fois que la mise en page des documents change, que les exigences réglementaires évoluent ou que vous devez traiter en lot des fichiers existants après une migration de données. La mise à jour programmatique évite la réédition manuelle, réduit le taux d’erreurs et assure un positionnement cohérent sur des milliers de fichiers.

Problèmes courants & solutions

Problème 1 : « Aucune signature de code‑barres trouvée »

Symptôme : la recherche renvoie une liste vide alors que des codes‑barres sont visibles dans le PDF.

Causes possibles

Les codes‑barres sont intégrés en tant qu’images ou champs de formulaire, pas en tant qu’objets signature.
Le document est protégé par mot de passe.
Vous filtrez un type de code‑barres qui ne correspond pas.

Solution

BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setAllPages(true); // Search all pages, not just the first
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

if (signatures.isEmpty()) {
    System.out.println("No barcode signatures found. The barcodes might be images, not signature objects.");
}

Problème 2 : Le document mis à jour apparaît corrompu

Symptôme : le PDF ne s’ouvre plus après la mise à jour.

Causes possibles

Espace disque insuffisant.
Le répertoire de sortie n’existe pas.
Les permissions du système de fichiers empêchent l’écriture.

Solution

File outputDir = new File("YOUR_OUTPUT_DIRECTORY/UpdateBarcode/");
if (!outputDir.exists()) {
    outputDir.mkdirs(); // Create directories if they don't exist
}

// Check write permissions
if (!outputDir.canWrite()) {
    throw new IOException("Cannot write to output directory: " + outputDir.getAbsolutePath());
}

Problème 3 : Dégradation des performances avec de gros documents

Symptôme : le traitement ralentit fortement pour les PDF de plus d’environ 50 pages.

Solution

BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setPageNumber(1); // Start with page 1
options.setPagesSetup(new PagesSetup());
options.getPagesSetup().setFirstPage(true);
options.getPagesSetup().setLastPage(false);

Conseils d’optimisation des performances

Gestion de la mémoire pour les opérations par lots

Traitez un document à la fois et laissez Java libérer les ressources automatiquement :

List<String> documentPaths = getDocumentList();
for (String path : documentPaths) {
    try (Signature sig = new Signature(path)) {
        // Process one document at a time
        // Signature instance is auto‑closed after each iteration
    }
}

Mise en cache des résultats de recherche

Si vous devez modifier plusieurs propriétés sur les mêmes codes‑barres, effectuez la recherche une seule fois et réutilisez la liste :

List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

// Update multiple properties
for (BarcodeSignature barcode : signatures) {
    barcode.setLeft(100);
    barcode.setTop(100);
    barcode.setWidth(200);
    barcode.setHeight(50);
}

// Single update call with all changes
signature.update(outputPath, signatures);

Traitement parallèle pour les gros volumes

Exploitez les streams Java pour accélérer le traitement de milliers de documents :

documentPaths.parallelStream().forEach(path -> {
    try (Signature sig = new Signature(path)) {
        List<BarcodeSignature> barcodes = sig.search(BarcodeSignature.class, new BarcodeSearchOptions());
        if (!barcodes.isEmpty()) {
            BarcodeSignature barcode = barcodes.get(0);
            barcode.setLeft(50);  // New position for smaller boxes
            barcode.setTop(10);
            sig.update(generateOutputPath(path), barcode);
        }
    } catch (Exception e) {
        logError(path, e);
    }
});

Applications pratiques

Cas d’utilisation 1 : mise à jour automatisée des étiquettes logistiques

Une société de transport a modifié les dimensions de ses cartons, nécessitant le repositionnement des codes‑barres sur 50 000 étiquettes existantes. Le fragment de traitement parallèle ci‑dessus a réduit le temps de travail de plusieurs jours à quelques heures.

Cas d’utilisation 2 : normalisation des modèles de contrat

Le service juridique a imposé un emplacement fixe du code‑barres pour la numérisation. En recherchant et en mettant à jour tous les PDF de contrats en un seul lot, l’équipe a évité des coûts de réimpression coûteux.

Cas d’utilisation 3 : intégration du système d’inventaire

Après une mise à jour d’ERP, les codes‑barres produits devaient s’aligner avec une nouvelle imprimante d’étiquettes. La mise à jour programmatique de la taille et de la position du code‑barres a permis d’économiser du temps et des matériaux.

Checklist de dépannage

Avant de solliciter le support, parcourez cette checklist :

Le chemin du fichier est correct et le fichier existe.
Les permissions de lecture/écriture sont accordées pour les sources et les destinations.
La version de GroupDocs.Signature est 23.12 ou supérieure.
La licence est correctement configurée (si vous utilisez une licence complète).
Le répertoire de sortie existe ou est créé programmatique.
Espace disque suffisant pour les fichiers de sortie.
Aucun autre processus ne verrouille le fichier source.
Gestion des exceptions en place pour capturer les erreurs.

Questions fréquentes

Q : Puis‑je mettre à jour le code‑barres Java pour plusieurs codes‑barres dans un même document ?
R : Absolument. Parcourez la List<BarcodeSignature> retournée par la recherche et appelez signature.update() pour chaque élément, ou transmettez la liste entière à un appel update unique.

Q : Quels types de code‑barres GroupDocs.Signature prend‑il en charge ?
R : Des dizaines, dont Code 128, QR Code, EAN‑13, UPC‑A, DataMatrix, PDF417, etc. Utilisez barcodeSignature.getEncodeType() pour connaître le type.

Q : Puis‑je changer le contenu réel du code‑barres (les données encodées) ?
R : Oui, via setText(), mais pensez à régénérer le code‑barres visuel afin que les scanners le lisent correctement.

Q : Comment gérer les documents contenant des codes‑barres sur plusieurs pages ?
R : Chaque BarcodeSignature possède getPageNumber(). Filtrez ou traitez les codes‑barres page par page selon vos besoins.

Q : Que devient le document original après la mise à jour ?
R : Le fichier source reste intact. GroupDocs écrit les modifications dans le chemin de sortie que vous spécifiez, préservant l’original pour plus de sécurité.

Q : Puis‑je mettre à jour les codes‑barres dans des PDF protégés par mot de passe ?
R : Oui. Utilisez la surcharge du constructeur Signature avec LoadOptions pour fournir le mot de passe.

Q : Comment traiter efficacement des milliers de documents en lot ?
R : Combinez les streams parallèles avec try‑with‑resources (comme montré dans l’exemple de traitement parallèle) et surveillez l’utilisation de la mémoire.

Q : Cette méthode fonctionne‑t‑elle avec d’autres formats que le PDF ?
R : Oui. La même API fonctionne avec Word, Excel, PowerPoint, les images et de nombreux autres formats supportés par GroupDocs.Signature.

Conclusion

Vous disposez maintenant d’un guide complet, prêt pour la production, pour créer des signatures de code‑barres java et mettre à jour leur position, taille et autres propriétés. Nous avons couvert l’initialisation, la recherche, la modification, le dépannage et l’optimisation des performances tant pour les scénarios mono‑document que pour les traitements par lots massifs.

Prochaines étapes

Expérimentez la mise à jour d’autres propriétés comme la rotation ou l’opacité dans le même passage.
Encapsulez la logique dans un service REST afin d’exposer les mises à jour de code‑barres comme point d’accès API.
Explorez les autres types de signatures (texte, image, numérique) en suivant le même modèle pour automatiser pleinement vos flux de travail documentaires.

Ressources

Dernière mise à jour : 2026-08-19
Testé avec : GroupDocs.Signature 23.12
Auteur : GroupDocs

Créer une signature de code‑barres java – mettre à jour les codes‑barres PDF

Réponses rapides

Qu’est‑ce que créer une signature de code‑barres java ?

Pourquoi utiliser GroupDocs.Signature pour Java ?

Prérequis

Bibliothèques requises

Acquisition de licence

Comment créer une signature de code‑barres java

Étape 1 : initialiser l’instance de signature

Réponse directe

Étape 2 : rechercher les signatures de code‑barres

Réponse directe

Étape 3 : mettre à jour les propriétés du code‑barres

Réponse directe

Quand devez‑vous mettre à jour les signatures de code‑barres ?

Problèmes courants & solutions

Problème 1 : « Aucune signature de code‑barres trouvée »

Problème 2 : Le document mis à jour apparaît corrompu

Problème 3 : Dégradation des performances avec de gros documents

Conseils d’optimisation des performances

Gestion de la mémoire pour les opérations par lots

Mise en cache des résultats de recherche

Traitement parallèle pour les gros volumes

Applications pratiques

Cas d’utilisation 1 : mise à jour automatisée des étiquettes logistiques

Cas d’utilisation 2 : normalisation des modèles de contrat

Cas d’utilisation 3 : intégration du système d’inventaire

Checklist de dépannage

Questions fréquentes

Conclusion

Prochaines étapes

Tutoriels associés

Qu’est‑ce que créer une signature de code‑barres java ?

Pourquoi utiliser GroupDocs.Signature pour Java ?

Étape 1 : initialiser l’instance de signature

Étape 2 : rechercher les signatures de code‑barres

Étape 3 : mettre à jour les propriétés du code‑barres

Quand devez‑vous mettre à jour les signatures de code‑barres ?

Problème 1 : « Aucune signature de code‑barres trouvée »

Problème 2 : Le document mis à jour apparaît corrompu

Problème 3 : Dégradation des performances avec de gros documents

Cas d’utilisation 1 : mise à jour automatisée des étiquettes logistiques

Cas d’utilisation 2 : normalisation des modèles de contrat

Cas d’utilisation 3 : intégration du système d’inventaire