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

Σε αυτόν τον οδηγό θα μάθετε πώς να προσθέσετε υδατογράφημα σε pdf αρχεία χρησιμοποιώντας το GroupDocs.Watermark Java SDK. Θα περάσουμε από τη φόρτωση εγγράφων από δίσκο, ροές ή πηγές με κωδικό πρόσβασης, την εφαρμογή κειμενικών ή εικόνων υδατογραφήματος, και τέλος την αποθήκευση του ενημερωμένου PDF. Είτε δημιουργείτε έναν επεξεργαστή δέσμης είτε μια υπηρεσία μονής αρχείου, αυτά τα βήματα σας παρέχουν μια αξιόπιστη, έτοιμη για παραγωγή λύση.

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

  • Μπορώ να προσθέσω υδατογράφημα σε PDF με κωδικό πρόσβασης; Ναι – περάστε τον κωδικό πρόσβασης κατά τη φόρτωση του εγγράφου, στη συνέχεια εφαρμόστε το υδατογράφημα κανονικά.
  • Ποιες μορφές μπορούν να υδατογραφηθούν; Πάνω από 30 μορφές, συμπεριλαμβανομένων PDF, DOCX, PPTX και εικόνων.
  • Χρειάζομαι άδεια για ανάπτυξη; Μια προσωρινή άδεια λειτουργεί για δοκιμές· απαιτείται πλήρης άδεια για παραγωγή.
  • Ποια έκδοση Java απαιτείται; Υποστηρίζεται Java 8 ή νεότερη.
  • Υποστηρίζεται η ροή; Απόλυτα – μπορείτε να φορτώσετε από InputStream και να αποθηκεύσετε σε OutputStream χωρίς να αγγίξετε το σύστημα αρχείων.

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

Add watermark to pdf αναφέρεται στη διαδικασία επικάλυψης ημιδιαφανών κειμένων ή εικόνων σε κάθε σελίδα ενός εγγράφου PDF για να μεταφέρει ιδιοκτησία, εμπιστευτικότητα ή εμπορική σήμανση. Το GroupDocs.Watermark for Java παρέχει ένα API μονής κλήσης που διαχειρίζεται αυτόματα τη θέση, τη διαφάνεια και την επιλογή εύρους σελίδων.

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

Το GroupDocs.Watermark υποστηρίζει πάνω από 35 μορφές αρχείων και μπορεί να επεξεργαστεί PDF με 500 σελίδες σε λιγότερο από 2 δευτερόλεπτα σε τυπική CPU server‑class. Η βιβλιοθήκη λειτουργεί εξ ολοκλήρου στη μνήμη, οπότε δεν χρειάζεται ποτέ να έχετε εγκατεστημένο το Microsoft Office ή το Adobe Acrobat. Το API της είναι thread‑safe, καθιστώντας το ιδανικό για υπηρεσίες web υψηλής απόδοσης.

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

  • Εγκατεστημένο Java 8 ή νεότερο.
  • Έργο Maven ή Gradle διαμορφωμένο με την εξάρτηση groupdocs-watermark.
  • Έγκυρη άδεια GroupDocs.Watermark (προσωρινή άδεια για αξιολόγηση).
  • Αρχεία PDF που θέλετε να προστατεύσετε, προαιρετικά με κωδικούς πρόσβασης.

Πώς να προσθέσετε υδατογράφημα σε pdf – βήμα προς βήμα

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

Πώς να φορτώσετε ένα έγγραφο από δίσκο;

Watermarker είναι η κύρια κλάση που χρησιμοποιείται για τη φόρτωση και τη διαχείριση εγγράφων για υδατογράφημα. Παρέχετε το πλήρες μονοπάτι αρχείου στον κατασκευαστή Watermarker; το SDK ανιχνεύει αυτόματα τη μορφή αρχείου, επικυρώνει το περιεχόμενο και φορτώνει το έγγραφο στη μνήμη έτοιμο για οποιαδήποτε λειτουργία υδατογραφήματος. Αυτή η προσέγγιση λειτουργεί για PDFs, αρχεία Word, εικόνες και πολλές άλλες υποστηριζόμενες τύπους.

Watermarker watermarker = new Watermarker("C:/files/input.pdf");

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

Πώς να φορτώσετε ένα έγγραφο από ροή;

Watermarker μπορεί επίσης να δεχτεί ένα InputStream για να φορτώσει έγγραφα απευθείας από τη μνήμη. Όταν λαμβάνετε ένα αρχείο μέσω HTTP ή ουράς μηνυμάτων, τυλίξτε τον πίνακα byte σε ένα ByteArrayInputStream και περάστε το στον κατασκευαστή Watermarker που δέχεται InputStream. Το SDK διαβάζει τη ροή χωρίς να γράφει στο δίσκο, διατηρώντας την απόδοση και την ασφάλεια, και υποστηρίζει μεγάλα αρχεία επεξεργαζόμενα σε τμήματα. Αυτή η μέθοδος είναι ιδανική για υπηρεσίες web και αρχιτεκτονικές μικρο‑υπηρεσιών.

InputStream pdfStream = new ByteArrayInputStream(pdfBytes);
Watermarker watermarker = new Watermarker(pdfStream);

Το SDK διαβάζει τη ροή χωρίς να γράφει στο δίσκο, διατηρώντας την απόδοση και την ασφάλεια.

Πώς να φορτώσετε ένα έγγραφο με κωδικό πρόσβασης;

Watermarker υποστηρίζει τη φόρτωση PDF με κωδικό πρόσβασης παρέχοντας τον κωδικό ως δεύτερο όρισμα. Δώστε τον κωδικό ως δεύτερο όρισμα στον κατασκευαστή. Το SDK αποκρυπτογραφεί το PDF εν κινήσει, μετά από το οποίο μπορείτε να το χειριστείτε όπως οποιοδήποτε άλλο έγγραφο. Εάν ο κωδικός είναι σωστός, όλες οι σελίδες γίνονται προσβάσιμες για υδατογράφημα· διαφορετικά η βιβλιοθήκη ρίχνει μια σαφή εξαίρεση που μπορείτε να πιάσετε και να καταγράψετε για εντοπισμό σφαλμάτων.

Watermarker watermarker = new Watermarker("C:/files/secure.pdf", "mySecretPwd");

Εάν ο κωδικός είναι λανθασμένος, το SDK ρίχνει μια ενημερωτική εξαίρεση που μπορείτε να πιάσετε και να καταγράψετε.

Πώς να εφαρμόσετε κειμενικό υδατογράφημα;

TextWatermark αντιπροσωπεύει ένα κειμενικό υδατογράφημα που μπορεί να εφαρμοστεί σε σελίδες με προσαρμόσιμο στυλ. Δημιουργήστε ένα αντικείμενο TextWatermark με το επιθυμητό κείμενο, γραμματοσειρά, μέγεθος και χρώμα. Στη συνέχεια καλέστε add στο αντικείμενο Watermarker, προαιρετικά καθορίζοντας εύρη σελίδων. Το υδατογράφημα αποδίδεται με την καθορισμένη διαφάνεια και περιστροφή, και μπορεί να τοποθετηθεί χρησιμοποιώντας προεπιλεγμένες θέσεις ή προσαρμοσμένες συντεταγμένες, εξασφαλίζοντας συνεπή εμφάνιση σε όλες τις σελίδες.

TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 36));
watermark.setColor(Color.RED);
watermark.setTransparency(0.5);
watermarker.add(watermark);

Αυτή η κλήση τοποθετεί το υδατογράφημα σε κάθε σελίδα εξ ορισμού· μπορείτε να το περιορίσετε με new PageRange(1, 5) αν χρειάζεται.

Πώς να εφαρμόσετε εικόνα υδατογραφήματος;

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

ImageWatermark imgWatermark = new ImageWatermark("C:/images/logo.png");
imgWatermark.setTransparency(0.3);
watermarker.add(imgWatermark);

Το SDK κλιμακώνει την εικόνα ώστε να ταιριάζει στη σελίδα διατηρώντας την αναλογία διαστάσεων.

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

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

watermarker.save("C:/files/output.pdf");

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

Διαθέσιμα μαθήματα

Πώς να φορτώσετε έγγραφα με κωδικό πρόσβασης σε Java χρησιμοποιώντας το GroupDocs.Watermark

Μάθετε πώς να φορτώνετε και να διαχειρίζεστε υδατογραφήματα σε έγγραφα με κωδικό πρόσβασης χρησιμοποιώντας το GroupDocs.Watermark για Java. Αυτός ο οδηγός παρέχει βήμα‑βήμα οδηγίες, πρακτικά παραδείγματα και συμβουλές αντιμετώπισης προβλημάτων.

Πώς να φορτώσετε και να υδατογραφήσετε έγγραφα Word με κωδικό πρόσβασης χρησιμοποιώντας το GroupDocs.Watermark σε Java

Μάθετε πώς να χρησιμοποιήσετε το GroupDocs.Watermark με Java για να φορτώσετε, διαχειριστείτε και υδατογραφήσετε έγγραφα Word με κωδικό πρόσβασης αποδοτικά.

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

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

  • Σφάλμα μη έγκυρου κωδικού – ελέγξτε ξανά τη συμβολοσειρά κωδικού· πρέπει να είναι κωδικοποιημένη σε UTF‑8.
  • Έλλειψη μνήμης σε μεγάλα PDFs – ενεργοποιήστε τη λειτουργία ροής χρησιμοποιώντας κατασκευαστές Watermarker που δέχονται InputStream και OutputStream.
  • Το υδατογράφημα δεν είναι ορατό – βεβαιωθείτε ότι η διαφάνεια του υδατογραφήματος είναι πάνω από 0.1 και ότι το χρώμα αντιτίθεται στο φόντο της σελίδας.

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

Q: Μπορώ να προσθέσω πολλαπλά υδατογραφήματα στο ίδιο PDF;
A: Ναι. Καλέστε watermarker.add() επανειλημμένα με διαφορετικά αντικείμενα TextWatermark ή ImageWatermark; το καθένα θα τοποθετηθεί σε στρώση με τη σειρά που προστέθηκε.

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

Q: Είναι δυνατόν να υδατογραφήσετε μόνο επιλεγμένες σελίδες;
A: Ναι. Περνάτε ένα PageRange (π.χ., new PageRange(2, 4)) στη μέθοδο add για να περιορίσετε το υδατογράφημα σε συγκεκριμένες σελίδες.

Q: Ποιο είναι το μέγιστο μέγεθος αρχείου που υποστηρίζεται;
A: Το SDK μπορεί να διαχειριστεί αρχεία έως 2 GB χωρίς να φορτώνει ολόκληρο το έγγραφο στη μνήμη, χάρη στην αρχιτεκτονική ροής.

Q: Πώς να αφαιρέσω ένα υδατογράφημα μετά την προσθήκη του;
A: Χρησιμοποιήστε watermarker.remove(watermarkId) όπου watermarkId είναι το αναγνωριστικό που επιστράφηκε όταν προσθέσατε αρχικά το υδατογράφημα.

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

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