Lingkungan Pengembangan Java - Prasyarat dan Penyiapan

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

• Java 17 atau lebih tinggi terpasang.
• Maven atau Gradle untuk manajemen dependensi.
• Akun GroupDocs Cloud dengan client ID dan client secret.

Tambahkan SDK ke proyek Anda dengan dependensi Maven di bawah ini (Anda juga dapat menggunakan setara Gradle). Biner terbaru tersedia di halaman unduhan.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Inisialisasi klien API menggunakan kredensial Anda. Potongan kode ini diambil langsung dari contoh kode.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

Dengan klien siap, Anda dapat melanjutkan ke alur kerja penghapusan yang sebenarnya.

Panduan Langkah-demi-Langkah untuk Menghapus Watermark Gambar dari PDF di Java

Langkah 1: Muat Dokumen Sumber

Pertama, tentukan PDF yang ingin Anda bersihkan. Objek FileInfo memberi tahu API di mana file berada dan opsional menyediakan kata sandi.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.pdf");
// inputFile.setPassword("pdfPassword"); // Uncomment if needed

Langkah 2: Tentukan Kriteria Watermark Gambar

Buat sebuah ImageSearchCriteria yang menunjuk ke gambar watermark yang ingin Anda hapus. Ini adalah inti dari operasi menghapus watermark gambar dari PDF di Java.

ImageSearchCriteria imageCriteria = new ImageSearchCriteria();
imageCriteria.setImagePath("watermark.png");

Langkah 3: Atur Opsi Penghapusan

Gabungkan informasi file dan kriteria pencarian ke dalam objek RemoveOptions. Anda juga menentukan di mana PDF yang telah dibersihkan akan disimpan.

RemoveOptions removeOptions = new RemoveOptions();
removeOptions.setFileInfo(inputFile);
removeOptions.setOutputPath("output.pdf");
removeOptions.setSearchCriteria(Collections.singletonList(imageCriteria));

Langkah 4: Jalankan Panggilan Penghapusan

Panggil metode remove pada WatermarkApi. Panggilan tersebut mengembalikan RemoveResult yang berisi path ke file yang diproses.

RemoveResult result = watermarkApi.remove(removeOptions);
System.out.println("Watermark removal completed. Output file: " + result.getPath());

Langkah 5: Proses Hasil

Tangani setiap pengecualian yang mungkin muncul. SDK melempar ApiException untuk kesalahan sisi layanan dan Exception umum untuk masalah yang tidak terduga.

try {
    // removal code above
} catch (ApiException e) {
    System.err.println("API exception occurred: " + e.getMessage());
} catch (Exception e) {
    System.err.println("Unexpected error: " + e.getMessage());
}

Contoh Kode Lengkap: Hapus Watermark Gambar Menggunakan GroupDocs

Contoh berikut menunjukkan alur kerja lengkap mulai dari inisialisasi klien hingga penanganan hasil.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiClient;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.ImageSearchCriteria;
import com.groupdocs.watermark.cloud.model.RemoveOptions;
import com.groupdocs.watermark.cloud.model.RemoveResult;
import java.util.Collections;

public class RemoveImageWatermarkFromPdf {
    public static void main(String[] args) {
        // Initialize API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.pdf");
        // If the PDF is password protected, uncomment the following line and set the password
        // inputFile.setPassword("pdfPassword");

// Define the image watermark to be removed
        ImageSearchCriteria imageCriteria = new ImageSearchCriteria();
        imageCriteria.setImagePath("watermark.png");

// Set up removal options
        RemoveOptions removeOptions = new RemoveOptions();
        removeOptions.setFileInfo(inputFile);
        removeOptions.setOutputPath("output.pdf");
        removeOptions.setSearchCriteria(Collections.singletonList(imageCriteria));

try {
            // Execute removal
            RemoveResult result = watermarkApi.remove(removeOptions);
            System.out.println("Watermark removal completed. Output file: " + result.getPath());
        } catch (ApiException e) {
            System.err.println("API exception occurred: " + e.getMessage());
        } catch (Exception e) {
            System.err.println("Unexpected error: " + e.getMessage());
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Operasi Penghapusan Watermark melalui REST API menggunakan cURL

Jika Anda lebih suka pendekatan REST murni, operasi yang sama dapat dilakukan dengan perintah cURL.

1. Otentikasi dan dapatkan token akses

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

2. Unggah PDF sumber

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input.pdf"

3. Jalankan penghapusan watermark

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/remove" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": {"filePath":"input.pdf"},
           "outputPath":"output.pdf",
           "searchCriteria":[{"type":"Image","imagePath":"watermark.png"}]
         }'

4. Unduh PDF yang dibersihkan

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Untuk referensi lengkap, lihat dokumentasi API.

Opsi Penghapusan Fine-Tuning

SDK menyediakan beberapa properti yang dapat Anda sesuaikan untuk berbagai skenario.

• Proteksi Kata Sandi - Jika PDF sumber dienkripsi, tetapkan kata sandi pada FileInfo.

  inputFile.setPassword("mySecret");

• Multiple Search Criteria - Hapus beberapa watermark dalam satu panggilan dengan menambahkan lebih banyak objek ImageSearchCriteria ke dalam daftar.

  ImageSearchCriteria logoCriteria = new ImageSearchCriteria();
  logoCriteria.setImagePath("logo.png");
  removeOptions.setSearchCriteria(Arrays.asList(imageCriteria, logoCriteria));

• Output Format - Meskipun defaultnya adalah PDF, Anda dapat mengubah format output dengan mengatur outputPath menggunakan ekstensi yang berbeda (mis., output.docx).

  removeOptions.setOutputPath("output.docx");

Opsi-opsi ini memungkinkan Anda menyesuaikan proses menghapus watermark gambar dari PDF di Java sesuai kebutuhan Anda.

Kesimpulan

Secara programatik menghapus watermark gambar dari file PDF sangat mudah dengan GroupDocs.Watermark Cloud SDK for Java. Dengan mengikuti langkah‑langkah di atas, Anda dapat mengintegrasikan penghapusan watermark ke dalam backend Java apa pun, menangani PDF yang terenkripsi, dan menyesuaikan operasi dengan opsi yang fleksibel. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; detail harga tersedia di halaman produk, dan lisensi sementara dapat diminta melalui halaman lisensi sementara. Mulailah membersihkan PDF Anda hari ini dan berikan dokumen yang rapi kepada pengguna Anda.

FAQs

• Bagaimana cara menghapus watermark gambar dari PDF di Java?
  Gunakan metode remove dari WatermarkApi dengan ImageSearchCriteria yang mengarah ke gambar watermark. Contoh kode lengkap dalam artikel ini menunjukkan langkah‑langkah tepatnya.

• Bagaimana jika PDF saya dilindungi kata sandi?
  Setel kata sandi pada objek FileInfo (inputFile.setPassword("yourPassword")) sebelum memanggil API penghapusan. SDK akan mendekripsi, memproses, dan mengenkripsi ulang file secara otomatis.

• Bisakah saya menghapus watermark dari format lain, seperti DOCX?
  Ya. API yang sama bekerja dengan format apa pun yang didukung oleh GroupDocs.Watermark. Cukup ubah ekstensi filePath dan outputPath sesuai.

• Apakah ada batasan ukuran PDF yang dapat saya proses?
  Layanan cloud menangani file hingga 500 MB per permintaan. Untuk dokumen yang lebih besar, pertimbangkan untuk membagi PDF menjadi bagian yang lebih kecil sebelum diproses.

Read More

• Tambahkan Watermark Gambar ke Dokumen PDF dengan Java
• Tambahkan Watermark ke Gambar menggunakan Java
• Hapus Watermark Gambar dari PDF di C# | Hapus Watermark PDF