Nastavení licence GroupDocs Java – Průvodce licencováním

V tomto komplexním tutoriálu objevíte how to set groupdocs license java pro aplikace určené do produkce. Správná licence odemyká kompletní sadu funkcí GroupDocs.Metadata — jako je extrakce metadat, úpravy a kontroly souladu — a zároveň zajišťuje, že vaše nasazení je právně v souladu. Provedeme vás umístěním licenčního souboru, načítáním založeným na InputStream a možnostmi metered licence, abyste mohli s jistotou integrovat GroupDocs.Metadata do jakéhokoli Java projektu.

Rychlé odpovědi

  • Jaký typ souboru je vyžadován pro licenci GroupDocs.Metadata? Jednoduchý soubor .lic XML obsahující šifrovaný licenční klíč.
  • Mohu načíst licenci ze streamu? Ano—použijte License.setLicense(InputStream), abyste se vyhnuli pevně zakódovaným cestám k souborům.
  • Je podporována metered (pay‑per‑use) licence? Rozhodně; zavolejte Metered.setMeteredKey(String) s vaším klíčem.
  • Potřebuji samostatnou runtime závislost? Pouze jádro GroupDocs.Metadata JAR; licence je součástí stejné knihovny.
  • Bude licence fungovat na všech verzích Javy? Podporuje Javu 8 až 17, což pokrývá většinu podnikového prostředí.

Co je „set groupdocs license java“?

„set groupdocs license java“ odkazuje na proces aplikace platného licenčního souboru GroupDocs.Metadata v Java aplikaci, aby SDK fungovalo bez omezení hodnocení. Zahrnuje načtení poskytnutého souboru .lic XML za běhu, což odstraňuje vodotisky z trial verze, umožňuje neomezené zpracování dokumentů a aktivuje pokročilé funkce manipulace s metadaty napříč všemi podporovanými formáty.

Proč používat licencování GroupDocs.Metadata v Javě?

GroupDocs.Metadata podporuje 30+ vstupních a výstupních formátů — včetně PDF, DOCX, XLSX, PPTX a obrazových souborů — a dokáže zpracovat dokumenty až do 2 GB při zachování využití paměti pod 150 MB díky své streamovací architektuře. Správná licence zaručuje 100 % dostupnost funkcí a odstraňuje limit 5 stránek, který platí pro nelicencované hodnocení.

Požadavky

  • Java 8 nebo novější (doporučeno Java 17)
  • Systém sestavení Maven nebo Gradle pro přidání závislosti GroupDocs.Metadata
  • Platný soubor .lic nebo metered‑licenční klíč z vašeho účtu GroupDocs

Jak nastavit groupdocs license java?

Načtěte licenční soubor z classpath nebo externího umístění pomocí InputStream. Tento přístup funguje jak ve webových, tak desktopových prostředích a eliminuje pevně zakódované cesty k souborům. Umístěním licence do src/main/resources a voláním třídy License při spuštění aplikace zajistíte, že SDK bude plně odemčeno před provedením jakýchkoli operací s metadaty.

Krok 1: Přidat Maven závislost

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

Krok 2: Umístit licenční soubor

Zkopírujte GroupDocs.Metadata.lic do src/main/resources, aby byl zahrnut do vašeho JAR souboru.

Krok 3: Načíst licenci při spuštění aplikace

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

Třída License je vstupním bodem pro aplikaci licence GroupDocs.Metadata; načte šifrované XML a aktivuje všechny prémiové funkce.

Krok 4: Ověřit, že je licence aktivní

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

Spuštěním ověření se vypíše true, což potvrzuje, že licence byla správně aplikována.

Jak používat metered licencování (pay‑per‑use) v Javě

Metered licencování vám umožňuje platit na základě skutečného využití místo pevné předplatné. Třída Metered zajišťuje online aktivaci; každé volání API hlásí využití zpět GroupDocs pro fakturaci a můžete programově dotazovat zbývající kredity. Nahraďte volání setLicense voláním Metered.setMeteredKey, abyste přešli na tento model:

import com.groupdocs.metadata.metered.Metered;

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

Třída Metered zajišťuje online aktivaci; každé volání API hlásí využití zpět GroupDocs pro fakturaci.

Časté problémy a řešení

  • Soubor licence nebyl nalezen – Ujistěte se, že soubor je v classpath (src/main/resources) a odkazujte na něj s úvodní lomítkem (/GroupDocs.Metadata.lic).
  • Chyba neplatné licence – Ověřte, že soubor .lic odpovídá verzi produktu, kterou používáte; v případě potřeby jej vygenerujte z portálu GroupDocs.
  • Metered klíč odmítnut – Zkontrolujte řetězec klíče na přebytečné mezery nebo zalomení řádku; klíč musí být jedna nepřerušená řádka.

Dostupné tutoriály

Jak nastavit licenci GroupDocs.Metadata v Javě pomocí InputStream

Naučte se, jak nakonfigurovat licenci GroupDocs.Metadata pomocí InputStream v Javě. Odemkněte pokročilé funkce správy dokumentů pomocí tohoto krok za krokem průvodce.

Další zdroje

Často kladené otázky

Q: Mohu použít stejný licenční soubor pro více Java služeb?
A: Ano, jeden soubor .lic může být sdílen mezi libovolným počtem Java aplikací, pokud běží pod stejnou licenční smlouvou.

Q: Podporuje licence nasazení do cloudu (např. AWS, Azure)?
A: Rozhodně; licence je nezávislá na prostředí. Stačí zajistit, aby byl soubor přístupný kontejneru během běhu.

Q: Jak přepnout z trial verze na plnou licenci bez výpadku?
A: Nasadíte nový soubor .lic a restartujete aplikaci; SDK načte novou licenci při dalším inicializování.

Q: Co se stane, když metered klíč vyprší?
A: Volání API začnou vracet výjimku licence. Obnovte klíč ve svém účtu GroupDocs, aby se používání obnovilo.

Q: Existuje způsob, jak programově zkontrolovat zbývající kvótu využití?
A: Ano, zavolejte Metered.getUsageInfo(), abyste získali aktuální spotřebu a zbývající kredity.


Poslední aktualizace: 2026-06-07
Testováno s: GroupDocs.Metadata 23.12 pro Java
Autor: GroupDocs

Související tutoriály