GroupDocs.Metadata Cloud SDK for Java Java geliştiricilerinin PDF belge özelliklerini programlı olarak okumasını ve değiştirmesini sağlar. Bu rehberde Java’da PDF meta verilerini nasıl düzenleyeceğinizi, Başlık ve Yazar gibi standart alanları nasıl güncelleyeceğinizi ve özel anahtar‑değer çiftleri eklemeyi öğreneceksiniz. SDK, bir PDF’yi yüklemek, meta verilerini değiştirmek ve dosyayı depolamaya geri kaydetmek için basit bir API sunar. Java uygulamalarınıza meta veri düzenlemeyi entegre etmek için adım adım talimatları izleyin.

Önkoşullar ve Kurulum

PDF meta verileriyle çalışmak için Java 8 veya daha yeni bir sürüm ve Maven’in geliştirme makinenizde kurulu olması gerekir. En son sürümü bu sayfadan indirin.

SDK’yı Maven projenize ekleyin:

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

Veya komut satırı üzerinden kurun:

mvn install com.groupdocs:groupdocs-metadata-cloud

GroupDocs Cloud panosundan aldığınız istemci kimliği ve istemci gizli anahtarınızla bir yapılandırma dosyası oluşturun (veya ortam değişkenlerini ayarlayın). Bu örnek için lisans kodu gerekmez; geçici bir lisans lisans sayfasından talep edilebilir.

PDF Meta Verilerini Anlamak

PDF dosyaları, bir dizi standart özelliği (Title, Author, Subject, Keywords) içerir ve özel anahtar‑değer çiftlerine izin verir. Bu özellikler, belgenin meta veri sözlüğünde depolanır ve dosyanın görsel içeriğini değiştirmeden okunabilir veya değiştirilebilir.

GroupDocs.Metadata Cloud SDK for Java’ın Ana Özellikleri

  • PDF, DOCX, XLSX, ve birçok diğer formatta mevcut meta verileri okuyun.
  • Başlık, Yazar, Oluşturucu ve Üretici gibi standart özellikleri güncelleyin.
  • Basit bir harita arayüzü kullanarak özel özellikleri ekleyin, düzenleyin veya kaldırın.
  • Değişiklikleri orijinal dosyaya veya yeni bir çıkış konumuna kaydedin.

Standart PDF Belge Özelliklerini Değiştirme

SDK, tüm standart alanlar için getter ve setter sağlayan MetadataInfo sınıfını sunar. Ayrıca, kullanıcı tanımlı girişlerle çalışmak için CustomProperties koleksiyonuna da erişebilirsiniz.

Özel Meta Veri Alanları Ekleme

Özel meta veriler, dize anahtarları ve değerlerinden oluşan bir sözlük olarak depolanır. SDK, belge kaydedildiğinde bu girişleri otomatik olarak serileştirir ve böylece özel meta verileri destekleyen herhangi bir PDF okuyucu tarafından kullanılabilir hale getirir.

Java’da PDF Meta Verilerini Düzenleme Adımları

  1. API istemcisini başlatın: Kimlik bilgilerinizle bir Configuration nesnesi oluşturun ve MetadataApi örneğini başlatın.
  2. Kaynak PDF’yi yükleyin: Dosyayı GroupDocs Cloud depolamanıza yerleştirmek için StorageApi‘yi kullanın.
  3. PDF meta verilerini yükleyin: metadataApi.getMetadataInfo metodunu çağırarak bir MetadataInfo nesnesi alın.
  4. Alanları güncelleyin: Standart özellikleri (ör. setTitle, setAuthor) ayarlayın ve getCustomProperties().put("MyKey", "MyValue") ile özel girişler ekleyin.
  5. Değişiklikleri kaydedin: Değiştirilen meta verileri dosyaya geri yazmak için metadataApi.updateMetadataInfo metodunu çağırın.

Kullanılan sınıflar hakkında daha fazla ayrıntı için, API referansına bakın.

Java’da PDF Meta Verilerini Düzenleme - Tam Kod Örneği

Aşağıdaki örnek tam bir iş akışını gösterir: kimlik doğrulama, dosya yükleme, meta veri değiştirme ve güncellenmiş PDF’yi kaydetme.

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (sample.pdf, C:/files/sample.pdf) gerçek dosya konumlarınızla eşleşecek şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi dokümantasyona bakın veya destek ekibi ile iletişime geçin.

cURL kullanarak REST API ile PDF Meta Verilerini Düzenleme

Java kütüphanesini kullanmak istemezseniz, aynı işlem GroupDocs Metadata Cloud REST API aracılığıyla gerçekleştirilebilir.

  1. Erişim belirteci alın
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. PDF dosyasını yükleyin
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. Meta verileri güncelle
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. Güncellenmiş PDF’yi indirin
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"

Bu komutlar, PDF meta verisi düzenlemesini betiklere, CI/CD boru hatlarına veya Java kütüphanesini kurmanın pratik olmadığı herhangi bir ortama entegre etmenizi sağlar. Tüm uç noktaların tam listesi için, API belgelerine bakın.

Sonuç

Artık Java kullanarak GroupDocs.Metadata Cloud SDK for Java ile PDF meta verilerini düzenlemenin tam bir anlayışına sahipsiniz. Kılavuz, mevcut meta verileri okuma, Başlık ve Yazar gibi standart alanları değiştirme, özel anahtar‑değer çiftleri ekleme ve değişiklikleri kalıcı hale getirme konularını kapsadı. SDK, yerel makinenizde veya sunucunuzda çalışır ve geçerli bir lisans gerektirir; geçici bir lisansla lisans sayfasından başlayabilir ve üretim kullanımı için tam bir ticari lisansa yükseltebilirsiniz. PDF belgelerinizi iyi organize edilmiş ve aranabilir tutmak için bu teknikleri uygulayın.

SSS

Java kullanarak GroupDocs.Metadata Cloud SDK ile PDF meta verilerini nasıl düzenleyebilirim?
SDK’yı kullanarak bir PDF yükleyin, MetadataInfo özelliklerini değiştirin ve dosyayı kaydedin. Ayrıntılar için GroupDocs.Metadata Cloud SDK for Java belgelerine bakın.

PDF’nin meta verilerine özel anahtar‑değer çiftleri ekleyebilir miyim?
Evet, SDK setCustomProperties yöntemi aracılığıyla özel girişler eklemeye izin verir. Örnekler için API referansına bakın.

Geçici bir lisans geliştirme için yeterli mi?
Geçici bir lisans, lisans sayfası üzerinden SDK’yı test etmenizi sağlar. Üretim için tam bir lisans satın alın.

PDF meta verisi manipülasyonu için daha fazla örnek nerede bulunabilir?
Resmi dökümantasyon ve forumlar ek örnekler ve topluluk desteği içerir.

Daha Fazla Oku