GroupDocs.Metadata Cloud SDK for Java memungkinkan pengembang Java untuk secara programatis membaca dan memodifikasi properti dokumen PDF. Dalam panduan ini Anda akan belajar cara mengedit metadata PDF di Java, memperbarui bidang standar seperti Title dan Author, serta menambahkan pasangan kunci‑nilai khusus. SDK menyediakan API sederhana untuk memuat PDF, mengubah metadata-nya, dan menyimpan file kembali ke penyimpanan. Ikuti instruksi langkah demi langkah untuk mengintegrasikan penyuntingan metadata ke dalam aplikasi Java Anda.

Prasyarat dan Penyiapan

Untuk bekerja dengan metadata PDF, Anda memerlukan Java 8 atau yang lebih tinggi serta Maven yang terpasang di mesin pengembangan Anda. Unduh versi terbaru dari halaman ini.

Tambahkan SDK ke proyek Maven Anda:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.9</version>
</dependency>

Atau instal melalui baris perintah:

mvn install com.groupdocs:groupdocs-metadata-cloud

Buat file konfigurasi (atau atur variabel lingkungan) dengan ID klien dan rahasia klien Anda yang diperoleh dari dasbor GroupDocs Cloud. Tidak diperlukan kode lisensi untuk contoh ini; lisensi sementara dapat diminta dari halaman lisensi.

Memahami Metadata PDF

File PDF berisi sekumpulan properti standar (Title, Author, Subject, Keywords) dan memungkinkan pasangan kunci‑nilai khusus. Properti ini disimpan dalam kamus metadata dokumen dan dapat dibaca atau dimodifikasi tanpa mengubah konten visual file.

Fitur Utama GroupDocs.Metadata Cloud SDK for Java

  • Baca metadata yang ada dari PDF, DOCX, XLSX, dan banyak format lainnya.
  • Perbarui properti standar seperti Title, Author, Creator, dan Producer.
  • Tambahkan, edit, atau hapus properti kustom menggunakan antarmuka peta sederhana.
  • Simpan perubahan kembali ke file asli atau ke lokasi output baru.

Memodifikasi Properti Dokumen PDF Standar

SDK mengekspor kelas MetadataInfo yang menyediakan getter dan setter untuk semua bidang standar. Anda juga dapat mengakses koleksi CustomProperties untuk bekerja dengan entri yang didefinisikan pengguna.

Menambahkan Bidang Metadata Kustom

Metadata khusus disimpan sebagai kamus dengan kunci dan nilai string. SDK secara otomatis menyerialkan entri ini saat dokumen disimpan, sehingga tersedia bagi semua pembaca PDF yang mendukung metadata khusus.

Langkah-langkah untuk Mengedit Metadata PDF di Java

  1. Inisialisasi klien API: Buat objek Configuration dengan kredensial Anda dan buat instance MetadataApi.
  2. Unggah PDF sumber: Gunakan StorageApi untuk menempatkan file di penyimpanan GroupDocs Cloud Anda.
  3. Muat metadata PDF: Panggil metadataApi.getMetadataInfo untuk mengambil objek MetadataInfo.
  4. Perbarui bidang: Atur properti standar (mis., setTitle, setAuthor) dan tambahkan entri khusus melalui getCustomProperties().put("MyKey", "MyValue").
  5. Simpan perubahan: Panggil metadataApi.updateMetadataInfo untuk menulis metadata yang telah dimodifikasi kembali ke file.

Untuk detail lebih lanjut tentang kelas yang digunakan, lihat referensi API.

Edit Metadata PDF di Java - Contoh Kode Lengkap

Contoh berikut menunjukkan alur kerja lengkap: otentikasi, unggah file, modifikasi metadata, dan menyimpan PDF yang diperbarui.

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (sample.pdf, C:/files/sample.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 mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Edit Metadata PDF melalui REST API menggunakan cURL

Jika Anda lebih memilih untuk tidak menggunakan pustaka Java, operasi yang sama dapat dilakukan melalui GroupDocs Metadata Cloud REST API.

  1. Dapatkan token akses
curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. Unggah file PDF
   curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/octet-stream" \
        --data-binary "@C:/files/sample.pdf"
  1. Perbarui metadata
curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title":"New Document Title",
           "author":"John Doe",
           "subject":"Updated Subject",
           "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
         }'
  1. Unduh PDF yang diperbarui
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "C:/files/updated_sample.pdf"

Perintah ini memungkinkan Anda mengintegrasikan pengeditan metadata PDF ke dalam skrip, pipeline CI/CD, atau lingkungan apa pun di mana menginstal pustaka Java tidak praktis. Untuk daftar lengkap endpoint, lihat dokumentasi API.

Kesimpulan

Anda sekarang memiliki pemahaman lengkap tentang cara mengedit metadata PDF di Java menggunakan GroupDocs.Metadata Cloud SDK for Java. Panduan ini mencakup membaca metadata yang ada, memodifikasi bidang standar seperti Title dan Author, menambahkan pasangan kunci‑nilai khusus, dan menyimpan perubahan. SDK berjalan di mesin lokal atau server Anda dan memerlukan lisensi yang valid; Anda dapat memulai dengan lisensi sementara dari halaman lisensi dan meningkatkan ke lisensi komersial penuh untuk penggunaan produksi. Terapkan teknik ini untuk menjaga dokumen PDF Anda tetap terorganisir dengan baik dan dapat dicari.

FAQ

Bagaimana saya dapat mengedit metadata PDF di Java menggunakan GroupDocs.Metadata Cloud SDK?
Gunakan SDK untuk memuat PDF, mengubah properti MetadataInfo, dan menyimpan file. Lihat dokumentasi GroupDocs.Metadata Cloud SDK for Java untuk detailnya.

Bisakah saya menambahkan pasangan kunci-nilai khusus ke metadata PDF?
Ya, SDK memungkinkan penambahan entri khusus melalui metode setCustomProperties. Lihat referensi API untuk contoh.

Apakah lisensi sementara cukup untuk pengembangan?
Lisensi sementara dari halaman lisensi memungkinkan Anda menguji SDK. Untuk produksi, beli lisensi penuh.

Di mana saya dapat menemukan contoh lebih banyak untuk manipulasi metadata PDF?
Dokumentasi resmi documentation dan forums berisi contoh tambahan serta dukungan komunitas.

Baca Selengkapnya