Πώς να Προσθέσετε Σημειώσεις Διαγράμμισης σε PDF σε Java

Έχετε ποτέ χρειαστεί να διαγράψετε κείμενο σε ένα PDF προγραμματιστικά; Είτε δημιουργείτε σύστημα ανασκόπησης εγγράφων, είτε δημιουργείτε ροή εργασίας επεξεργασίας, είτε απλώς χρειάζεστε να σημειώσετε κείμενο για διαγραφή, how to add strikeout annotations in Java είναι μια πρακτική δεξιότητα που εξοικονομεί χρόνο και μειώνει την χειροκίνητη προσπάθεια. Σε αυτόν τον ολοκληρωμένο οδηγό θα ανακαλύψετε όλα όσα χρειάζεστε για να υλοποιήσετε σημειώσεις διαγράμμισης με το GroupDocs.Annotation for Java, από τη ρύθμιση του έργου μέχρι τη βελτιστοποίηση απόδοσης.

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

  • Ποιο είναι το πρώτο βήμα; Προσθέστε την εξάρτηση Maven του GroupDocs.Annotation στο pom.xml σας.
  • Πώς δημιουργώ μια διαγράμμιση; Δημιουργήστε ένα Annotator, ορίστε ένα StrikeoutAnnotation με σημεία, ορίστε χρώμα/διαφάνεια, και στη συνέχεια καλέστε addAnnotation.
  • Μπορώ να προσθέσω σχόλια; Ναι, επισυνάψτε ένα αντικείμενο Comment στη σημείωση για συνεργασία.
  • Τι γίνεται αν η σημείωση είναι εκτός θέσης; Προσαρμόστε τα σημεία συντεταγμένων· το PDF χρησιμοποιεί σύστημα προέλευσης κάτω‑αριστερά.
  • Υπάρχει όριο στο μέγεθος του εγγράφου; Το GroupDocs επεξεργάζεται PDF εκατοντάδων σελίδων χωρίς να φορτώνει ολόκληρο το αρχείο στη μνήμη.

Τι είναι το “how to add strikeout” σε Σημείωση PDF;

Η φράση “how to add strikeout” αναφέρεται στη διαδικασία προγραμματιστικής σχεδίασης μιας γραμμής μέσω του επιλεγμένου κειμένου μέσα σε ένα PDF χρησιμοποιώντας ένα API σημειώσεων. Στην Java, το GroupDocs.Annotation παρέχει μια αφιερωμένη κλάση StrikeoutAnnotation που διαχειρίζεται την απόδοση, το στυλ και τη διατήρηση των σημειώσεων διαγράμμισης.

Γιατί να Χρησιμοποιήσετε το GroupDocs για Java PDF Strikeout;

Το GroupDocs.Annotation υποστηρίζει 50+ μορφές εισόδου και εξόδου—συμπεριλαμβανομένων PDF, DOCX, XLSX, PPTX, HTML και κοινών τύπων εικόνων—οπότε δεν περιορίζεστε σε έναν μόνο τύπο αρχείου. Παρέχει ένα υψηλού επιπέδου API που αφαιρεί την πολυπλοκότητα της εσωτερικής δομής PDF, χειρίζεται αυτόματα την ενσωμάτωση γραμματοσειρών, την απόδοση σελίδων και τη διατήρηση σημειώσεων, επιτρέποντας στους προγραμματιστές να εστιάσουν στη λογική της επιχείρησης αντί για τις εσωτερικές λεπτομέρειες του PDF.

Προαπαιτούμενα και Απαιτήσεις Ρύθμισης

Απαραίτητες Απαιτήσεις

  • Java Development Kit (JDK): Έκδοση 8 ή νεότερη (συνιστάται JDK 11+ για βέλτιστη διαχείριση απορριψμάτων).
  • GroupDocs.Annotation for Java: Ενσωματώνεται μέσω Maven (δείτε το απόσπασμα Maven παρακάτω).
  • IDE: IntelliJ IDEA, Eclipse ή οποιοσδήποτε επεξεργαστής συμβατός με Java.

Ρύθμιση Εξαρτήσεων Maven

Προσθέστε το παρακάτω μπλοκ εξαρτήσεων στο pom.xml σας:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/annotation/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

Pro Tip: Πάντα ελέγχετε την πιο πρόσφατη έκδοση στη σελίδα κυκλοφορίας του GroupDocs· οι νεότερες εκδόσεις προσθέτουν λειτουργίες και διορθώνουν σφάλματα που μπορούν να επηρεάσουν την απόδοση των σημειώσεων.

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

Το GroupDocs.Annotation απαιτεί έγκυρη άδεια για παραγωγική χρήση. Έχετε τρεις επιλογές:

Η δοκιμή προσθέτει ένα διακριτικό υδατογράφημα, οπότε προγραμματίστε τη δοκιμή σας ανάλογα.

Οδηγός Υλοποίησης Βήμα‑βήμα

Κατανόηση των Βασικών Στοιχείων

Οι παρακάτω ορισμοί σας δίνουν ένα γρήγορο μοντέλο σκέψης:

  • Annotator: Το κύριο αντικείμενο API που φορτώνει ένα PDF και εκθέτει μεθόδους σημειώσεων.
  • StrikeoutAnnotation: Αντιπροσωπεύει τη γραμμή διαγράμμισης και τις επιλογές στυλ της.
  • Point: Ζεύγος συντεταγμένων (X, Y) που λέει στη βιβλιοθήκη πού ξεκινά και τελειώνει η γραμμή.
  • Comment: Προαιρετικό κείμενο που επισυνάπτεται σε μια σημείωση για συνεργασία.

Βήμα 1: Ρύθμιση Διαδρομών Αρχείων

Ορίστε τις θέσεις του πηγαίου PDF και του αρχείου προορισμού. Λανθασμένες διαδρομές είναι συχνή πηγή σφαλμάτων “File Not Found”.

String inputFilePath = "path/to/your/document/directory/sample.pdf";
String outputPath = "path/to/your/output/directory/AddTextStrikeoutAnnotation_output.pdf";

Common Mistake Alert: Βεβαιωθείτε ότι ο φάκελος εξόδου υπάρχει και είναι εγγράψιμος· το GroupDocs δεν δημιουργεί αυτόματα ελλιπείς φακέλους.

Βήμα 2: Αρχικοποίηση του Annotator

Δημιουργήστε μια παρουσία Annotator που φορτώνει το PDF στη μνήμη.

final Annotator annotator = new Annotator(inputFilePath);

What happens here? Η βιβλιοθήκη αναλύει τη δομή του PDF, δημιουργεί μια εσωτερική αναπαράσταση και προετοιμάζει έναν καμβά σημειώσεων ανά σελίδα. Για αρχεία εκατοντάδων σελίδων αυτό το βήμα μπορεί να διαρκέσει μερικά δευτερόλεπτα.

Βήμα 3: Προσθήκη Σχολίων (Προαιρετικό αλλά Συνιστάται)

Comment είναι μια κλάση που αντιπροσωπεύει μια κειμενική σημείωση που επισυνάπτεται σε μια σημείωση, επιτρέποντας στους συνεργάτες να εξηγήσουν τον λόγο της διαγράμμισης.

Reply reply1 = new Reply();
reply1.setComment("First comment");
reply1.setRepliedOn(Calendar.getInstance().getTime());

List<Reply> replies = new ArrayList<>();
replies.add(reply1);

Real‑world tip: Χρησιμοποιήστε σχόλια για να εξηγήσετε γιατί το κείμενο αφαιρείται—αυτό είναι ιδιαίτερα χρήσιμο σε νομικές ή επεξεργαστικές διαδικασίες ανασκόπησης.

Βήμα 4: Ορισμός Συντεταγμένων Σημείωσης

Τα αντικείμενα Point αποθηκεύουν ζεύγη συντεταγμένων X‑Y που ορίζουν την ακριβή θέση μιας σημείωσης σε μια σελίδα PDF.

Point point1 = new Point(80, 730);
Point point2 = new Point(240, 730);
List<Point> points = Arrays.asList(point1, point2);

Coordinate System Explained: Οι συντεταγμένες PDF ξεκινούν από την κάτω‑αριστερή γωνία (0,0). Το παράδειγμα δημιουργεί μια οριζόντια γραμμή από (80,730) έως (240,730) στη στοχευμένη σελίδα.

Finding the Right Coordinates: Πολλοί προγραμματιστές δημιουργούν μια βοηθητική συνάρτηση που μετατρέπει ποσοστά του πλάτους/ύψους της σελίδας σε απόλυτα σημεία, κάνοντας τον κώδικα ανθεκτικό σε διαφορετικά μεγέθη σελίδας.

Βήμα 5: Δημιουργία Σημείωσης Διαγράμμισης

StrikeoutAnnotation περιλαμβάνει τη γραμμή, τις ιδιότητες στυλ όπως χρώμα και διαφάνεια, καθώς και τυχόν μεταδεδομένα για τη διαγράμμιση.

StrikeoutAnnotation strikeout = new StrikeoutAnnotation();
strikeout.setCreatedOn(Calendar.getInstance().getTime());
strikeout.setFontColor(65535); // Yellow
strikeout.setMessage("This is a strikeout annotation");
strikeout.setOpacity(0.7);
strikeout.setPageNumber(0); 
strikeout.setPoints(points);
strikeout.setReplies(replies);

Color Values: Το fontColor χρησιμοποιεί δεκαδικές τιμές RGB (π.χ., 65535 για φωτεινό κίτρινο). Χρησιμοποιήστε έναν online μετατροπέα αν χρειάζεστε αποχρώσεις συγκεκριμένες για την μάρκα.

Opacity Recommendation: Μια διαφάνεια 0.7 (70 %) προσφέρει σαφή οπτική ένδειξη ενώ διατηρεί το κείμενο υποκείμενο αναγνώσιμο.

Βήμα 6: Εφαρμογή της Σημείωσης

addAnnotation είναι μέθοδος του Annotator που καταχωρεί την προετοιμασμένη σημείωση στο έγγραφο ώστε να αποδοθεί και να αποθηκευτεί.

annotator.add(strikeout);

Βήμα 7: Αποθήκευση και Καθαρισμός

dispose() απελευθερώνει τους εγγενείς πόρους που κρατά η παρουσία Annotator, αποτρέποντας διαρροές μνήμης μετά την ολοκλήρωση της επεξεργασίας.

annotator.save(outputPath);
annotator.dispose();

Memory Management Note: Η κλήση του dispose() ελευθερώνει εγγενείς πόρους και αποτρέπει διαρροές μνήμης όταν επεξεργάζεστε παρτίδες PDF.

Συνηθισμένα Προβλήματα και Πώς να Τα Διορθώσετε

Πρόβλημα 1: Σφάλματα “File Not Found”

Symptoms: Εξαίρεση κατά τη δημιουργία του Annotator.
Solution: Επαληθεύστε και τις εισόδους και τις εξόδους διαδρομές και βεβαιωθείτε ότι η εφαρμογή έχει δικαιώματα ανάγνωσης/εγγραφής.

// Add this check before creating the Annotator
File inputFile = new File(inputFilePath);
if (!inputFile.exists()) {
    throw new FileNotFoundException("Input file not found: " + inputFilePath);
}

Πρόβλημα 2: Η Διαγράμμιση Εμφανίζεται στη Λάθος Θέση

Symptoms: Η γραμμή δεν ευθυγραμμίζεται με το επιθυμητό κείμενο.
Solution: Θυμηθείτε ότι οι συντεταγμένες Y του PDF αυξάνονται προς τα πάνω. Χρησιμοποιήστε εργαλείο οπτικού debugging ή εκτυπώστε τις διαστάσεις της σελίδας για να ρυθμίσετε ακριβώς τα σημεία.

// Log your coordinates to understand the positioning
System.out.println("Annotation coordinates: " + point1 + " to " + point2);

// For debugging, try extreme coordinates first
Point debugPoint1 = new Point(0, 0);     // Bottom-left corner
Point debugPoint2 = new Point(100, 100); // Small area from corner

Πρόβλημα 3: Η Σημείωση Δεν Είναι Ορατή

Symptoms: Δεν εμφανίζεται καμία διαγράμμιση μετά την αποθήκευση.
Possible Causes & Fixes:

  • Opacity too low: Προσωρινά ορίστε τη διαφάνεια σε 1.0 για να ελέγξετε την ορατότητα.
  • Color blending: Χρησιμοποιήστε χρώμα υψηλής αντίθεσης όπως κόκκινο (255).
  • Incorrect page index: Οι αριθμοί σελίδας είναι μηδενικής βάσης· βεβαιωθείτε ότι στοχεύετε τη σωστή σελίδα.

Πρόβλημα 4: Προβλήματα Μνήμης με Μεγάλα Αρχεία

Symptoms: OutOfMemoryError ή αργή απόδοση.
Solutions:

  • Επεξεργαστείτε τα έγγραφα σε μικρότερες παρτίδες.
  • Χρησιμοποιήστε το streaming API αν είναι διαθέσιμο.
  • Πάντα καλέστε dispose() μετά από κάθε έγγραφο.
// Increase JVM heap size when running your application
// -Xmx2G for 2GB heap

// Process documents in batches rather than all at once
// Always dispose of Annotator instances promptly

Πραγματικές Εφαρμογές και Περιπτώσεις Χρήσης

Νομική Ανασκόπηση Εγγράφων

Οι νομικές εταιρείες σημειώνουν συμβάσεις με διαγράμμιση για να υποδείξουν διαγραμμένα άρθρα, διατηρώντας ένα αποτύπωμα ελέγχου.

Επεξεργασία Ακαδημαϊκών Εργασιών

Οι καθηγητές χρησιμοποιούν διαγράμμιση για να προτείνουν αφαιρέσεις κατά την αξιολόγηση, διατηρώντας το αρχικό κείμενο ορατό για το πλαίσιο.

Συστήματα Διαχείρισης Περιεχομένου

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

Έλεγχος Εκδόσεων για Έγγραφα

Οι επιχειρήσεις αντιμετωπίζουν τις σημειώσεις διαγράμμισης ως “δείκτες διαγραφής” σε ροή εργασίας ελέγχου εκδόσεων εγγράφων, παρόμοια με diff κώδικα.

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

Στρατηγική Επεξεργασίας σε Παρτίδες

Όταν επεξεργάζεστε πολλά PDF, επαναχρησιμοποιήστε μια ενιαία παρουσία Annotator όπου είναι δυνατόν και επεξεργαστείτε τα αρχεία σε παράλληλα νήματα.

// Instead of creating a new Annotator for each document:
// Process multiple annotations per document in one session
List<StrikeoutAnnotation> annotations = prepareAllAnnotations();
for (StrikeoutAnnotation annotation : annotations) {
    annotator.add(annotation);
}
annotator.save(outputPath);

Καλές Πρακτικές Διαχείρισης Μνήμης

  • Καλέστε dispose() σε κάθε Annotator.
  • Περιορίστε ταυτόχρονες φορτώσεις εγγράφων για να αποφύγετε πίεση στο heap.
  • Παρακολουθήστε τη χρήση μνήμης της JVM με εργαλεία όπως το VisualVM.

Κρυφή Μνήμη Συντεταγμένων

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

// Cache commonly used coordinate sets
private static final List<Point> STANDARD_HEADER_STRIKEOUT = 
    Arrays.asList(new Point(50, 750), new Point(300, 750));

// Reuse these coordinates instead of recreating them
strikeout.setPoints(STANDARD_HEADER_STRIKEOUT);

Προχωρημένες Επιλογές Προσαρμογής

Δυναμική Επιλογή Χρώματος

Επιλέξτε χρώματα κατά το χρόνο εκτέλεσης βάσει επιχειρηματικών κανόνων (π.χ., κόκκινο για κρίσιμες διαγραφές, κίτρινο για ενδεικτικές).

// Choose colors based on annotation type or user
int colorByPriority = getPriorityColor(annotationType);
strikeout.setFontColor(colorByPriority);

private int getPriorityColor(String type) {
    switch(type) {
        case "HIGH": return 255;    // Red
        case "MEDIUM": return 65535; // Yellow  
        case "LOW": return 65280;   // Green
        default: return 0;          // Black
    }
}

Πολυ‑γραμμική Διαγράμμιση

Δημιουργήστε μια σειρά από ζεύγη Point για να σχεδιάσετε μια γραμμή ζιγκ‑ζαγκ που διασχίζει πολλές γραμμές κειμένου.

// Create strikeouts that span multiple lines
List<Point> multiLinePoints = Arrays.asList(
    new Point(80, 730),   // Start of first line
    new Point(400, 730),  // End of first line
    new Point(80, 710),   // Start of second line
    new Point(200, 710)   // End of second line
);

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

  1. Δικαιώματα Αρχείου: Επαληθεύστε την πρόσβαση ανάγνωσης/εγγραφής.
  2. Έκδοση Βιβλιοθήκης: Βεβαιωθείτε ότι χρησιμοποιείτε μια υποστηριζόμενη έκδοση του GroupDocs.Annotation.
  3. Κατάσταση Άδειας: Επιβεβαιώστε ότι το αρχείο άδειας αναφέρεται σωστά.
  4. Συμβατότητα PDF: Ελέγξτε ότι το PDF δεν είναι κατεστραμμένο και βρίσκεται εντός των υποστηριζόμενων ορίων μεγέθους.
  5. Επικύρωση Συντεταγμένων: Βεβαιωθείτε ότι όλα τα σημεία βρίσκονται εντός των ορίων της σελίδας.
  6. Χώρος Heap: Αυξήστε το -Xmx της JVM εάν επεξεργάζεστε πολύ μεγάλα αρχεία.

Συχνές Ερωτήσεις

Q: Μπορώ να διαγράψω κείμενο σε πολλές γραμμές;
A: Ναι. Δημιουργήστε πολλά αντικείμενα Point που ακολουθούν το επιθυμητό μονοπάτι· η σημείωση θα ακολουθήσει την παρεχόμενη πολυγραμμή.

Q: Τι συμβαίνει αν ορίσω συντεταγμένες εκτός των ορίων της σελίδας;
A: Η σημείωση θα περικοπεί και μπορεί να γίνει αόρατη. Πάντα επικυρώστε τις συντεταγμένες έναντι του πλάτους και του ύψους της σελίδας.

Q: Μπορώ να αφαιρέσω σημειώσεις διαγράμμισης μετά την προσθήκη τους;
A: Απόλυτα. Χρησιμοποιήστε τη μέθοδο removeAnnotation με το ID της σημείωσης ή φιλτράρετε ανά τύπο για να τις διαγράψετε προγραμματιστικά.

Q: Υπάρχει όριο στον αριθμό σημειώσεων που μπορώ να προσθέσω σε ένα PDF;
A: Το GroupDocs δεν επιβάλλει σκληρό όριο, αλλά η απόδοση μπορεί να μειωθεί μετά από χιλιάδες σημειώσεις. Σκεφτείτε σελιδοποίηση ή σύνοψη σημειώσεων για πολύ μεγάλα σύνολα.

Q: Πώς δουλεύω με PDF προστατευμένα με κωδικό;
A: Περνάτε τον κωδικό στον κατασκευαστή Annotator. Η βιβλιοθήκη θα αποκρυπτογραφήσει το έγγραφο στη μνήμη πριν εφαρμόσει οποιεσδήποτε σημειώσεις.

Q: Πώς μπορώ να χειριστώ PDF με διαφορετικά μεγέθη και προσανατολισμούς σελίδας;
A: Ανακτήστε τις διαστάσεις κάθε σελίδας μέσω annotator.getPageInfo(pageNumber) και υπολογίστε τις συντεταγμένες σχετικά με αυτές τις διαστάσεις για να εξασφαλίσετε συνεπή τοποθέτηση.

Συμπέρασμα

Τώρα έχετε μια πλήρη, έτοιμη για παραγωγή λύση για how to add strikeout annotations σε PDF σε Java χρησιμοποιώντας το GroupDocs.Annotation. Με την εξοικείωση στη διαχείριση διαδρομών αρχείων, τον υπολογισμό συντεταγμένων και τη διαχείριση πόρων, μπορείτε να ενσωματώσετε αυτή τη δυνατότητα σε εργαλεία ανασκόπησης εγγράφων, pipelines περιεχομένου ή οποιαδήποτε εφαρμογή Java που χρειάζεται ακριβή οπτική ανάδραση.

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

  1. Κλωνοποιήστε το παράδειγμα έργου και εκτελέστε το σε ένα δείγμα PDF.
  2. Πειραματιστείτε με διαφορετικά χρώματα, διαφάνειες και κείμενα σχολίων.
  3. Ενσωματώστε τη ροή εργασίας σημειώσεων στην υπάρχουσα υπηρεσία επεξεργασίας εγγράφων.
  4. Εξερευνήστε σχετικούς τύπους σημειώσεων—υπογραμμίσεις, σημειώσεις sticky και σχήματα—για να διευρύνετε το σύνολο εργαλείων χειρισμού PDF.

Έτοιμοι για περισσότερα; Βυθιστείτε στην επίσημη τεκμηρίωση για πιο βαθιές γνώσεις API.

Πρόσθετοι Πόροι

Last Updated: 2026-05-21
Tested With: GroupDocs.Annotation 23.12 for Java
Author: GroupDocs

Σχετικά Μαθήματα