Contoh Kerja Penuh untuk Menghapus Objek Anotasi dari PDF dengan REST di Node.JS

Contoh ini menunjukkan cara mengunggah PDF, menghapus semua anotasinya, dan mengunduh file yang telah dibersihkan menggunakan GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

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 terinstal dengan benar, dan lakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Hapus Anotasi PDF melalui REST API Menggunakan cURL

Berikut adalah perintah cURL yang melakukan alur kerja penghapusan anotasi yang sama melalui endpoint REST GroupDocs.Annotation Cloud.

# 1. Obtain an access token
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. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Untuk daftar lengkap endpoint dan parameter, lihat dokumentasi API resmi.

Cara Menghapus Objek Anotasi dari PDF dengan REST di Node.JS Berfungsi

1. Authentication Setup - Kelas Configuration diinstansiasi dengan clientId dan clientSecret Anda, membuat konteks terautentikasi untuk semua panggilan API berikutnya.

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);

2. File Upload - UploadFileRequest mengirimkan byte PDF lokal ke penyimpanan GroupDocs Cloud. Metode storageApi.uploadFile menangani transfer.

const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

3. Retrieve Annotations - GetAnnotationsRequest membangun objek permintaan dengan referensi FileInfo. Pemanggilan annotationsApi.getAnnotations mengembalikan koleksi objek anotasi, dari mana ID diekstrak.

const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

4. Delete Annotations - Jika ada ID, DeleteAnnotationsRequest diisi dan diteruskan ke annotationsApi.deleteAnnotations, yang secara permanen menghapus anotasi dari PDF yang disimpan.

const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

5. Download Clean PDF - Akhirnya, DownloadFileRequest mengambil file yang diperbarui, dan fs.writeFileSync menuliskannya ke sistem file lokal.

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

Untuk definisi kelas dan metode yang detail, lihat referensi API.

Menginstal dan Mengonfigurasi GroupDocs.Annotation Cloud SDK for Node.js

SDK didistribusikan sebagai paket npm. Instal dengan perintah di bawah ini dan kemudian require di proyek Anda.

npm install groupdocs-annotation-cloud

Anda juga dapat mengunduh paket terbaru secara langsung dari halaman rilis GitHub atau URL unduhan resmi.

Setelah instalasi, impor perpustakaan dan buat objek konfigurasi seperti yang ditunjukkan dalam contoh kode:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Pastikan lingkungan runtime Anda memenuhi persyaratan versi Node.js dan Anda memiliki akun GroupDocs yang valid untuk memperoleh kredensial klien.

Opsi dan Pengaturan Penghapusan Anotasi

SDK menyediakan beberapa parameter yang dapat Anda sesuaikan:

• clientId / clientSecret - Kredensial untuk autentikasi OAuth. Atur mereka di konstruktor Configuration.
• fileInfo.filePath - Jalur PDF di penyimpanan GroupDocs Cloud. Sesuaikan ini jika Anda menyimpan file di folder yang berbeda.
• annotationIds - Sebuah array ID yang dikembalikan oleh GetAnnotations. Menyediakan subset memungkinkan penghapusan selektif.

Pengaturan tambahan seperti batas waktu permintaan dan konfigurasi proxy tersedia dalam dokumentasi SDK; lihat dokumentasi resmi untuk daftar lengkap.

Praktik Terbaik untuk Menghapus Anotasi PDF melalui REST

• Validasi ID Anotasi - Selalu periksa bahwa ID yang ingin Anda hapus memang ada; mencoba menghapus ID yang tidak ada dapat menyebabkan error 404.
• Gunakan HTTPS - Semua panggilan API harus dilakukan melalui HTTPS untuk melindungi kredensial dan data dokumen Anda.
• Tangani File Besar dengan Unggahan Berpotongan - Untuk PDF yang lebih besar dari 100 MB, pilih endpoint unggahan multipart untuk menghindari timeout.
• Catat Respons API - Simpan ID permintaan dan respons untuk jejak audit serta mempermudah pemecahan masalah.
• Gunakan Kembali Token Akses - Cache token OAuth hingga kedaluwarsa untuk mengurangi beban otentikasi.

Pertanyaan Umum

• Bagaimana cara mengautentikasi dengan GroupDocs.Annotation Cloud API?
  Dapatkan client ID dan secret dari akun GroupDocs Anda, lalu minta token akses melalui endpoint OAuth. Lihat dokumentasi resmi untuk detail.

• Bisakah saya menghapus anotasi tertentu alih-alih semuanya?
  Ya, berikan ID anotasi yang ingin Anda hapus dalam DeleteAnnotationsRequest. SDK mengembalikan daftar ID anotasi setelah panggilan GetAnnotations.

• Bagaimana cara menghapus objek Anotasi dari PDF dengan REST di Node.JS?
  Gunakan GroupDocs.Annotation Cloud SDK for Node.js untuk memanggil endpoint DeleteAnnotations setelah mengambil ID anotasi. Alur kerja lengkap ditunjukkan dalam contoh kode dan bagian cURL panduan ini.

• Lisensi apa yang diperlukan untuk penggunaan produksi?
  Lisensi berbayar diperlukan untuk produksi. Anda dapat memperoleh lisensi sementara dari halaman lisensi sementara saat melakukan evaluasi.

Further Reading

• Ekstrak atau Hapus Anotasi dari PDF menggunakan REST API di Node.js
• Teks Coret dalam PDF dengan Node.js dan REST API
• Hapus Anotasi dari PDF menggunakan REST API di Python

Sebelum Anda Memulai: Prasyarat dan Instalasi

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

• Node.js 14 atau lebih baru terpasang di mesin pengembangan Anda.
• Akun GroupDocs Cloud aktif dengan client ID dan client secret.
• Akses ke file PDF yang ingin Anda gabungkan, disimpan di penyimpanan GroupDocs Cloud.

Instal SDK melalui npm dan unduh paket terbaru:

npm install groupdocs-merger-cloud

Anda juga dapat mengambil SDK dari halaman rilis resmi: Download SDK. Setelah instalasi, Anda siap untuk mulai menulis kode.

Panduan Langkah-demi-Langkah untuk Menggabungkan PDF di Node.JS

Langkah 1: Instal SDK dan Impor Kelas yang Diperlukan

Pertama, impor kelas yang Anda perlukan untuk menggabungkan PDF.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Impor ini memberi Anda akses ke API inti, objek konfigurasi, dan deskriptor file.

Langkah 2: Konfigurasikan Kredensial GroupDocs Anda

Buat objek konfigurasi dengan kredensial klien Anda.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Memberikan kredensial yang benar memungkinkan perpustakaan mengautentikasi permintaan Anda.

Langkah 3: Tentukan File PDF yang Akan Digabung

Daftar dokumen PDF yang ingin Anda gabungkan. Langkah ini mempersiapkan Anda untuk menggabungkan PDF di Node.JS secara efisien.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Setiap FileInfo menunjuk ke file yang disimpan di penyimpanan GroupDocs Cloud Anda.

Langkah 4: Atur Opsi Penggabungan

Konfigurasikan lokasi output dan lampirkan daftar file ke permintaan merge.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Pengaturan ini mengontrol cara Anda menggabungkan PDF di Node.JS dan di mana hasilnya akan disimpan.

Langkah 5: Jalankan Operasi Penggabungan

Buat instance API, panggil metode merge, dan tangani respons.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

Panggilan async mengembalikan jalur dokumen yang digabungkan jika operasi berhasil.

Contoh Implementasi Lengkap untuk Menggabungkan PDF di Node.JS

Kode berikut menunjukkan alur kerja lengkap dari konfigurasi hingga penanganan hasil.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

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.

Menggabungkan PDF melalui REST API menggunakan cURL

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

Pertama, dapatkan token akses:

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

Unggah PDF sumber ke penyimpanan Anda (ganti YOUR_ACCESS_TOKEN dengan token dari langkah sebelumnya):

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

Ulangi unggahan untuk input2.pdf. Kemudian minta operasi penggabungan:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Akhirnya, unduh file yang digabungkan:

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

Untuk daftar lengkap endpoint dan parameter, lihat referensi API.

Mengonfigurasi Opsi Penggabungan

SDK menyediakan beberapa opsi yang memungkinkan Anda menyesuaikan proses penggabungan secara detail:

• outputPath - Jalur tujuan untuk PDF yang digabungkan. Sesuaikan ini untuk mengontrol di mana hasil disimpan.
• fileInfos - Array objek FileInfo yang menentukan PDF sumber dan urutannya.

Anda juga dapat mengatur properti tambahan seperti pages untuk menggabungkan rentang halaman tertentu, atau password untuk PDF yang dienkripsi. Lihat dokumentasi resmi untuk daftar lengkap bidang yang dapat dikonfigurasi.

Pertimbangan Kinerja untuk Menggabungkan PDF

Saat menggabungkan file PDF yang besar atau banyak, perhatikan tips berikut:

• Gunakan async/await untuk menghindari pemblokiran event loop, terutama untuk dokumen besar.
• Unggahan batch: unggah PDF sumber secara paralel sebelum memanggil penggabungan untuk mengurangi latensi keseluruhan.
• Pemrosesan streaming: untuk PDF yang sangat besar, pertimbangkan menyimpan hasil menengah di penyimpanan cloud dan menggabungkannya dalam potongan yang lebih kecil.
• PDF terenkripsi: berikan kata sandi dalam objek FileInfo; memproses file terenkripsi menambah beban, jadi gabungkan setelah dekripsi bila memungkinkan.

Menerapkan praktik ini membantu Anda menggabungkan PDF di Node.JS secara efisien sambil meminimalkan konsumsi memori.

Pertanyaan yang Mungkin Anda Miliki

• Bagaimana cara menggabungkan file PDF di Node.JS menggunakan GroupDocs?
  Gunakan GroupDocs.Merger Cloud SDK for Node.js untuk membuat instance MergeApi, konfigurasikan MergeOptions dengan PDF sumber Anda, dan panggil mergeDocuments. Contoh kode lengkap dalam panduan ini menunjukkan prosesnya.

• Bisakah saya menggabungkan file PDF terenkripsi di Node.JS?
  Ya, SDK mendukung penggabungan PDF terenkripsi. Berikan kata sandi yang benar pada objek FileInfo sebelum memanggil mergeDocuments. Lihat dokumentasi resmi untuk detail.

• Apa saja opsi lisensi untuk GroupDocs.Merger?
  GroupDocs menawarkan paket harga yang fleksibel. Untuk pengujian, Anda dapat meminta lisensi sementara untuk mengevaluasi perpustakaan sebelum membeli langganan penuh.

• Di mana saya dapat menemukan contoh lebih lanjut dan dukungan?
  Contoh tambahan tersedia di repositori GitHub. Untuk bantuan, kunjungi forum dukungan.

Bacaan Lebih Lanjut

• Membagi PDF menjadi Beberapa PDF di Node.JS
• Kunci Dokumen PDF dengan Kata Sandi menggunakan REST API di Node.js
• Cara Menggabungkan File PDF di C# menggunakan REST API

Tambahkan Watermark Gambar ke Dokumen PDF di Java dalam 5 Langkah

1. Inisialisasi klien API: Buat instance ApiClient dengan ID klien dan rahasia Anda.

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

Langkah ini menghubungkan kode Java Anda ke layanan GroupDocs.Watermark Cloud. Lihat referensi API untuk detail lebih lanjut.

2. Tentukan file PDF sumber: Buat objek FileInfo yang menunjuk ke PDF yang ingin Anda beri watermark.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

File harus diunggah ke penyimpanan GroupDocs Anda sebelum permintaan.

3. Konfigurasikan watermark gambar: Tentukan jalur gambar, opasitas, faktor skala, rotasi, dan perataan.

   ImageWatermark imageWatermark = new ImageWatermark();
   imageWatermark.setImagePath("watermark.png");
   imageWatermark.setOpacity(0.5);
   imageWatermark.setScaleFactor(0.3);
   imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
   imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
   imageWatermark.setMargin(new Margin(10, 10, 10, 10));
   

   Sesuaikan nilai-nilai ini untuk mencapai tampilan yang diinginkan; opasitas mengontrol transparansi, sementara scaleFactor menentukan ukuran relatif terhadap halaman.

4. Atur opsi watermark dan jalur output: Gabungkan informasi file dan watermark ke dalam objek WatermarkOptions.

   WatermarkOptions options = new WatermarkOptions();
   options.setFileInfo(fileInfo);
   options.setImageWatermark(imageWatermark);
   options.setOutputPath("output.pdf");
   

   outputPath memberi tahu layanan di mana menyimpan PDF yang dihasilkan.

5. Jalankan permintaan: Buat AddWatermarkRequest dan panggil API. Tangani respons sukses atau kesalahan.

   AddWatermarkRequest request = new AddWatermarkRequest(options);
   try {
       AddWatermarkResponse response = watermarkApi.addWatermark(request);
       System.out.println("Watermark added successfully. Output file: " + response.getPath());
   } catch (Exception e) {
       System.err.println("Error adding watermark: " + e.getMessage());
   }
   

   Setelah eksekusi, PDF yang telah ditambahkan watermark tersedia di lokasi yang Anda tentukan.

Contoh Kode Lengkap: Tambahkan Watermark Gambar ke Dokumen PDF dengan Java

Contoh berikut menunjukkan implementasi lengkap mulai dari inisialisasi klien hingga menyimpan PDF yang diberi watermark.

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

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

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

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

Terapkan Watermark Gambar pada Dokumen PDF melalui cURL dan REST API

Berikut adalah panggilan REST yang dapat Anda gunakan dengan cURL untuk mencapai hasil yang sama tanpa menulis kode Java.

1. 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"}'

Respons berisi access_token yang digunakan dalam panggilan selanjutnya.

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=@/path/to/input.pdf"
   

3. Unggah gambar watermark

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

4. Tambahkan watermark gambar

   curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
              "fileInfo": { "filePath": "input.pdf" },
              "imageWatermark": {
                  "imagePath": "watermark.png",
                  "opacity": 0.5,
                  "scaleFactor": 0.3,
                  "horizontalAlignment": "Center",
                  "verticalAlignment": "Center",
                  "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
              },
              "outputPath": "output.pdf"
            }'
   

   Permintaan ini mencerminkan logika kode Java, menerapkan pengaturan opacity, skala, dan perataan yang sama.

5. Unduh PDF berwatermark

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

Untuk detail lebih lanjut tentang badan permintaan dan parameter yang didukung, lihat dokumentasi API resmi.

Menginstal dan Mengonfigurasi GroupDocs.Watermark Cloud SDK for Java

Tambahkan dependensi Maven ke pom.xml Anda (atau potongan Gradle yang setara). Perpustakaan ini dihosting di Maven Central.

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

Anda juga memerlukan akun GroupDocs Cloud yang valid. Dapatkan Client ID dan Client Secret Anda dari GroupDocs portal. Tidak diperlukan instalasi runtime tambahan karena SDK berkomunikasi dengan layanan cloud.

Menyesuaikan Opsi Watermark Gambar untuk Dokumen PDF

SDK menyediakan beberapa properti yang memungkinkan Anda mengontrol tampilan visual watermark.

Sesuaikan Opasitas

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

Nilai opacity berkisar dari 0.0 (sepenuhnya transparan) hingga 1.0 (sepenuhnya opak).

Ubah Faktor Skala

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

Faktor skala menentukan ukuran watermark relatif terhadap dimensi halaman.

Atur Penjajaran dan Margin

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

Pengaturan ini menempatkan watermark di sudut kanan bawah dengan margin 20 poin.

Untuk daftar lengkap properti yang dapat dikonfigurasi, lihat referensi API.

Kesimpulan

Menambahkan watermark gambar ke dokumen PDF di Java adalah tugas yang sederhana ketika Anda menggunakan GroupDocs.Watermark Cloud SDK for Java. SDK menangani semua manipulasi PDF tingkat rendah, memungkinkan Anda fokus pada aspek visual seperti opasitas, skala, dan penempatan. Baik Anda lebih suka implementasi Java native maupun alur kerja cURL berbasis cloud, hasil berkualitas tinggi yang sama dapat dicapai tanpa mengorbankan kinerja. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; detail harga tersedia di halaman produk dan halaman lisensi sementara dapat digunakan untuk evaluasi.

FAQs

• Bagaimana cara menambahkan watermark gambar ke PDF di Java tanpa kehilangan kualitas?
  Gunakan properti scaleFactor untuk mengatur ukuran watermark relatif terhadap halaman dan mempertahankan DPI asli PDF sumber. SDK mempertahankan resolusi PDF, sehingga watermark tetap tajam pada semua tingkat zoom.

• Apakah saya dapat menambahkan beberapa watermark ke PDF yang sama?
  Ya. Buat objek ImageWatermark terpisah dengan konfigurasi yang berbeda dan tambahkan secara berurutan dengan memanggil addWatermark beberapa kali atau dengan menambahkannya ke dalam daftar dalam permintaan.

• Apa format gambar yang didukung untuk watermark?
  API menerima jenis gambar umum seperti PNG, JPG, BMP, GIF dan TIFF. PNG direkomendasikan untuk kualitas lossless dan dukungan transparansi.

• Apakah ada cara untuk melihat pratinjau watermark sebelum menerapkannya?
  Anda dapat menggunakan GroupDocs.Watermark Cloud SDK for Java untuk menghasilkan PDF sementara dengan watermark dan mengunduhnya untuk ditinjau. Ini menggunakan panggilan addWatermark yang sama dengan jalur output yang mengarah ke lokasi sementara.

Baca Selengkapnya

• Tambahkan Watermark ke Gambar menggunakan Java
• Tambahkan Watermark ke Word dalam Java - Watermark Creator
• Tambahkan Watermark Gambar ke PDF | Cara Menambahkan Watermark ke Dokumen PDF Menggunakan .NET