Cara Memuat Dokumen Word yang Dilindungi Kata Sandi dan Menambahkan Watermark Menggunakan GroupDocs.Watermark Java

Jawaban Cepat

  • Apakah GroupDocs.Watermark dapat membuka file Word terenkripsi? Ya, cukup berikan kata sandi melalui WordProcessingLoadOptions.
  • Apakah saya memerlukan lisensi untuk pengembangan? Lisensi percobaan gratis dapat digunakan untuk evaluasi; lisensi penuh diperlukan untuk produksi.
  • Koordinat Maven apa yang diperlukan? com.groupdocs:groupdocs-watermark:24.11 (atau yang lebih baru).
  • Apakah memungkinkan memproses batch beberapa dokumen yang dilindungi? Tentu – buat instance Watermarker untuk setiap file di dalam loop.
  • Versi Java apa yang didukung? Java 8 ke atas.

Apa Itu “Memuat Word yang Dilindungi Kata Sandi”?

Memuat dokumen Word yang dilindungi kata sandi berarti membuka file .docx yang telah dienkripsi dengan kata sandi, mendekripsinya di memori, dan kemudian melakukan operasi seperti menambahkan watermark. Tanpa kata sandi yang benar, file tidak dapat diakses.

Mengapa Menggunakan GroupDocs.Watermark Java?

GroupDocs.Watermark Java menawarkan API sederhana untuk menangani berbagai format dokumen, termasuk file Word terenkripsi. Ia menyembunyikan detail tingkat rendah, memungkinkan Anda menambahkan watermark teks atau gambar dengan hanya beberapa baris kode, dan memastikan kinerja tinggi bahkan dengan dokumen besar.

Prasyarat

  • Java 8+ (IntelliJ IDEA, Eclipse, atau IDE apa pun yang Anda sukai)
  • Maven terpasang untuk manajemen dependensi
  • Akses ke lisensi GroupDocs.Watermark Java (percobaan atau berbayar)
  • Dokumen Word yang dilindungi kata sandi untuk diuji

Menyiapkan GroupDocs.Watermark untuk Java

Pengaturan Maven

Add the repository and dependency to your pom.xml file:

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

Unduhan Langsung

Jika Anda lebih suka penyiapan manual, unduh JAR terbaru dari sumber resmi: GroupDocs.Watermark for Java releases.

Langkah-langkah Akuisisi Lisensi

  1. Free Trial – Dapatkan lisensi sementara untuk menjelajahi semua fitur.
  2. Purchase – Dapatkan lisensi penuh untuk penggunaan produksi tanpa batas.

Cara Memuat Dokumen Word yang Dilindungi Kata Sandi

Langkah 1: Impor Paket yang Diperlukan

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.WordProcessingLoadOptions;

Langkah 2: Siapkan Opsi Muat dengan Kata Sandi

String filePath = "YOUR_DOCUMENT_DIRECTORY/protected-document.docx"; // Replace with your document path.
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("P@$$w0rd"); // Set the correct password here.

Pemanggilan setPassword memberi tahu GroupDocs.Watermark cara mendekripsi file sehingga Anda dapat bekerja dengannya.

Langkah 3: Inisialisasi Watermarker

Watermarker watermarker = new Watermarker(filePath, loadOptions);

Membuat instance Watermarker memberi Anda kontrol penuh atas konten dokumen dan watermark.

Langkah 4: Tambahkan Watermark Teks

import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.TextWatermark;

TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
watermarker.add(watermark);

Di sini kami membuat watermark teks sederhana. Anda dapat menyesuaikan font, ukuran, warna, rotasi, dan penempatan.

Langkah 5: Simpan dan Tutup

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/protected-document.docx";
watermarker.save(outputFilePath);
watermarker.close();

Menyimpan menuliskan watermark baru ke file baru, dan menutup melepaskan semua sumber daya native.

Masalah Umum dan Solusinya

  • Kata sandi salah – Verifikasi kata sandi dengan pemilik dokumen; kata sandi yang tidak cocok akan memunculkan WrongPasswordException.
  • Masalah jalur file – Gunakan jalur absolut atau pastikan direktori kerja mengarah ke folder yang tepat.
  • Dependensi Maven hilang – Periksa kembali bagian <repositories> dan <dependencies>; jalankan mvn clean install untuk menyegarkan cache lokal.

Aplikasi Praktis

  1. Firma hukum – Tambahkan watermark rahasia ke berkas kasus sebelum dibagikan kepada klien.
  2. Institusi pendidikan – Lindungi catatan kuliah dengan menambahkan watermark sambil tetap memungkinkan mahasiswa melihat kontennya.
  3. Perusahaan – Amankan laporan internal dengan watermark merek perusahaan, bahkan ketika file dilindungi kata sandi.

Tips Kinerja

  • Kurangi ukuran dokumen sebelum memuat untuk mengurangi konsumsi memori.
  • Gunakan kembali instance Watermarker hanya saat memproses satu dokumen; buat instance baru untuk setiap file dalam skenario batch.
  • Tutup sumber daya dengan cepat (watermarker.close()) untuk menghindari kebocoran memori.

Pertanyaan yang Sering Diajukan

T: Apakah GroupDocs.Watermark dapat menangani format terlindungi lainnya (misalnya, PDF)?
J: Ya, pustaka mendukung PDF, presentasi, dan spreadsheet yang dilindungi kata sandi menggunakan kelas opsi muat masing‑masing.

T: Apa yang terjadi jika saya mencoba memuat dokumen tanpa memberikan kata sandi?
J: Pustaka akan melempar WrongPasswordException. Selalu setel kata sandi di WordProcessingLoadOptions ketika file terenkripsi.

T: Apakah memungkinkan menambahkan watermark gambar alih‑alih teks?
J: Tentu. Gunakan kelas ImageWatermark dan tentukan jalur gambar, opasitas, serta penempatan.

T: Bagaimana cara menghapus watermark yang sebelumnya ditambahkan?
J: Dapatkan objek watermark melalui watermarker.getWatermarks() dan panggil watermarker.remove(watermark).

T: Apakah API mendukung dokumen multi‑bahasa?
J: Ya, karakter Unicode didukung sepenuhnya, memungkinkan watermark dalam bahasa apa pun.

Sumber Daya

Terakhir Diperbarui: 2025-12-23
Diuji Dengan: GroupDocs.Watermark 24.11 for Java
Penulis: GroupDocs