Προσθήκη υδατογραφήματος σε PDF με το GroupDocs.Watermark για Java

Εισαγωγή

Στο σημερινό ψηφιακό τοπίο, η προστασία της πνευματικής ιδιοκτησίας είναι κρίσιμη, και add watermark to PDF είναι ένας από τους πιο αποτελεσματικούς τρόπους για να το κάνετε. Αυτό το σεμινάριο σας καθοδηγεί στη χρήση του GroupDocs.Watermark για Java για την ενσωμάτωση υδατογραφημάτων κειμένου και εικόνας σε αρχεία PDF. Στο τέλος, θα μπορείτε να:

  • Αρχικοποίηση υδατογραφημάτων κειμένου και εικόνας
  • Εφαρμογή υδατογραφημάτων υπό όρους βάσει διαστάσεων εικόνας
  • save PDF with watermark ενώ διατηρείται η αρχική ποιότητα

Έτοιμοι να ασφαλίσετε τα έγγραφά σας; Ας ξεκινήσουμε!

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

  • Which library adds watermarks to PDFs in Java? GroupDocs.Watermark for Java.
  • Can I add both text and image watermarks? Yes, the API supports both types in a single run.
  • Do I need a license for development? A free trial works for testing; a permanent license is required for production.
  • What file formats are supported? Over 30 formats, including PDF, DOCX, PPTX, and images.
  • How large a PDF can be processed? Up to 2,000 pages without loading the whole file into memory.

Τι είναι η προσθήκη υδατογραφήματος σε PDF;

Add watermark to PDF σημαίνει την ενσωμάτωση ορατών ή αόρατων σημείων—όπως αλφαριθμητικά κειμένου ή λογότυπα—απευθείας σε ένα αρχείο PDF για να υποδείξει ιδιοκτησία, εμπιστευτικότητα ή branding. Αυτή η διαδικασία τροποποιεί τα οπτικά στρώματα του εγγράφου ενώ διατηρεί το αρχικό περιεχόμενο ανέπαφο.

Γιατί να χρησιμοποιήσετε το GroupDocs.Watermark για Java;

Το GroupDocs.Watermark υποστηρίζει 30+ μορφές εγγράφων, μπορεί να επεξεργαστεί PDF έως 2.000 σελίδες σε μία μόνο διέλευση, και προσθέτει έως 500 υδατογραφήματα ανά έγγραφο χωρίς αισθητή επίπτωση στην απόδοση. Το API του είναι πλήρως thread‑safe, καθιστώντας το ιδανικό για περιβάλλοντα διακομιστών υψηλής απόδοσης.

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

Πριν προχωρήσετε, επιβεβαιώστε ότι έχετε:

  1. Java Development Kit (JDK): Έκδοση 8 ή νεότερη εγκατεστημένη.
  2. GroupDocs.Watermark for Java: Έκδοση 24.11 (ή νεότερη) προστέθηκε στο έργο σας.
  3. Build tool: Προτιμάται Maven, αλλά η άμεση λήψη JAR λειτουργεί επίσης.

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

Διαμόρφωση Maven

Προσθέστε το αποθετήριο GroupDocs και την εξάρτηση στο αρχείο pom.xml σας:

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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Άμεση λήψη

Εναλλακτικά, κατεβάστε το πιο πρόσφατο JAR από την επίσημη σελίδα εκδόσεων: GroupDocs.Watermark for Java releases.

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

Για δωρεάν δοκιμή ή προσωρινή άδεια, επισκεφθείτε το portal αδειοδότησης: GroupDocs Licensing. Οι παραγωγικές εγκαταστάσεις θα πρέπει να χρησιμοποιούν αγορασμένη άδεια για την αφαίρεση όλων των περιορισμών δοκιμής.

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

Αφού προσθέσετε τη βιβλιοθήκη, εισάγετε τις απαιτούμενες κλάσεις στο αρχείο πηγαίου κώδικα Java σας:

import com.groupdocs.watermark.Watermarker;

Οδηγός υλοποίησης

Θα χωρίσουμε την υλοποίηση σε λογικές ενότητες, η κάθε μία απαντώντας σε συγκεκριμένη ερώτηση.

Πώς προσθέτετε υδατογράφημα σε PDF σε Java;

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

Αρχικοποίηση κειμενικού υδατογραφήματος

Definition anchor: TextWatermark είναι η κλάση που αντιπροσωπεύει μια κειμενική επικάλυψη που μπορεί να τοποθετηθεί σε σελίδες, εικόνες ή διανυσματικά γραφικά μέσα σε ένα έγγραφο.

Βήμα 1: δημιουργία στιγμιοτύπου TextWatermark

Δημιουργήστε ένα TextWatermark χρησιμοποιώντας το επιθυμητό κείμενο και τις ρυθμίσεις γραμματοσειράς:

// Create a text watermark with custom settings
TextWatermark textWatermark = new TextWatermark("Protected image", new Font("Arial", 8));

Βήμα 2: ορισμός στοίχισης

Κεντράρετε το υδατογράφημα οριζόντια και κάθετα για ομοιόμορφη τοποθέτηση:

// Align watermark to the center of images
textWatermark.setHorizontalAlignment(HorizontalAlignment.Center);
textWatermark.setVerticalAlignment(VerticalAlignment.Center);

Βήμα 3: περιστροφή υδατογραφήματος

Εφαρμόστε περιστροφή 45 μοιρών ώστε το υδατογράφημα να είναι πιο δύσκολο να αφαιρεθεί:

// Rotate the watermark by 45 degrees
textWatermark.setRotateAngle(45);

Βήμα 4: διαμόρφωση μεγέθους

Κλιμακώστε το υδατογράφημα σε σχέση με τις διαστάσεις της εικόνας-στόχου:

// Scale watermark based on parent image size
textWatermark.setSizingType(SizingType.ScaleToParentDimensions);
textWatermark.setScaleFactor(1);

Αρχικοποίηση εικόνας υδατογραφήματος

Definition anchor: ImageWatermark περιλαμβάνει μια εικόνα (PNG, JPEG, BMP, κ.λπ.) που θα τοποθετηθεί πάνω στο περιεχόμενο του εγγράφου ως υδατογράφημα.

Βήμα 1: φόρτωση αρχείου εικόνας

Φορτώστε την εικόνα υδατογραφήματος από το δίσκο:

// Load an image file as a watermark
ImageWatermark imageWatermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY\ProtectJpg");

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

Βήμα 2: ορισμός στοίχισης

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

// Align image watermark to the center
imageWatermark.setHorizontalAlignment(HorizontalAlignment.Center);
imageWatermark.setVerticalAlignment(VerticalAlignment.Center);

Βήμα 3: περιστροφή υδατογραφήματος εικόνας

Εφαρμόστε περιστροφή –30 μοιρών για να εισαγάγετε οπτική ποικιλία:

// Rotate the image watermark by -45 degrees
textWatermark.setRotateAngle(-45);

Βήμα 4: διαμόρφωση μεγέθους

Ορίστε το μέγεθος της εικόνας ως ποσοστό του πλάτους της υποκείμενης εικόνας:

// Scale the image watermark relative to its parent dimensions
imageWatermark.setSizingType(SizingType.ScaleToParentDimensions);
imageWatermark.setScaleFactor(1);

Προσθήκη υδατογραφημάτων σε εικόνες σε ένα έγγραφο

Definition anchor: Watermarker είναι η κεντρική κλάση που φορτώνει ένα έγγραφο, παρέχει πρόσβαση στα στοιχεία του και γράφει τα υδατογραφήματα πίσω στο αρχείο.

Βήμα 1: άνοιγμα του εγγράφου

Δημιουργήστε ένα Watermarker με τη διαδρομή προς το πηγαίο PDF σας:

// Open the PDF containing images for watermarking
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY\document.pdf");

Βήμα 2: ανάκτηση εικόνων

Συλλέξτε όλες τις εικόνες από το PDF που μπορούν να λάβουν υδατογράφημα:

// Get a collection of all images within the PDF
WatermarkableImageCollection images = watermarker.getImages();

Βήμα 3: προσθήκη υδατογραφημάτων υπό όρους

Για κάθε εικόνα, ελέγξτε τις διαστάσεις της· εάν το πλάτος υπερβαίνει τα 300 px, εφαρμόστε το κειμενικό υδατογράφημα, διαφορετικά χρησιμοποιήστε το υδατογράφημα εικόνας:

for (int i = 0; i < images.getCount(); i++) {
    // Check if the image exceeds specific size criteria
    if (images.get_Item(i).getWidth() > 100 && images.get_Item(i).getHeight() > 100) {
        // Alternate between text and image watermarks
        if (i % 2 == 0) {
            images.get_Item(i).add(textWatermark);
        } else {
            images.get_Item(i).add(imageWatermark);
        }
    }
}

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

Βήμα 4: απελευθέρωση πόρων εικόνας

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

// Close the image watermark instance after use
imageWatermark.close();

Βήμα 5: αποθήκευση αλλαγών

Διατηρήστε τις τροποποιήσεις αποθηκεύοντας το έγγραφο σε νέο αρχείο:

// Save the PDF with added watermarks in a new file
watermarker.save("YOUR_OUTPUT_DIRECTORY\document.pdf");

Το προκύπτον αρχείο είναι μια έκδοση save PDF with watermark έτοιμη για διανομή.

Βήμα 6: καθαρισμός

Καταστρέψτε την παρουσία Watermarker για να αποτρέψετε διαρροές μνήμης:

// Close the main watermarker to release document resources
watermarker.close();

Συχνά προβλήματα και αντιμετώπιση

  • License errors: Βεβαιωθείτε ότι η διαδρομή του αρχείου άδειας έχει οριστεί σωστά μέσω License.setLicense("license_file_path"). Μια ελλιπής ή ληγμένη άδεια προκαλεί LicenseException.
  • Large PDFs: Για έγγραφα μεγαλύτερα από 1.000 σελίδες, ενεργοποιήστε τη λειτουργία streaming καλώντας watermarker.setStreamMode(true) ώστε να μειώσετε την κατανάλωση μνήμης.
  • Unsupported image formats: Το GroupDocs.Watermark υποστηρίζει PNG, JPEG, BMP και GIF. Η μετατροπή άλλων μορφών σε PNG πριν τη φόρτωση αποτρέπει το UnsupportedFormatException.

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

Q: Μπορώ να προσθέσω υδατογράφημα σε PDF προστατευμένο με κωδικό;
A: Ναι. Ανοίξτε το έγγραφο με new Watermarker("file.pdf", "password") και στη συνέχεια εφαρμόστε το υδατογράφημα όπως συνήθως.

Q: Υποστηρίζει το API την επεξεργασία παρτίδας πολλαπλών PDF;
A: Απολύτως. Διασχίστε έναν φάκελο με PDF, δημιουργήστε ένα Watermarker για κάθε αρχείο, εφαρμόστε τα ίδια αντικείμενα υδατογραφήματος και αποθηκεύστε τα αποτελέσματα.

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

Q: Μπορεί να γίνει το υδατογράφημα αόρατο (μόνο μεταδεδομένα);
A: Ναι. Χρησιμοποιήστε τη μέθοδο setOpacity(0) στο αντικείμενο υδατογραφήματος για να το ενσωματώσετε αόρατα για διωκτική παρακολούθηση.

Q: Ποιες εκδόσεις Java υποστηρίζονται επίσημα;
A: Το GroupDocs.Watermark for Java υποστηρίζει JDK 8, 11 και 17, εξασφαλίζοντας συμβατότητα τόσο με παλαιές όσο και με σύγχρονες εφαρμογές.

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

Η προσθήκη υδατογραφημάτων μπορεί να εξυπηρετήσει διάφορα πραγματικά σενάρια:

  1. Document security: Σημειώστε εμπιστευτικά αρχεία για να αποτρέψετε την μη εξουσιοδοτημένη κοινοποίηση.
  2. Brand protection: Επικάλυψη λογότυπων εταιρείας σε PDF μάρκετινγκ.
  3. Copyright assertion: Ενσωματώστε ονόματα συγγραφέων ή σύμβολα πνευματικών δικαιωμάτων σε δημοσιευμένα έργα.
  4. Version control: Σφραγίδα αριθμών έκδοσης ή ημερομηνιών σε έγγραφα προσχεδίου.

Συμπέρασμα

Ακολουθώντας αυτό το java pdf watermark example, έχετε τώρα μια πλήρη, έτοιμη για παραγωγή λύση για add watermark to PDF χρησιμοποιώντας το GroupDocs.Watermark για Java. Μπορείτε να προσαρμόσετε κείμενο, εικόνες, περιστροφή και μέγεθος, καθώς και να εφαρμόζετε υδατογραφήματα υπό όρους βάσει διαστάσεων εικόνας—όλα ενώ διατηρείτε τη διαδικασία γρήγορη και αποδοτική σε μνήμη.

Τελευταία ενημέρωση: 2026-08-09
Δοκιμή με: GroupDocs.Watermark 24.11 for Java
Συγγραφέας: GroupDocs

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