Create Barcode Signature in Java – Update PDF Barcodes

Εισαγωγή

Σας έχει συμβεί ποτέ να χρειαστεί να μετακινήσετε ένα barcode σε χιλιάδες ετικέτες αποστολής μετά από ανασχεδιασμό της συσκευασίας; Ή να ενημερώσετε τις θέσεις των barcode σε πρότυπα συμβάσεων όταν η νομική σας ομάδα αλλάζει τις διατάξεις των εγγράφων; Δεν είστε μόνοι—αυτά τα σενάρια εμφανίζονται συνεχώς σε ροές εργασίας αυτοματοποίησης εγγράφων.

Η χειροκίνητη ενημέρωση μιας barcode signature είναι επίπονη και επιρρεπής σε σφάλματα. Με το GroupDocs.Signature για Java, μπορείτε να create barcode signature αντικείμενα και στη συνέχεια να τα τροποποιήσετε με λίγες μόνο γραμμές κώδικα. Είτε δημιουργείτε ένα σύστημα αποθεμάτων, αυτοματοποιείτε έγγραφα logistics, είτε διαχειρίζεστε νομικές συμβάσεις, η προγραμματιστική ενημέρωση των barcode signatures εξοικονομεί ώρες χειροκίνητης εργασίας.

Τι θα μάθετε σε αυτό το tutorial:

• Ρύθμιση και αρχικοποίηση του Signature API με τα έγγραφά σας
• Αποτελεσματική αναζήτηση υπάρχουσων barcode signatures
• Ενημέρωση θέσεων, μεγεθών και άλλων ιδιοτήτων του barcode (συμπεριλαμβανομένου του πώς να change barcode size)
• Διαχείριση κοινών σφαλμάτων και ειδικών περιπτώσεων
• Βελτιστοποίηση απόδοσης για λειτουργίες batch

Ας ξεκινήσουμε βεβαιώνοντας ότι έχετε όλα όσα χρειάζεστε πριν γράψετε κώδικα.

Προαπαιτούμενα

Πριν μπορέσετε να ενημερώσετε κώδικα Java για barcode signature στα έργα σας, βεβαιωθείτε ότι έχετε καλύψει τα παρακάτω απαραίτητα:

Απαιτούμενες βιβλιοθήκες

• GroupDocs.Signature for Java: Έκδοση 23.12 ή νεότερη (παλαιότερες εκδόσεις μπορεί να λείπουν οι μέθοδοι ενημέρωσης που θα χρησιμοποιήσουμε).

Ρύθμιση Περιβάλλοντος

• Μία λειτουργική Java Development Kit (JDK) (συνιστάται JDK 8 ή νεότερο)
• Ένα IDE όπως IntelliJ IDEA, Eclipse ή VS Code

Προαπαιτούμενες Γνώσεις

• Βασική Java (κλάσεις, αντικείμενα, διαχείριση εξαιρέσεων)
• Διαχείριση αρχείων σε Java (διαδρομές, κατάλογοι)
• Προαιρετικά: Κατανόηση της δομής PDF και των εννοιών barcode

Τα έχετε όλα αυτά; Τέλεια! Ας εγκαταστήσουμε τη βιβλιοθήκη.

Ρύθμιση GroupDocs.Signature για Java

Η προσθήκη του GroupDocs.Signature στο Java έργο σας είναι απλή. Επιλέξτε το εργαλείο κατασκευής που χρησιμοποιείτε:

Maven

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

Gradle

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

Direct Download: Εάν δεν χρησιμοποιείτε εργαλείο κατασκευής, κατεβάστε το πιο πρόσφατο αρχείο JAR από GroupDocs.Signature for Java releases και προσθέστε το στο classpath του έργου σας χειροκίνητα.

Απόκτηση Άδειας

Το GroupDocs.Signature λειτουργεί τόσο με δοκιμαστικές όσο και με πλήρεις άδειες:

• Free Trial – ιδανική για δοκιμές και αποδείξεις έννοιας
• Temporary License – για εκτεταμένη αξιολόγηση σε συγκεκριμένο έργο
• Full License – αφαιρεί υδατογραφήματα και περιορισμούς χρήσης για παραγωγή

Pro Tip: Ξεκινήστε με τη δωρεάν δοκιμή για να επαληθεύσετε ότι το API καλύπτει τις ανάγκες σας, στη συνέχεια αναβαθμίστε όταν είστε έτοιμοι για παραγωγή.

Τώρα που η βιβλιοθήκη είναι εγκατεστημένη, ας εμβαθύνουμε στην πραγματική υλοποίηση.

Γρήγορες Απαντήσεις

• Τι σημαίνει “create barcode signature”; Σημαίνει τη δημιουργία ενός αντικειμένου barcode που μπορεί να τοποθετηθεί, μετακινηθεί ή επεξεργαστεί μέσα σε ένα έγγραφο μέσω του API.
• Μπορώ να αλλάξω το μέγεθος του barcode μετά τη δημιουργία του; Ναι – χρησιμοποιήστε τις μεθόδους setWidth και setHeight ή προσαρμόστε τις συντεταγμένες Left/Top.
• Χρειάζομαι άδεια για την ενημέρωση barcode; Η δοκιμαστική λειτουργεί για ανάπτυξη· απαιτείται πλήρης άδεια για παραγωγή.
• Λειτουργεί μόνο με PDF; Όχι – ο ίδιος κώδικας λειτουργεί με Word, Excel, PowerPoint και αρχεία εικόνας.
• Πόσα έγγραφα μπορώ να επεξεργαστώ ταυτόχρονα; Υποστηρίζεται επεξεργασία batch· απλώς διαχειριστείτε τη μνήμη με try‑with‑resources.

Πώς να δημιουργήσετε barcode signature σε Java

Βήμα 1: Αρχικοποίηση του αντικειμένου Signature

Γιατί είναι σημαντικό

Σκεφτείτε το αντικείμενο Signature ως την πύλη προς το έγγραφό σας. Φορτώνει το PDF (ή οποιαδήποτε υποστηριζόμενη μορφή) στη μνήμη και σας δίνει πρόσβαση σε όλες τις λειτουργίες που σχετίζονται με υπογραφές. Χωρίς αυτήν την αρχικοποίηση, δεν μπορείτε να αναζητήσετε ή να τροποποιήσετε τίποτα.

Υλοποίηση

First, import the required class and define the file path:

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

String filePath = "YOUR_DOCUMENT_DIRECTORY/your_document.pdf";

Signature signature = new Signature(filePath);

Τι συμβαίνει; Ο κατασκευαστής διαβάζει το αρχείο και το προετοιμάζει για επεξεργασία. Η διαδρομή μπορεί να είναι απόλυτη ή σχετική—απλώς βεβαιωθείτε ότι η διαδικασία Java έχει δικαίωμα ανάγνωσης.

Pro tip: Επικυρώστε τη διαδρομή πριν δημιουργήσετε το αντικείμενο Signature για να αποφύγετε το FileNotFoundException.

Βήμα 2: Αναζήτηση Barcode Signatures

Γιατί η αναζήτηση πρώτα είναι απαραίτητη

Δεν μπορείτε να ενημερώσετε κάτι που δεν μπορείτε να βρείτε. Το GroupDocs.Signature παρέχει ένα ισχυρό API αναζήτησης που φιλτράρει τις υπογραφές ανά τύπο.

Υλοποίηση

Import the search‑related classes:

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

Configure the search options (default searches all pages):

BarcodeSearchOptions options = new BarcodeSearchOptions();

Execute the search:

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

Τώρα έχετε μια λίστα από αντικείμενα BarcodeSignature, το καθένα εκθέτει ιδιότητες όπως Left, Top, Width, Height, Text και EncodeType.

Σημείωση απόδοσης: Για πολύ μεγάλα PDF, σκεφτείτε να περιορίσετε την αναζήτηση σε συγκεκριμένες σελίδες ή τύπους barcode για να επιταχύνετε τη διαδικασία.

Βήμα 3: Ενημέρωση Ιδιοτήτων Barcode

Το κύριο γεγονός: Τροποποίηση Barcode Signatures

Τώρα μπορείτε να change barcode size ή να το μετακινήσετε όπου χρειάζεται.

Υλοποίηση

First, import exception handling classes:

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

Set up the output path where the modified document will be saved:

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

Now, locate the first barcode (or iterate over the list) and apply the changes:

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

Κύρια σημεία:

• setLeft / setTop μετακινούν το barcode (συντεταγμένες μετρημένες από την επάνω‑αριστερή γωνία).
• Η μέθοδος update γράφει ένα νέο αρχείο· το αρχικό παραμένει αμετάβλητο.
• Τυλίξτε την κλήση σε μπλοκ try‑catch για να διαχειριστείτε πιθανές εξαιρέσεις GroupDocsSignatureException.

Πότε πρέπει να ενημερώνετε Barcode Signatures;

Η κατανόηση των κατάλληλων σεναρίων σας βοηθά να σχεδιάσετε αποδοτικές ροές εργασίας.

Αναπροσαρμογή Εγγράφων & Ενημερώσεις Προτύπων

Ένα νέο letterhead ή διάταξη ετικέτας συχνά σημαίνει ότι τα barcode πρέπει να μετακινηθούν. Η αυτοματοποίηση με Java ξεπερνά την χειροκίνητη επεξεργασία εκατοντάδων αρχείων.

Επεξεργασία Batch μετά από Μεταφορά Δεδομένων

Τα μεταφερθέντα PDF ενδέχεται να μην ακολουθούν τα τρέχοντα πρότυπα τοποθέτησης barcode. Μια μαζική ενημέρωση αποκαθιστά τη συνέπεια χωρίς να χρειάζεται η δημιουργία εκ νέου κάθε εγγράφου.

Προσαρμογές Κανονιστικής Συμμόρφωσης

Βιομηχανίες όπως η logistics ή η υγειονομική περίθαλψη μπορεί να αλλάξουν τους κανόνες τοποθέτησης barcode. Ένα γρήγορο script σας βοηθά να παραμείνετε συμμορφωμένοι.

Δυναμική Δημιουργία Εγγράφων

Εάν το μήκος του περιεχομένου του εγγράφου διαφέρει, ίσως χρειαστεί να προσαρμόσετε τις συντεταγμένες του barcode άμεσα.

Πότε ΔΕΝ πρέπει να χρησιμοποιείτε ενημερώσεις: Εάν δημιουργείτε ένα ολοκαίνουργιο έγγραφο, τοποθετήστε το barcode σωστά από την αρχή αντί να το προσθέσετε και στη συνέχεια να το ενημερώσετε.

Κοινά Προβλήματα & Λύσεις

Πρόβλημα 1: “Δεν βρέθηκαν Barcode Signatures”

Σύμπτωμα: Η αναζήτηση επιστρέφει κενή λίστα παρόλο που βλέπετε barcode στο PDF.

Πιθανές Αιτίες

• Τα barcode είναι ενσωματωμένα ως εικόνες ή πεδία φόρμας, όχι ως αντικείμενα υπογραφής.
• Το έγγραφο είναι προστατευμένο με κωδικό.
• Φιλτράρετε για συγκεκριμένο τύπο barcode που δεν ταιριάζει.

Λύση

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

Πρόβλημα 2: Το ενημερωμένο έγγραφο φαίνεται κατεστραμμένο

Σύμπτωμα: Το PDF δεν ανοίγει μετά την ενημέρωση.

Πιθανές Αιτίες

• Ανεπαρκής χώρος δίσκου.
• Ο φάκελος εξόδου δεν υπάρχει.
• Τα δικαιώματα του συστήματος αρχείων εμποδίζουν τη γραφή.

Λύση

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

Πρόβλημα 3: Μείωση Απόδοσης με Μεγάλα Έγγραφα

Σύμπτωμα: Η επεξεργασία επιβραδύνεται δραματικά για PDF πάνω από ~50 σελίδες.

Λύση

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

Συμβουλές Βελτιστοποίησης Απόδοσης

Διαχείριση Μνήμης για Λειτουργίες Batch

Process one document at a time and let Java clean up resources automatically:

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

Caching Αποτελεσμάτων Αναζήτησης

If you need to modify several properties on the same barcodes, search once and reuse the list:

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

Παράλληλη Επεξεργασία για Μεγάλες Παρτίδες

Leverage Java streams to speed up thousands of 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);
    }
});

Πρακτικές Εφαρμογές

Περίπτωση Χρήσης 1: Αυτόματες Ενημερώσεις Ετικετών Logistics

Μια εταιρεία αποστολών άλλαξε τις διαστάσεις των κουτιών, απαιτώντας μετακίνηση barcode σε 50.000 υπάρχουσες ετικέτες. Το παραπάνω απόσπασμα παράλληλης επεξεργασίας μείωσε τη δουλειά από ημέρες σε λίγες ώρες.

Περίπτωση Χρήσης 2: Τυποποίηση Προτύπων Συμβάσεων

Η νομική ομάδα επέβαλε σταθερή θέση barcode για σάρωση. Αναζητώντας και ενημερώνοντας όλα τα PDF συμβάσεων σε μία παρτίδα, η ομάδα απέφυγε το δαπανηρό χειροκίνητο εκτύπωση.

Περίπτωση Χρήσης 3: Ενσωμάτωση Συστήματος Αποθεμάτων

Μετά από αναβάθμιση ERP, τα barcode προϊόντων έπρεπε να ευθυγραμμιστούν με νέο εκτυπωτή ετικετών. Η προγραμματιστική ενημέρωση του μεγέθους και της θέσης του barcode εξοικονόμησε χρόνο και κόστος υλικών.

Λίστα Ελέγχου Επίλυσης Προβλημάτων

Πριν ζητήσετε υποστήριξη, ελέγξτε τα παρακάτω:

• File path is correct and the file exists
• Read/write permissions are granted for source and destination
• GroupDocs.Signature version is 23.12 or later
• License is properly configured (if using a full license)
• Output directory exists or is created programmatically
• Sufficient disk space for output files
• No other process is locking the source file
• Exception handling is in place to capture errors

Ενότητα Συχνών Ερωτήσεων

Ε: Μπορώ να ενημερώσω κώδικα Java barcode signature για πολλαπλά barcode σε ένα έγγραφο;
Α: Απόλυτα. Επανάληψη μέσω του List<BarcodeSignature> που επιστρέφει η αναζήτηση και κλήση του signature.update() για κάθε ένα, ή περάστε όλη τη λίστα σε μία κλήση update.

Ε: Τι τύπους barcode υποστηρίζει το GroupDocs.Signature;
Α: Δεκάδες, συμπεριλαμβανομένων των Code 128, QR Code, EAN‑13, UPC‑A, DataMatrix, PDF417 κ.ά. Χρησιμοποιήστε barcodeSignature.getEncodeType() για να ελέγξετε τον τύπο.

Ε: Μπορώ να αλλάξω το πραγματικό περιεχόμενο του barcode (τα κωδικοποιημένα δεδομένα);
Α: Ναι, μέσω setText(), αλλά θυμηθείτε να αναδημιουργήσετε το οπτικό barcode ώστε οι σαρωτές να το διαβάζουν σωστά.

Ε: Πώς διαχειρίζομαι έγγραφα με barcode σε πολλαπλές σελίδες;
Α: Κάθε BarcodeSignature περιλαμβάνει getPageNumber(). Φιλτράρετε ή επεξεργαστείτε barcode ανά σελίδα όπως χρειάζεται.

Ε: Τι γίνεται με το αρχικό έγγραφο μετά την ενημέρωση;
Α: Το αρχείο προέλευσης παραμένει αμετάβλητο. Το GroupDocs γράφει τις αλλαγές στη διαδρομή εξόδου που καθορίζετε, διατηρώντας το αρχικό για ασφάλεια.

Ε: Μπορώ να ενημερώσω barcode σε PDF προστατευμένα με κωδικό;
Α: Ναι. Χρησιμοποιήστε την υπερφόρτωση LoadOptions του κατασκευαστή Signature για να δώσετε τον κωδικό.

Ε: Πώς επεξεργάζομαι χιλιάδες έγγραφα σε παρτίδες αποδοτικά;
Α: Συνδυάστε παράλληλα streams με try‑with‑resources (όπως φαίνεται στο παράδειγμα παράλληλης επεξεργασίας) και παρακολουθήστε τη χρήση μνήμης.

Ε: Λειτουργεί αυτό με μορφές εκτός του PDF;
Α: Ναι. Το ίδιο API λειτουργεί με Word, Excel, PowerPoint, εικόνες και πολλές άλλες μορφές που υποστηρίζει το GroupDocs.Signature.

Συμπέρασμα

Τώρα έχετε έναν πλήρη, έτοιμο για παραγωγή οδηγό για create barcode signature αντικείμενα σε Java και την ενημέρωση της θέσης, του μεγέθους και άλλων ιδιοτήτων τους. Καλύψαμε την αρχικοποίηση, την αναζήτηση, την τροποποίηση, την επίλυση προβλημάτων και τη βελτιστοποίηση απόδοσης για σενάρια τόσο μεμονωμένων εγγράφων όσο και μαζικών παρτίδων.

Επόμενα Βήματα

• Δοκιμάστε την ενημέρωση πολλαπλών ιδιοτήτων (π.χ., περιστροφή, διαφάνεια) σε μία κλήση.
• Δημιουργήστε μια υπηρεσία REST γύρω από αυτόν τον κώδικα για να εκθέσετε τις ενημερώσεις barcode ως API.
• Εξερευνήστε άλλους τύπους υπογραφών (κείμενο, εικόνα, ψηφιακή) χρησιμοποιώντας το ίδιο μοτίβο.

Το API του GroupDocs.Signature προσφέρει πολύ περισσότερα από ενημερώσεις barcode—εξερευνήστε την επαλήθευση, τη διαχείριση μεταδεδομένων και την υποστήριξη πολλαπλών μορφών για πλήρη αυτοματοποίηση των ροών εργασίας εγγράφων.

Resources

• GroupDocs.Signature for Java Documentation
• API Reference
• Support Forum
• Free Trial Download

Last Updated: 2026-01-16
Tested With: GroupDocs.Signature 23.12
Author: GroupDocs