Ustaw licencję GroupDocs Java – Przewodnik licencjonowania

W tym obszernym samouczku odkryjesz how to set groupdocs license java dla aplikacji produkcyjnych. Odpowiednie licencjonowanie odblokowuje pełny zestaw funkcji GroupDocs.Metadata — takich jak ekstrakcja metadanych, edycja i kontrole zgodności — jednocześnie zapewniając legalną zgodność wdrożenia. Przeprowadzimy Cię przez umieszczanie pliku licencji, ładowanie oparte na InputStream oraz opcje licencji metrowej, abyś mógł pewnie zintegrować GroupDocs.Metadata z dowolnym projektem Java.

Szybkie odpowiedzi

  • Jakiego typu plik jest wymagany dla licencji GroupDocs.Metadata? Zwykły plik .lic XML zawierający zaszyfrowany klucz licencji.
  • Czy mogę załadować licencję ze strumienia? Tak — użyj License.setLicense(InputStream), aby uniknąć twardego kodowania ścieżek do plików.
  • Czy obsługiwana jest licencja metrowa (płać‑za‑użycie)? Zdecydowanie; wywołaj Metered.setMeteredKey(String) z Twoim kluczem.
  • Czy potrzebuję oddzielnej zależności w czasie wykonywania? Tylko podstawowy JAR GroupDocs.Metadata; licencjonowanie znajduje się w tej samej bibliotece.
  • Czy licencja będzie działać we wszystkich wersjach Java? Obsługuje Java 8 do 17, obejmując większość środowisk korporacyjnych.

Co to jest „set groupdocs license java”?

„set groupdocs license java” odnosi się do procesu zastosowania ważnego pliku licencji GroupDocs.Metadata w aplikacji Java, tak aby SDK działało bez ograniczeń wersji próbnej. Polega to na ładowaniu dostarczonego pliku .lic XML w czasie wykonywania, co usuwa znak wodny wersji próbnej, umożliwia nieograniczone przetwarzanie dokumentów i aktywuje zaawansowane funkcje manipulacji metadanymi we wszystkich obsługiwanych formatach.

Dlaczego warto używać licencjonowania GroupDocs.Metadata w Javie?

GroupDocs.Metadata obsługuje ponad 30 formatów wejściowych i wyjściowych — w tym PDF, DOCX, XLSX, PPTX oraz pliki graficzne — i może przetwarzać dokumenty o rozmiarze do 2 GB, utrzymując zużycie pamięci poniżej 150 MB dzięki architekturze strumieniowej. Odpowiednie licencjonowanie gwarantuje 100 % dostępności funkcji i usuwa limit 5 stron, który obowiązuje w wersjach nielicencjonowanych.

Wymagania wstępne

  • Java 8 lub nowszy (zalecany Java 17)
  • System budowania Maven lub Gradle do dodania zależności GroupDocs.Metadata
  • Ważny plik .lic lub klucz licencji metrowej z Twojego konta GroupDocs

Jak ustawić licencję groupdocs java?

Załaduj plik licencji z classpath lub zewnętrznej lokalizacji przy użyciu InputStream. Takie podejście działa zarówno w środowiskach webowych, jak i desktopowych i eliminuje twardo zakodowane ścieżki do plików. Umieszczając licencję w src/main/resources i wywołując klasę License przy uruchamianiu aplikacji, zapewniasz pełne odblokowanie SDK przed wykonaniem jakichkolwiek operacji na metadanych.

Krok 1: Dodaj zależność Maven

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

Krok 2: Umieść plik licencji

Skopiuj GroupDocs.Metadata.lic do src/main/resources, aby został dołączony do Twojego pliku JAR.

Krok 3: Załaduj licencję przy uruchamianiu aplikacji

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);
        }
    }
}

Klasa License jest punktem wejścia do zastosowania licencji GroupDocs.Metadata; odczytuje zaszyfrowany XML i aktywuje wszystkie funkcje premium.

Krok 4: Zweryfikuj, że licencja jest aktywna

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());
    }
}

Uruchomienie weryfikacji wypisuje true, potwierdzając, że licencja została poprawnie zastosowana.

Jak używać licencjonowania metrowego (płać‑za‑użycie) w Javie

Licencjonowanie metrowe pozwala płacić w zależności od rzeczywistego użycia, a nie stałej opłaty z góry. Klasa Metered obsługuje aktywację online; każde wywołanie API zgłasza zużycie do GroupDocs w celu rozliczenia, a pozostałe kredyty możesz odpytać programowo. Zastąp wywołanie setLicense metodą Metered.setMeteredKey, aby przejść na ten model:

import com.groupdocs.metadata.metered.Metered;

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

Klasa Metered obsługuje aktywację online; każde wywołanie API zgłasza zużycie do GroupDocs w celu rozliczenia.

Częste problemy i rozwiązania

  • Plik licencji nie znaleziony – Upewnij się, że plik znajduje się w classpath (src/main/resources) i odwołuj się do niego z początkowym ukośnikiem (/GroupDocs.Metadata.lic).
  • Błąd nieprawidłowej licencji – Sprawdź, czy plik .lic odpowiada wersji produktu, której używasz; w razie potrzeby wygeneruj go ponownie w portalu GroupDocs.
  • Klucz metrowy odrzucony – Sprawdź dokładnie ciąg klucza pod kątem dodatkowych spacji lub znaków nowej linii; klucz musi być jedną nieprzerwaną linią.

Dostępne samouczki

Jak ustawić licencję GroupDocs.Metadata w Javie przy użyciu InputStream

Dowiedz się, jak skonfigurować licencję GroupDocs.Metadata przy użyciu InputStream w Javie. Odblokuj zaawansowane funkcje zarządzania dokumentami dzięki temu przewodnikowi krok po kroku.

Dodatkowe zasoby

Najczęściej zadawane pytania

P: Czy mogę używać tego samego pliku licencji w wielu usługach Java?
O: Tak, pojedynczy plik .lic może być współdzielony pomiędzy dowolną liczbą aplikacji Java, pod warunkiem że działają na tej samej umowie licencyjnej.

P: Czy licencja obsługuje wdrożenia w chmurze (np. AWS, Azure)?
O: Zdecydowanie; licencja jest niezależna od środowiska. Wystarczy zapewnić dostęp do pliku w kontenerze uruchomieniowym.

P: Jak przełączyć się z wersji próbnej na pełną licencję bez przestoju?
O: Wdroż nowy plik .lic i zrestartuj aplikację; SDK odczyta nową licencję przy następnym uruchomieniu.

P: Co się stanie, gdy klucz metrowy wygaśnie?
O: Wywołania API zaczną zwracać wyjątek licencyjny. Odśwież klucz w swoim koncie GroupDocs, aby wznowić korzystanie.

P: Czy istnieje sposób, aby programowo sprawdzić pozostały limit użycia?
O: Tak, wywołaj Metered.getUsageInfo(), aby uzyskać bieżące zużycie i pozostałe kredyty.

Ostatnia aktualizacja: 2026-06-07
Testowano z: GroupDocs.Metadata 23.12 dla Java
Autor: GroupDocs

Powiązane samouczki