GroupDocs Watermark (Metered) için Java’da Lisans Ayarlama

Modern işletmeler için fikri mülkiyet koruması en önemli önceliklerden biridir ve filigranlar bunu sağlamanın kanıtlanmış bir yoludur. Bu öğreticide GroupDocs.Watermark için bir metered yaklaşımı kullanarak lisans nasıl ayarlanır öğrenecek ve watermark pdf dosyalarına tam kontrol sağlayarak filigran ekleyebileceksiniz. Gereksinimlerden gerçek dünya kullanım senaryolarına kadar her şeyi adım adım inceleyecek ve lisansı etkinleştirmek için public private keys‘i nerede kullanmanız gerektiğini göstereceğiz.

Hızlı Yanıtlar

Metered lisans nedir? API çağrısını izleyen kullanım‑bazlı lisans modeli.
Lisans dosyasına ihtiyacım var mı? Hayır – public ve private anahtarlarla etkinleştirirsiniz.
Hangi Java sürümü gereklidir? Java 8 veya üzeri.
PDF belgelerine filigran ekleyebilir miyim? Evet, API PDF, DOCX, PPTX ve görüntüleri destekler.
Bu yöntem güvenli mi? Evet, anahtarlar HTTPS üzerinden iletilir ve asla düz metin olarak depolanmaz.

Metered Lisans Nedir ve Neden Kullanılır?

Metered lisans, gerçekte tükettiğiniz şey için ödeme yapmanızı sağlar; bu da SaaS veya mikro‑servis mimarileri için idealdir. Geleneksel lisans dosyalarını yönetme yükü olmadan document security watermark yetenekleri sunar ve kullanımınızı anında artırıp azaltabilirsiniz.

Önkoşullar

Başlamadan önce şunların kurulu olduğundan emin olun:

GroupDocs.Watermark for Java ≥ 24.11 (en son sürüm).
JDK 8+ yüklü ve JAVA_HOME yapılandırılmış.
Public ve private anahtarlar GroupDocs hesabınızdan alınmış (kod içinde kullanacaksınız).

GroupDocs.Watermark for Java’ı Kurma

Kurulum Bilgileri

GroupDocs.Watermark’ı Maven projenize entegre edin:

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

İpucu: Aşağıdaki doğrudan indirme seçeneği için aynı depo URL’si kullanılır.

Doğrudan İndirme

Resmi sürüm sayfasından en yeni JAR dosyasını alın: GroupDocs.Watermark for Java releases.

Lisans Edinme

Premium özellikleri açmak için geçici veya deneme lisansına ihtiyacınız var. GroupDocs web sitesinde kaydolun ve sağlanan public/private anahtarları kopyalayın.

Temel Başlatma

Kütüphane sınıf yolunuza eklendikten sonra şu şekilde başlatabilirsiniz:

import com.groupdocs.watermark.License;

public class InitializeWatermark {
    public static void main(String[] args) throws Exception {
        License license = new License();
        // Apply the license using your path to the license file
        license.setLicense("path/to/your/license/file.lic");
    }
}

Neden önemli? Metered lisans kullansanız bile License nesnesini başlatmak, SDK’nın daha sonraki iş akışında anahtar‑tabanlı aktivasyonu kabul etmesini sağlar.

Uygulama Kılavuzu

Metered Lisans Ayarlama

Adım 1: Genel ve Özel Anahtarları Tanımlayın

// Step 1: Define the public and private keys for the metered license.
String publicKey = "*****"; // Replace with your actual public key
String privateKey = "*****"; // Replace with your actual private key

Bu anahtarlar public private keys kullanarak hesabınızı güvenli bir şekilde tanımlar.

Adım 2: Metered Sınıfının Bir Örneğini Oluşturun

// Step 2: Create an instance of Metered class.
Metered metered = new Metered();

Metered sınıfı, tüm kullanım takibini arka planda yönetir.

Adım 3: Sağlanan Anahtarlarla Metered Lisansı Ayarlayın

// Step 3: Set the metered license using the provided keys.
metered.setMeteredKey(publicKey, privateKey);

Bu çağrıdan sonra SDK tam lisanslı olur ve watermark pdf dosyaları eklemeye ya da watermarked documents oluşturmaya başlayabilirsiniz.

Neden Lisans Dosyası Yerine Genel/Özel Anahtarlar Kullanılır?

Güvenlik: Anahtarlar asla düz metin olarak diske yazılmaz.
Esneklik: Ortamları (dev, test, prod) dosya kopyalamadan değiştirebilirsiniz.
Ölçeklenebilirlik: Konteynerlerin değişmez olduğu bulut‑yerel dağıtımlar için mükemmeldir.

Pratik Uygulamalar

Document Security: PDF’lerde yetkisiz dağıtımı önlemek için görünür veya görünmez bir filigran ekleyin.
Usage Tracking: Her ay işlenen belge sayısını izleyerek metered kotanız içinde kalın.
CMS Integration: İçerik yönetim sistemine yüklenen her dosyaya otomatik olarak apply watermark pdf uygulayın.

Performans Düşünceleri

Filigranı yalnızca gerektiğinde uygulayın – büyük toplu işlemlerden kaçının.
Metered örneğini istekler arasında yeniden kullanın; nesne oluşturma maliyetini azaltır.
Yüksek çözünürlüklü görüntülerde belleği izleyin; SDK, ayak izini düşük tutmak için akış (streaming) API’leri sunar.

Yaygın Sorunlar ve Çözümler

Sorun	Çözüm
Anahtarlar reddediliyor	Dizelerde ekstra boşluk veya satır sonu olmadığından emin olun.
Lisans etkinleşmedi	`metered.setMeteredKey(...)` filigran işleminden önce çağrıldığından emin olun.
Büyük PDF’lerde bellek hataları	`WatermarkOptions.setUseMemoryCache(true)` kullanarak işleme diske yönlendirin.

Sıkça Sorulan Sorular

S: Metered lisans nedir ve neden kullanmalıyım?
C: Metered lisans her API çağrısını izler, sadece gerçek kullanım için ödeme yapmanızı ve uygulamanızı kolayca ölçeklendirmenizi sağlar.

S: Deneme lisans dosyası ile metered anahtar arasında geçiş yapabilir miyim?
C: Evet. Deneme için license.setLicense("path/to/file.lic") çağırın, ardından metered.setMeteredKey(...) ile değiştirin.

S: Public veya private anahtarım hatalı girilirse ne olur?
C: SDK bir kimlik doğrulama istisnası fırlatır ve premium özelliklere erişimi engeller.

S: Ayda kaç filigran ekleyebileceğim konusunda bir limit var mı?
C: Limitler, GroupDocs ile yaptığınız anlaşmaya bağlıdır; kesin kotalar için kontrol panelinizi inceleyin.

S: Bu yöntem sadece PDF’ler için mi, yoksa görüntü dosyaları için de geçerli mi?
C: Kesinlikle. Aynı API JPEG, PNG, BMP ve diğer yaygın görüntü formatlarını destekler.

Kaynaklar

Son Güncelleme: 2026-01-21
Test Edilen Versiyon: GroupDocs.Watermark 24.11 for Java
Yazar: GroupDocs