Tambahkan watermark ke PDF dengan GroupDocs.Watermark untuk Java

Dalam panduan ini Anda akan belajar cara menambahkan watermark ke PDF menggunakan GroupDocs.Watermark Java SDK. Kami akan membahas cara memuat dokumen dari disk, aliran, atau sumber yang dilindungi password, menerapkan watermark teks atau gambar, dan akhirnya menyimpan PDF yang telah diperbarui. Baik Anda membangun pemroses batch maupun layanan satu‑file, langkah‑langkah ini memberikan solusi yang andal dan siap produksi.

Jawaban Cepat

  • Apakah saya dapat menambahkan watermark ke PDF yang dilindungi password? Ya – berikan password saat memuat dokumen, lalu terapkan watermark seperti biasa.
  • Format apa saja yang dapat di‑watermark? Lebih dari 30 format, termasuk PDF, DOCX, PPTX, dan gambar.
  • Apakah saya memerlukan lisensi untuk pengembangan? Lisensi sementara dapat digunakan untuk pengujian; lisensi penuh diperlukan untuk produksi.
  • Versi Java apa yang diperlukan? Java 8 atau lebih tinggi didukung.
  • Apakah streaming didukung? Tentu – Anda dapat memuat dari InputStream dan menyimpan ke OutputStream tanpa menyentuh sistem file.

Apa itu menambahkan watermark ke PDF?

Add watermark to pdf mengacu pada proses menempatkan teks atau gambar semi‑transparan di atas setiap halaman dokumen PDF untuk menyampaikan kepemilikan, kerahasiaan, atau branding. GroupDocs.Watermark untuk Java menyediakan API satu‑panggilan yang menangani penempatan, opacity, dan pemilihan rentang halaman secara otomatis.

Mengapa menggunakan GroupDocs.Watermark untuk Java?

GroupDocs.Watermark mendukung lebih dari 35 format file dan dapat memproses PDF hingga 500 halaman dalam kurang dari 2 detik pada CPU kelas server tipikal. Perpustakaan ini bekerja sepenuhnya di memori, sehingga Anda tidak pernah memerlukan Microsoft Office atau Adobe Acrobat terpasang. API‑nya thread‑safe, menjadikannya ideal untuk layanan web dengan throughput tinggi.

Prasyarat

  • Java 8 atau lebih baru terpasang.
  • Proyek Maven atau Gradle dikonfigurasi dengan dependensi groupdocs-watermark.
  • Lisensi GroupDocs.Watermark yang valid (lisensi sementara untuk evaluasi).
  • File PDF yang ingin Anda lindungi, opsional dengan password.

Cara menambahkan watermark ke PDF – langkah demi langkah

Muat dokumen sumber, terapkan watermark, lalu simpan hasilnya. Bagian‑bagian berikut menjawab setiap sub‑tugas secara langsung.

Cara memuat dokumen dari disk?

Watermarker adalah kelas utama yang digunakan untuk memuat dan memanipulasi dokumen untuk watermarking. Berikan jalur file lengkap ke konstruktor Watermarker; SDK secara otomatis mendeteksi format file, memvalidasi konten, dan memuat dokumen ke memori siap untuk operasi watermark apa pun. Pendekatan ini bekerja untuk PDF, file Word, gambar, dan banyak tipe lain yang didukung.

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

Setelah baris ini PDF sepenuhnya dimuat di memori, siap untuk operasi watermark apa pun.

Cara memuat dokumen dari aliran (stream)?

Watermarker juga dapat menerima InputStream untuk memuat dokumen langsung dari memori. Ketika Anda menerima file melalui HTTP atau antrian pesan, bungkus byte array dalam ByteArrayInputStream dan berikan ke konstruktor Watermarker yang menerima InputStream. SDK membaca aliran tanpa menulis ke disk, menjaga kinerja dan keamanan, serta mendukung file besar dengan memproses data dalam potongan. Metode ini ideal untuk layanan web dan arsitektur mikro‑service.

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

SDK membaca aliran tanpa menulis ke disk, menjaga kinerja dan keamanan.

Cara memuat dokumen yang dilindungi password?

Watermarker mendukung pemuatan PDF yang dilindungi password dengan memberikan password sebagai argumen kedua. Berikan password sebagai argumen kedua ke konstruktor. SDK mendekripsi PDF secara langsung, setelah itu Anda dapat memperlakukannya seperti dokumen lain. Jika password benar, semua halaman menjadi dapat diakses untuk watermarking; jika tidak, perpustakaan akan melemparkan pengecualian jelas yang dapat Anda tangkap dan log untuk pemecahan masalah.

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

Jika password tidak benar, SDK melemparkan pengecualian informatif yang dapat Anda tangkap dan log.

Cara menerapkan watermark teks?

TextWatermark mewakili watermark tekstual yang dapat diterapkan ke halaman dengan gaya yang dapat disesuaikan. Buat objek TextWatermark dengan teks, font, ukuran, dan warna yang diinginkan. Kemudian panggil add pada instance Watermarker, opsional menyebutkan rentang halaman. Watermark dirender dengan opacity dan rotasi yang ditentukan, dan dapat diposisikan menggunakan lokasi pra‑definisi atau koordinat kustom, memastikan tampilan konsisten di semua halaman.

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

Pemanggilan ini menempatkan watermark pada setiap halaman secara default; Anda dapat membatasinya dengan new PageRange(1, 5) bila diperlukan.

Cara menerapkan watermark gambar?

ImageWatermark mewakili watermark berbasis gambar seperti logo atau segel. Instansiasi ImageWatermark dengan jalur atau aliran logo Anda, lalu tambahkan serupa dengan watermark teks. SDK secara otomatis menskalakan gambar agar sesuai dengan halaman sambil mempertahankan rasio aspek, dan Anda dapat menyesuaikan opacity, rotasi, serta penempatan untuk mencapai efek visual yang diinginkan tanpa merusak konten asli.

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

SDK menskalakan gambar agar sesuai dengan halaman sambil mempertahankan rasio aspek.

Cara menyimpan dokumen yang telah di‑watermark?

save menulis dokumen yang telah dimodifikasi ke lokasi yang ditentukan dalam format yang dipilih. Panggil save dengan jalur output dan format yang diinginkan. Format yang sama dengan sumber digunakan ketika Anda menghilangkan parameter format. Metode ini menulis PDF yang telah dimodifikasi ke disk, mempertahankan semua konten asli kecuali lapisan watermark baru, dan mendukung penyimpanan ke aliran untuk pemrosesan lebih lanjut.

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

Metode ini menulis PDF yang telah dimodifikasi ke disk, mempertahankan semua konten asli kecuali lapisan watermark baru.

Tutorial yang Tersedia

Cara Memuat Dokumen yang Dilindungi Password di Java Menggunakan GroupDocs.Watermark

Pelajari cara memuat dan mengelola watermark pada dokumen yang dilindungi password menggunakan GroupDocs.Watermark untuk Java. Panduan ini menyediakan instruksi langkah‑demi‑langkah, contoh praktis, dan tips pemecahan masalah.

Cara Memuat dan Menambahkan Watermark pada Dokumen Word yang Dilindungi Password Menggunakan GroupDocs.Watermark di Java

Pelajari cara menggunakan GroupDocs.Watermark dengan Java untuk memuat, mengelola, dan menambahkan watermark pada dokumen Word yang dilindungi password secara efisien.

Sumber Daya Tambahan

Masalah Umum dan Solusinya

  • Kesalahan password tidak valid – periksa kembali string password; harus dienkode UTF‑8.
  • Kekurangan memori pada PDF besar – aktifkan mode streaming dengan menggunakan konstruktor Watermarker yang menerima InputStream dan OutputStream.
  • Watermark tidak terlihat – pastikan opacity watermark diatur di atas 0.1 dan warnanya kontras dengan latar belakang halaman.

Pertanyaan yang Sering Diajukan

Q: Apakah saya dapat menambahkan beberapa watermark ke PDF yang sama?
A: Ya. Panggil watermarker.add() berulang kali dengan objek TextWatermark atau ImageWatermark yang berbeda; masing‑masing akan ditumpuk sesuai urutan penambahan.

Q: Apakah perpustakaan ini mempertahankan anotasi yang ada?
A: Tentu. Semua objek PDF asli, termasuk anotasi, bidang formulir, dan metadata, tetap tidak tersentuh kecuali Anda secara eksplisit memodifikasinya.

Q: Apakah memungkinkan hanya memberi watermark pada halaman tertentu?
A: Ya. Berikan PageRange (misalnya new PageRange(2, 4)) ke metode add untuk membatasi watermark pada halaman‑halaman spesifik.

Q: Apa ukuran file maksimum yang didukung?
A: SDK dapat menangani file hingga 2 GB tanpa memuat seluruh dokumen ke memori, berkat arsitektur streaming‑nya.

Q: Bagaimana cara menghapus watermark setelah ditambahkan?
A: Gunakan watermarker.remove(watermarkId) dimana watermarkId adalah identifier yang dikembalikan saat Anda pertama kali menambahkan watermark.

Last Updated: 2026-09-16
Tested with: GroupDocs.Watermark 23.9 for Java
Author: GroupDocs

Tutorial Terkait