GroupDocs Lisansını Java’da Ayarlama – Lisans Rehberi

Bu kapsamlı öğreticide, üretim‑düzeyinde uygulamalar için how to set groupdocs license java öğreneceksiniz. Doğru lisanslama, GroupDocs.Metadata özelliklerinin tam paketini—metadata çıkarma, düzenleme ve uyumluluk kontrolleri gibi—açığa çıkarır ve dağıtımınızın yasal olarak uyumlu kalmasını sağlar. Lisans dosyasının yerleştirilmesi, InputStream‑tabanlı yükleme ve ölçülen‑lisans seçeneklerini adım adım inceleyeceğiz, böylece GroupDocs.Metadata’ı herhangi bir Java projesine güvenle entegre edebilirsiniz.

Hızlı Cevaplar

  • What file type is required for a GroupDocs.Metadata license? A plain .lic XML file containing the encrypted license key.
  • Can I load the license from a stream? Yes—use License.setLicense(InputStream) to avoid hard‑coding file paths.
  • Is a metered (pay‑per‑use) license supported? Absolutely; call Metered.setMeteredKey(String) with your key.
  • Do I need a separate runtime dependency? Only the core GroupDocs.Metadata JAR; licensing lives inside the same library.
  • Will the license work on all Java versions? It supports Java 8 through 17, covering the majority of enterprise environments.

“set groupdocs license java” nedir?

“set groupdocs license java”, bir Java uygulamasında geçerli bir GroupDocs.Metadata lisans dosyasını uygulama sürecine denir; böylece SDK değerlendirme kısıtlamaları olmadan çalışır. Bu, çalışma zamanında sağlanan .lic XML dosyasının yüklenmesini içerir; bu da deneme filigranlarını kaldırır, sınırsız belge işleme sağlar ve tüm desteklenen formatlarda gelişmiş metadata manipülasyon özelliklerini etkinleştirir.

Java’da GroupDocs.Metadata lisanslamasını neden kullanmalısınız?

GroupDocs.Metadata, 30+ giriş ve çıkış formatını—PDF, DOCX, XLSX, PPTX ve görüntü dosyaları dahil—destekler ve akış mimarisi sayesinde bellek kullanımını 150 MB altında tutarak 2 GB büyüklüğündeki belgeleri işleyebilir. Doğru lisanslama, %100 özellik kullanılabilirliğini garanti eder ve lisanssız değerlendirmelerde uygulanan 5 sayfalık sınırlamayı ortadan kaldırır.

Önkoşullar

  • Java 8 veya daha yeni (Java 17 önerilir)
  • GroupDocs.Metadata bağımlılığını eklemek için Maven veya Gradle yapı sistemi
  • Geçerli bir .lic dosyası veya GroupDocs hesabınızdan bir ölçülen‑lisans anahtarı

groupdocs lisansını java’da nasıl ayarlarsınız?

InputStream kullanarak lisans dosyasını sınıf yolundan (classpath) veya harici bir konumdan yükleyin. Bu yaklaşım hem web hem de masaüstü ortamlarında çalışır ve sabit kodlanmış dosya yollarını ortadan kaldırır. Lisansı src/main/resources içine yerleştirerek ve uygulama başlatıldığında License sınıfını çağırarak, SDK’nın herhangi bir metadata işlemi gerçekleştirilmeden önce tamamen açıldığından emin olursunuz.

Adım 1: Maven bağımlılığını ekleyin

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

Adım 2: Lisans dosyasını yerleştirin

GroupDocs.Metadata.lic dosyasını src/main/resources içine kopyalayın, böylece JAR’ınızla paketlenir.

Adım 3: Uygulama başlangıcında lisansı yükleyin

import com.groupdocs.metadata.License;
import java.io.InputStream;

public class LicenseLoader {
    public static void applyLicense() throws Exception {
        try (InputStream licStream = LicenseLoader.class.getResourceAsStream("/GroupDocs.Metadata.lic")) {
            License license = new License();
            license.setLicense(licStream);
        }
    }
}

License sınıfı, bir GroupDocs.Metadata lisansını uygulamak için giriş noktasıdır; şifreli XML’i okur ve tüm premium yetenekleri etkinleştirir.

Adım 4: Lisansın etkin olduğunu doğrulayın

import com.groupdocs.metadata.Metadata;
import java.io.File;

public class Verify {
    public static void main(String[] args) throws Exception {
        LicenseLoader.applyLicense(); // ensure license is set first
        Metadata metadata = new Metadata(new File("sample.pdf"));
        System.out.println("License applied: " + metadata.getLicenseInfo().isValid());
    }
}

Doğrulamayı çalıştırmak true çıktısını verir ve lisansın doğru bir şekilde uygulandığını onaylar.

Java’da ölçülen lisanslamayı (kullandıkça‑öde) nasıl kullanılır

Ölçülen lisanslama, sabit bir ön maliyet yerine gerçek kullanımınıza göre ödeme yapmanızı sağlar. Metered sınıfı çevrimiçi etkinleştirmeyi yönetir; her API çağrısı kullanım bilgisini faturalandırma için GroupDocs’a gönderir ve kalan kredileri programlı olarak sorgulayabilirsiniz. Bu modele geçmek için setLicense çağrısını Metered.setMeteredKey ile değiştirin:

import com.groupdocs.metadata.metered.Metered;

public class MeteredLicense {
    public static void applyMeteredKey() {
        Metered.setMeteredKey("YOUR-METERED-KEY-HERE");
    }
}

Metered sınıfı çevrimiçi etkinleştirmeyi yönetir; her API çağrısı kullanım bilgisini faturalandırma için GroupDocs’a gönderir.

Yaygın Sorunlar ve Çözümler

  • License file not found – Dosyanın sınıf yolunda (src/main/resources) olduğundan emin olun ve başında bir eğik çizgi (/GroupDocs.Metadata.lic) ile referans verin.
  • Invalid license error – .lic dosyasının kullandığınız ürün sürümüyle eşleştiğini doğrulayın; gerekirse GroupDocs portalından yeniden oluşturun.
  • Metered key rejected – Anahtar dizesinde ekstra boşluklar veya satır sonları olmadığından emin olun; anahtar tek, kesintisiz bir satır olmalıdır.

Mevcut Öğreticiler

Java’da InputStream Kullanarak GroupDocs.Metadata Lisansını Nasıl Ayarlarsınız

Java’da bir InputStream kullanarak GroupDocs.Metadata lisansını nasıl yapılandıracağınızı öğrenin. Bu adım‑adım kılavuzla gelişmiş belge yönetimi özelliklerinin kilidini açın.

Ek Kaynaklar

Sıkça Sorulan Sorular

S: Aynı lisans dosyasını birden fazla Java servisi için kullanabilir miyim?
C: Evet, tek bir .lic dosyası aynı lisans anlaşması altında çalışan herhangi sayıda Java uygulaması arasında paylaşılabilir.

S: Lisans bulut dağıtımlarını (ör. AWS, Azure) destekliyor mu?
C: Kesinlikle; lisans ortamdan bağımsızdır. Dosyanın çalışma zamanı konteynerine erişilebilir olduğundan emin olun.

S: Kesinti olmadan deneme lisansından tam lisansa nasıl geçebilirim?
C: Yeni .lic dosyasını dağıtın ve uygulamayı yeniden başlatın; SDK bir sonraki başlatmada yeni lisansı algılar.

S: Ölçülen anahtar süresi dolarsa ne olur?
C: API çağrıları lisans istisnası döndürmeye başlayacaktır. Kullanımı sürdürmek için anahtarı GroupDocs hesabınızdan yenileyin.

S: Kalan kullanım kotasını programlı olarak kontrol etmenin bir yolu var mı?
C: Evet, mevcut tüketimi ve kalan kredileri almak için Metered.getUsageInfo() metodunu çağırın.

Son Güncelleme: 2026-06-07
Test Edilen Versiyon: GroupDocs.Metadata 23.12 for Java
Yazar: GroupDocs

İlgili Öğreticiler