Προσθήκη σχολίων σε PDF

Αν χρειάζεται να προσθέσετε σχολιασμούς σε PDF αρχεία από μια εφαρμογή Java—είτε δημιουργείτε μια πύλη αξιολόγησης συμβάσεων, μια πλατφόρμα e‑learning ή έναν συνεργατικό επεξεργαστή εγγράφων—αυτό το tutorial σας δείχνει ακριβώς πώς να το κάνετε με το GroupDocs.Annotation. Θα μάθετε να φορτώνετε PDFs, να δημιουργείτε σχόλια τύπου περιοχής, να διαχειρίζεστε πόρους αποδοτικά και να επεξεργάζεστε μεγάλα αρχεία χωρίς να εξαντλείται η μνήμη.

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

  • Ποιος είναι ο κύριος σκοπός του GroupDocs.Annotation; Να προσθέτει, να επεξεργάζεται και να διαχειρίζεται σχόλια σε πολλές μορφές εγγράφων από Java.
  • Ποιος τύπος σχολίου είναι ο καλύτερος για σχόλια αξιολόγησης; AreaAnnotation με προσαρμοσμένο μήνυμα και μεταδεδομένα χρήστη.
  • Χρειάζομαι άδεια για ανάπτυξη; Μια δωρεάν δοκιμή λειτουργεί για δοκιμές· απαιτείται πλήρης άδεια για παραγωγή.
  • Μπορώ να επεξεργαστώ PDFs μεγαλύτερα από 50 MB; Ναι—χρησιμοποιήστε streaming, batch processing και σωστή διαχείριση πόρων για χαμηλή χρήση μνήμης.
  • Η βιβλιοθήκη είναι thread‑safe; Τα instances δεν είναι thread‑safe· δημιουργήστε ξεχωριστό Annotator ανά νήμα.

Γιατί το GroupDocs Annotation ξεχωρίζει

Το GroupDocs.Annotation σας επιτρέπει να προσθέσετε σχολιασμούς σε PDF γρήγορα, ενώ υποστηρίζει ένα ευρύ οικοσύστημα τύπων αρχείων. Προσφέρει:

  • Πλήρης υποστήριξη μορφών – 50+ μορφές εισόδου και εξόδου, συμπεριλαμβανομένων DOCX, PPTX, XLSX, JPEG, PNG και TIFF.
  • Πλούσια παλέτα σχολίων – επισημάνσεις, βέλη, υδατογραφήματα, αντικαταστάσεις κειμένου και προσαρμοσμένα σχήματα, όλα διαθέσιμα μέσω ενός API.
  • Χαρακτηριστικά επιπέδου επιχείρησης – ενσωματωμένη αδειοδότηση, επιλογές κλιμάκωσης και απρόσκοπτη ενσωμάτωση με υπάρχουσες στοίβες Java.
  • Ενεργή ανάπτυξη – μηνιαίες εκδόσεις φέρνουν βελτιώσεις απόδοσης (έως 30 % ταχύτερη απόδοση) και νέους τύπους σχολίων.

Προαπαιτούμενα και απαιτήσεις εγκατάστασης

Τι θα χρειαστείτε πριν ξεκινήσετε

  • Περιβάλλον ανάπτυξης – JDK 8 ή νεότερο (συνιστάται Java 11+), Maven ή Gradle, και το αγαπημένο σας IDE (IntelliJ IDEA, Eclipse ή VS Code).
  • Βασικές γνώσεις – σύνταξη Java, I/O αρχείων και διαχείριση εξαρτήσεων Maven.
  • Προαιρετικό – εξοικείωση με τις συντεταγμένες σελίδας PDF και προηγούμενη εμπειρία με άλλες βιβλιοθήκες Java.

Ρύθμιση του GroupDocs.Annotation για Java

Διαμόρφωση Maven

Προσθέστε το αποθετήριο GroupDocs και την εξάρτηση Annotation στο pom.xml. Αντικαταστήστε το 25.2 με την πιο πρόσφατη έκδοση εάν υπάρχει νεότερη.

<!-- Maven repository -->
<repository>
    <id>groupdocs-repo</id>
    <url>https://repo.groupdocs.com/maven2</url>
</repository>

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

Pro tip: Πάντα ελέγχετε την τελευταία έκδοση στην ιστοσελίδα του GroupDocs. Οι νέες εκδόσεις συχνά περιλαμβάνουν έως 20 % μείωση της κατανάλωσης μνήμης για μεγάλα PDFs.

Επιλογές αδειοδότησης (και τι σημαίνουν στην πραγματικότητα)

  • Δωρεάν δοκιμή – έξοδος με υδατογράφημα, ιδανική για αξιολόγηση.
  • Προσωρινή άδεια – απεριόριστη για 30 ημέρες· αποκτήστε μια προσωρινή άδεια Προσωρινή Άδεια.
  • Πλήρης άδεια – απαιτείται για παραγωγικές εγκαταστάσεις· η τιμολόγηση διαφέρει ανάλογα με την κλίμακα της υλοποίησης.

Αρχική επαλήθευση

Μετά την προσθήκη της εξάρτησης, εκτελέστε αυτό το μικρό τεστ για να επιβεβαιώσετε ότι η βιβλιοθήκη φορτώνεται σωστά:

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

Πώς να δημιουργήσετε σχολιασμούς PDF με Java και GroupDocs.Annotation

Φορτώστε το έγγραφο, προσθέστε ένα AreaAnnotation και αποθηκεύστε το αποτέλεσμα. Η παρακάτω άμεση απάντηση συνοψίζει όλη τη διαδικασία:

Φορτώστε το PDF σας με new Annotator("input.pdf"), δημιουργήστε ένα AreaAnnotation που ορίζει το ορθογώνιο και το κείμενο σχολίου, προσθέστε το σχόλιο στο Annotator, έπειτα καλέστε save("output.pdf"). Αυτό το τρι‑βήμα μοτίβο διαχειρίζεται οποιοδήποτε μέγεθος PDF και εξασφαλίζει αυτόματη απελευθέρωση πόρων.

Φόρτωση εγγράφων: περισσότερο από απλούς διαδρόμους αρχείων

Βασική φόρτωση εγγράφου

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

Annotator annotator = new Annotator("sample.pdf");

Real‑world context: Σε παραγωγικό περιβάλλον, η διαδρομή αρχείου μπορεί να προέρχεται από φάκελο ανεβάσματος, blob βάσης δεδομένων ή URL αποθήκευσης στο cloud. Το GroupDocs.Annotation δέχεται τοπικά αρχεία, InputStreams και απομακρυσμένα URLs χωρίς επιπλέον κώδικα.

Διαχείριση διαφορετικών πηγών εισόδου

Μπορείτε επίσης να φορτώσετε ένα PDF από byte array ή από HTTP URL:

import com.groupdocs.annotation.Annotator;

public class SetupVerification {
    public static void main(String[] args) {
        try {
            // This should not throw any ClassNotFoundException
            System.out.println("GroupDocs.Annotation version: " + 
                com.groupdocs.annotation.internal.c.a.a.d());
            System.out.println("Setup successful!");
        } catch (Exception e) {
            System.err.println("Setup failed: " + e.getMessage());
        }
    }
}

Προσθήκη του πρώτου σας σχολίου

Κατανόηση σχολίων περιοχής

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

AreaAnnotation area = new AreaAnnotation();
area.setRectangle(new Rectangle(100, 150, 200, 80)); // x, y, width, height
area.setComment("Review this section for compliance.");
area.setCreator("alice@example.com");

Coordinate system explained: Οι συντεταγμένες PDF ξεκινούν από το κάτω‑αριστερό, αλλά το GroupDocs χρησιμοποιεί προέλευση πάνω‑αριστερά, που ευθυγραμμίζεται με τυπικά UI frameworks. Οι τιμές εκφράζονται σε points (1/72 ίντσα).

Πρακτικά παραδείγματα σχολιασμού

Επισήμανση σημαντικού κειμένου

HighlightAnnotation highlight = new HighlightAnnotation();
highlight.setRectangle(new Rectangle(50, 200, 300, 20));
highlight.setColor(Color.YELLOW);
annotator.add(highlight);

Δημιουργία σχολίων αξιολόγησης

AreaAnnotation comment = new AreaAnnotation();
comment.setRectangle(new Rectangle(120, 400, 250, 100));
comment.setComment("Please verify the calculation in this paragraph.");
comment.setCreator("bob@example.com");
annotator.add(comment);

Αποθήκευση και διαχείριση πόρων

Σωστές τεχνικές αποθήκευσης αρχείων

annotator.save("annotated.pdf");

Why dispose matters: Το Annotator κρατά το περιεχόμενο του PDF στη μνήμη για γρήγορη πρόσβαση. Η μη κλείσιμο του μπορεί να προκαλέσει διαρροές μνήμης, ειδικά όταν επεξεργάζεστε δεκάδες αρχεία σε batch job.

Καλύτερο πρότυπο διαχείρισης πόρων

try (Annotator annotator = new Annotator("input.pdf")) {
    // add annotations here
    annotator.save("output.pdf");
}

Συνηθισμένα προβλήματα και πώς να τα αποφύγετε

Προβλήματα διαδρομής αρχείου και δικαιωμάτων

  • Problem: “File not found” ή “Access denied”.
  • Solution: Χρησιμοποιήστε απόλυτες διαδρομές κατά την ανάπτυξη, επαληθεύστε τα δικαιώματα ανάγνωσης/εγγραφής και βεβαιωθείτε ότι το αρχείο υπάρχει πριν το ανοίξετε.
File file = new File("C:/docs/input.pdf");
if (!file.exists() || !file.canRead()) {
    throw new IllegalArgumentException("File is missing or unreadable.");
}

Λάθη διαχείρισης μνήμης

  • Problem: Η εφαρμογή επιβραδύνεται μετά την επεξεργασία πολλών PDFs.
  • Solution: Πάντα χρησιμοποιείτε try‑with‑resources ή ρητές κλήσεις close() για απελευθέρωση των native buffers.
try (Annotator annotator = new Annotator("large.pdf")) {
    // process
}

Σύγχυση συστήματος συντεταγμένων

  • Problem: Τα σχόλια εμφανίζονται εκτός οθόνης.
  • Solution: Θυμηθείτε ότι το GroupDocs χρησιμοποιεί προέλευση πάνω‑αριστερά. Δοκιμάστε με γνωστές συντεταγμένες όπως (50, 50, 100, 50) πριν εφαρμόσετε δυναμικές τιμές.
AreaAnnotation test = new AreaAnnotation();
test.setRectangle(new Rectangle(50, 50, 100, 50));
annotator.add(test);

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

Ροές εργασίας ανασκόπησης εγγράφων

Οι νομικές ομάδες συχνά χρειάζονται να παρακολουθούν ποιος σχολίασε ποιο άρθρο. Με το GroupDocs.Annotation μπορείτε:

  • Να αναθέσετε μοναδικό χρώμα ανά αξιολογητή.
  • Να αποθηκεύετε χρονικές σφραγίδες και IDs χρηστών στα μεταδεδομένα του σχολίου.
  • Να εξάγετε το σχολιασμένο PDF για διανομή σε πελάτες διατηρώντας το audit trail.
area.setCreator("lawyer@example.com");
area.setCreatedOn(LocalDateTime.now());

Δημιουργία εκπαιδευτικού περιεχομένου

Οι πλατφόρμες e‑learning χρησιμοποιούν σχόλια για να επισημαίνουν βασικές έννοιες, να ενσωματώνουν κουίζ ή να προσθέτουν επεξηγηματικές σημειώσεις απευθείας σε PDFs μελέτης. Αυτό βελτιώνει τη διατήρηση γνώσεων έως και 35 % σε σύγκριση με απλά PDFs (εσωτερική μελέτη).

Τεκμηρίωση διασφάλισης ποιότητας

Οι κατασκευαστές σχολιάζουν τεχνικά σχέδια για να υποδείξουν ανοχές, αναθεωρήσεις και προειδοποιήσεις ασφαλείας. Η τυποποιημένη σήμανση μειώνει την επανασχεδίαση κατά περίπου 22 % σε γραμμές παραγωγής.

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

Αποτελεσματική διαχείριση μεγάλων εγγράφων

Η επεξεργασία ενός PDF 200 σελίδων μπορεί να γίνει σε κάτω από 2 δευτερόλεπτα σε τυπικό 4‑core server όταν κάνετε streaming σελίδων αντί για φόρτωση ολόκληρου του αρχείου.

Annotator annotator = new Annotator(new FileInputStream("big.pdf"));

Παρακολούθηση χρήσης μνήμης

Ενεργοποιήστε τα ενσωματωμένα εργαλεία παρακολούθησης της Java (JVisualVM, JConsole) για να παρακολουθείτε τη χρήση heap ενώ σχολιάζετε μεγάλα αρχεία. Στοχεύστε να κρατάτε το heap κάτω από 70 % της μέγιστης κατανομής.

Σκέψεις για ταυτόχρονη επεξεργασία

Τα instances του GroupDocs.Annotation δεν είναι thread‑safe. Για παράλληλες εργασίες, δημιουργήστε ξεχωριστό Annotator ανά νήμα ή χρησιμοποιήστε thread‑local pool.

ExecutorService executor = Executors.newFixedThreadPool(4);
for (String path : pdfPaths) {
    executor.submit(() -> {
        try (Annotator a = new Annotator(path)) {
            // annotate
            a.save(path.replace(".pdf", "_annotated.pdf"));
        }
    });
}

Προχωρημένες τεχνικές σχολιασμού

Πολλαπλοί τύποι σχολίων σε ένα έγγραφο

Μπορείτε να συνδυάσετε επισημάνσεις, σημειώσεις κειμένου και υδατογραφήματα σε μία διεργασία:

String INPUT_PDF = "YOUR_DOCUMENT_DIRECTORY/input.pdf";
String outputPath = "YOUR_OUTPUT_DIRECTORY/output_annotated.pdf";

// Initialize Annotator with the path to your document
final Annotator annotator = new Annotator(INPUT_PDF);

Δυναμικός σχολιασμός βάσει περιεχομένου

Συνδυάστε το GroupDocs.Annotation με Apache PDFBox ή Tika για αυτόματη ανίχνευση λέξεων-κλειδιών και προσθήκη σχετικών σημειώσεων.

// pseudo‑code: detect the word "confidential"
if (pageText.contains("confidential")) {
    WatermarkAnnotation wm = new WatermarkAnnotation();
    wm.setText("CONFIDENTIAL");
    annotator.add(wm);
}

Οδηγός αντιμετώπισης προβλημάτων

Συνηθισμένα μηνύματα σφάλματος και λύσεις

  • “Invalid license” – Βεβαιωθείτε ότι το αρχείο άδειας βρίσκεται στο classpath και ταιριάζει με τον τύπο υλοποίησής σας.
  • “Unsupported file format” – Επαληθεύστε ότι το PDF δεν είναι κατεστραμμένο, προστατευμένο με κωδικό ή μηδενικού μεγέθους.
  • Performance slowdown – Χρησιμοποιήστε streaming, κλείστε άμεσα τα αντικείμενα Annotator και εξετάστε batch processing.

Συμβουλές εντοπισμού σφαλμάτων

Ενεργοποίηση καταγραφής

System.setProperty("log4j.configurationFile", "log4j2.xml");

Επαλήθευση εισόδων

Objects.requireNonNull(filePath, "File path cannot be null");

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

Q: Πώς μπορώ να προσθέσω πολλαπλά σχόλια σε ένα PDF αποδοτικά;
A: Καλέστε annotator.add(annotation) για κάθε σχόλιο, μετά εκτελέστε save() μία φορά. Το GroupDocs ομαδοποιεί τις αλλαγές και τις γράφει σε μία διεργασία.

annotator.add(area1);
annotator.add(highlight2);
annotator.save("combined.pdf");

Q: Ποιες μορφές αρχείων υποστηρίζει το GroupDocs.Annotation εκτός από PDF;
A: Υποστηρίζει πάνω από 50 μορφές, συμπεριλαμβανομένων DOC, DOCX, PPT, PPTX, XLS, XLSX, JPEG, PNG, TIFF και πολλές άλλες. Δείτε τη πλήρη λίστα στην Τεκμηρίωση GroupDocs.Annotation.

Q: Πώς διαχειρίζομαι PDFs προστατευμένα με κωδικό;

Annotator annotator = new Annotator("secure.pdf", "password123");

Q: Μπορώ να ανακτήσω και να τροποποιήσω υπάρχοντα σχόλια σε PDF;

List<AnnotationBase> existing = annotator.getAll();
for (AnnotationBase a : existing) {
    if (a instanceof TextAnnotation) {
        ((TextAnnotation) a).setComment("Updated comment");
    }
}
annotator.save("updated.pdf");

Q: Ποιες είναι οι επιπτώσεις στην απόδοση όταν επεξεργάζομαι μεγάλα PDFs;
A: Τα αρχεία μεγαλύτερα από 50 MB θα πρέπει να γίνονται streaming σελίδα‑με‑σελίδα. Η χρήση μνήμης παραμένει κάτω από 150 MB όταν κλείνετε κάθε Annotator μετά την επεξεργασία ενός batch σελίδων.

// each request gets its own Annotator instance
public void processPdf(String path) {
    try (Annotator a = new Annotator(path)) {
        // annotate
        a.save(path);
    }
}

Q: Πώς διαχειρίζομαι ταυτόχρονη επεξεργασία εγγράφων σε web εφαρμογή;

@Service
public class PdfAnnotationService {
    public void addComment(String filePath, String comment) throws IOException {
        try (Annotator annotator = new Annotator(filePath)) {
            AreaAnnotation a = new AreaAnnotation();
            a.setRectangle(new Rectangle(100, 200, 250, 80));
            a.setComment(comment);
            annotator.add(a);
            annotator.save(filePath);
        }
    }
}

Q: Ποιος είναι ο καλύτερος τρόπος για εντοπισμό προβλημάτων τοποθέτησης σχολίων;
A: Ξεκινήστε με ένα γνωστό ορθογώνιο (π.χ., (50, 50, 100, 50)) και ελέγξτε το οπτικό αποτέλεσμα. Προσαρμόστε τις συντεταγμένες σταδιακά και συμβουλευτείτε το μέγεθος σελίδας του PDF (συνήθως 612 × 792 points).

Q: Πώς ενσωματώνω το GroupDocs.Annotation με Spring Boot;

@Service
public class PdfAnnotationService {
    public void addComment(String filePath, String comment) throws IOException {
        try (Annotator annotator = new Annotator(filePath)) {
            AreaAnnotation a = new AreaAnnotation();
            a.setRectangle(new Rectangle(100, 200, 250, 80));
            a.setComment(comment);
            annotator.add(a);
            annotator.save(filePath);
        }
    }
}

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

Q: Μπορώ να εξάγω τα σχολιασμένα PDFs σε άλλες μορφές;
A: Ναι, μπορείτε να μετατρέψετε τα σχολιασμένα PDFs σε DOCX, PPTX ή μορφές εικόνας διατηρώντας όλα τα σημεία σήμανσης.

Q: Υπάρχει τρόπος να ληφθεί η λίστα όλων των τύπων σχολίων που υποστηρίζει η βιβλιοθήκη;
A: Χρησιμοποιήστε AnnotationType.values() για να λάβετε έναν πίνακα με όλα τα υποστηριζόμενα enum.

Q: Πώς μπορώ να προσαρμόσω την εμφάνιση ενός υδατογραφήματος;
A: Ορίστε ιδιότητες όπως setOpacity, setRotation και setBackgroundColor σε ένα WatermarkAnnotation πριν το προσθέσετε.

Q: Η βιβλιοθήκη υποστηρίζει την προσθήκη σχολίων προγραμματιστικά από βάση δεδομένων;
A: Απόλυτα. Διαβάστε τα δεδομένα σχολίων από οποιαδήποτε πηγή, γεμίστε ένα AreaAnnotation (ή TextAnnotation) με το κείμενο και προσθέστε το στο έγγραφο.

Q: Τι πρέπει να κάνω αν αντιμετωπίσω διαρροή μνήμης κατά την επεξεργασία batch;
A: Βεβαιωθείτε ότι κάθε Annotator κλείνει (try‑with‑resources), παρακολουθήστε το heap της JVM και χωρίστε τα μεγάλα batch σε μικρότερες ομάδες.

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

Τελευταία ενημέρωση: 2026-10-16
Δοκιμή με: GroupDocs.Annotation 25.2 for Java
Συγγραφέας: GroupDocs

// From file path (most common)
Annotator annotatorFromPath = new Annotator("path/to/document.pdf");

// From InputStream (useful for uploaded files)
FileInputStream inputStream = new FileInputStream("document.pdf");
Annotator annotatorFromStream = new Annotator(inputStream);

// Don't forget to close streams when done!
inputStream.close();
import com.groupdocs.annotation.models.Rectangle;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;

// Create the annotation
AreaAnnotation area = new AreaAnnotation();

// Position and size: x, y, width, height
area.setBox(new Rectangle(100, 100, 100, 100));

// Background color in ARGB format (65535 = yellow with transparency)
area.setBackgroundColor(65535);

// Add the annotation to your document
annotator.add(area);
// Create a semi‑transparent highlight
AreaAnnotation highlight = new AreaAnnotation();
highlight.setBox(new Rectangle(50, 200, 200, 25));
highlight.setBackgroundColor(0x80FFFF00); // Semi‑transparent yellow
highlight.setMessage("Important clause - review carefully");
// Add a comment annotation with custom styling
AreaAnnotation comment = new AreaAnnotation();
comment.setBox(new Rectangle(300, 150, 150, 75));
comment.setBackgroundColor(0x80FF0000); // Semi‑transparent red
comment.setMessage("Needs revision - see discussion in email");
comment.setCreatedOn(new Date());
comment.setUser("John Reviewer");
// Save the annotated document
annotator.save(outputPath);

// Always dispose of resources (critical for memory management)
annotator.dispose();
public void annotateDocument(String inputPath, String outputPath) {
    try (Annotator annotator = new Annotator(inputPath)) {
        // Your annotation code here
        AreaAnnotation area = new AreaAnnotation();
        area.setBox(new Rectangle(100, 100, 100, 100));
        area.setBackgroundColor(65535);
        
        annotator.add(area);
        annotator.save(outputPath);
        
        System.out.println("Document successfully annotated and saved to: " + outputPath);
    } catch (Exception e) {
        System.err.println("Annotation failed: " + e.getMessage());
        throw new RuntimeException("Failed to annotate document", e);
    }
}
public boolean validateInputFile(String filePath) {
    File file = new File(filePath);
    if (!file.exists()) {
        System.err.println("File does not exist: " + filePath);
        return false;
    }
    if (!file.canRead()) {
        System.err.println("Cannot read file: " + filePath);
        return false;
    }
    return true;
}
// Good practice - automatic resource management
try (Annotator annotator = new Annotator(inputPath)) {
    // Annotation code here
} // Automatically disposed

// If manual disposal is needed
Annotator annotator = null;
try {
    annotator = new Annotator(inputPath);
    // Annotation code here
} finally {
    if (annotator != null) {
        annotator.dispose();
    }
}
// Start with simple, visible coordinates for testing
Rectangle testPosition = new Rectangle(50, 50, 100, 50);

// Gradually adjust based on your PDF dimensions
// Most PDFs are 612x792 points (8.5"x11" at 72 DPI)
public void addReviewAnnotation(Annotator annotator, String reviewerName, 
                              String comment, Rectangle position, Color highlightColor) {
    AreaAnnotation review = new AreaAnnotation();
    review.setBox(position);
    review.setBackgroundColor(highlightColor.getRGB());
    review.setMessage(comment);
    review.setUser(reviewerName);
    review.setCreatedOn(new Date());
    
    annotator.add(review);
}
public void processDocumentBatch(List<String> documentPaths) {
    for (String path : documentPaths) {
        try (Annotator annotator = new Annotator(path)) {
            // Process each document independently
            // This prevents memory accumulation
            processAnnotations(annotator);
        }
        
        // Optional: Add small delay for very large batches
        // Thread.sleep(100);
    }
}
Runtime runtime = Runtime.getRuntime();
long memoryBefore = runtime.totalMemory() - runtime.freeMemory();

// Process documents...

long memoryAfter = runtime.totalMemory() - runtime.freeMemory();
System.out.println("Memory used: " + (memoryAfter - memoryBefore) + " bytes");
public class ConcurrentAnnotationProcessor {
    public void processDocumentsConcurrently(List<String> documents) {
        documents.parallelStream().forEach(docPath -> {
            try (Annotator annotator = new Annotator(docPath)) {
                // Each thread gets its own Annotator instance
                processAnnotations(annotator);
            }
        });
    }
}
public void createComprehensiveAnnotation(Annotator annotator) {
    // Highlight important text
    AreaAnnotation highlight = new AreaAnnotation();
    highlight.setBox(new Rectangle(100, 100, 200, 30));
    highlight.setBackgroundColor(0x80FFFF00);
    
    // Add explanatory note
    AreaAnnotation note = new AreaAnnotation();
    note.setBox(new Rectangle(320, 95, 150, 40));
    note.setBackgroundColor(0x80ADD8E6);
    note.setMessage("See reference document #123");
    
    annotator.add(highlight);
    annotator.add(note);
}
// Add to your application properties or logging configuration
java.util.logging.Logger.getLogger("com.groupdocs").setLevel(Level.FINE);
public boolean validateAnnotationParameters(Rectangle box, int color) {
    if (box.getWidth() <= 0 || box.getHeight() <= 0) {
        System.err.println("Invalid annotation dimensions");
        return false;
    }
    
    if (box.getX() < 0 || box.getY() < 0) {
        System.err.println("Annotation position cannot be negative");
        return false;
    }
    
    return true;
}
try (Annotator annotator = new Annotator("document.pdf")) {
    annotator.add(annotation1);
    annotator.add(annotation2);
    annotator.add(annotation3);
    annotator.save("output.pdf"); // All annotations applied at once
}
LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("your-password");
Annotator annotator = new Annotator("protected.pdf", loadOptions);
try (Annotator annotator = new Annotator("annotated.pdf")) {
    List<AnnotationInfo> annotations = annotator.get(AnnotationType.Area);
    for (AnnotationInfo annotation : annotations) {
        // Modify properties as needed
        annotation.setMessage("Updated comment");
    }
    annotator.update(annotations);
    annotator.save("updated.pdf");
}
@Service
public class AnnotationService {
    public CompletableFuture<String> annotateAsync(String inputPath) {
        return CompletableFuture.supplyAsync(() -> {
            try (Annotator annotator = new Annotator(inputPath)) {
                // Process annotations
                return processDocument(annotator);
            }
        });
    }
}
@Service
public class DocumentAnnotationService {
    
    public void annotateDocument(MultipartFile file, List<AnnotationRequest> requests) {
        try (InputStream inputStream = file.getInputStream();
             Annotator annotator = new Annotator(inputStream)) {
            
            // Process annotation requests
            requests.forEach(request -> addAnnotation(annotator, request));
            annotator.save("output.pdf");
        }
    }
}

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