Imposta licenza GroupDocs Java – Guida alla licenza

In questo tutorial completo scoprirai come impostare la licenza groupdocs java per applicazioni di livello produttivo. Una licenza corretta sblocca l’intera suite di funzionalità di GroupDocs.Metadata — come l’estrazione dei metadati, la modifica e i controlli di conformità — mantenendo la tua distribuzione legalmente conforme. Ti guideremo attraverso il posizionamento del file di licenza, il caricamento basato su InputStream e le opzioni di licenza a consumo, così potrai integrare con sicurezza GroupDocs.Metadata in qualsiasi progetto Java.

Risposte rapide

  • Qual è il tipo di file richiesto per una licenza GroupDocs.Metadata? Un semplice file .lic XML contenente la chiave di licenza crittata.
  • Posso caricare la licenza da uno stream? Sì — usa License.setLicense(InputStream) per evitare di codificare percorsi di file.
  • È supportata una licenza a consumo (pay‑per‑use)? Assolutamente; chiama Metered.setMeteredKey(String) con la tua chiave.
  • Ho bisogno di una dipendenza runtime separata? Solo il JAR core di GroupDocs.Metadata; la licenza è integrata nella stessa libreria.
  • La licenza funzionerà su tutte le versioni di Java? Supporta Java 8 fino a 17, coprendo la maggior parte degli ambienti aziendali.

Cos’è “set groupdocs license java”?

“set groupdocs license java” si riferisce al processo di applicare un file di licenza GroupDocs.Metadata valido all’interno di un’applicazione Java affinché l’SDK funzioni senza restrizioni di valutazione. Prevede il caricamento del file XML .lic fornito a runtime, che rimuove le filigrane di prova, abilita l’elaborazione illimitata dei documenti e attiva le funzionalità avanzate di manipolazione dei metadati su tutti i formati supportati.

Perché usare la licenza GroupDocs.Metadata in Java?

GroupDocs.Metadata supporta oltre 30 formati di input e output — inclusi PDF, DOCX, XLSX, PPTX e file immagine — e può elaborare documenti fino a 2 GB di dimensione mantenendo l’utilizzo della memoria sotto 150 MB grazie alla sua architettura di streaming. Una licenza corretta garantisce 100 % di disponibilità delle funzionalità e rimuove il limite di 5 pagine che si applica alle valutazioni non licenziate.

Prerequisiti

  • Java 8 o più recente (Java 17 consigliato)
  • Sistema di build Maven o Gradle per aggiungere la dipendenza GroupDocs.Metadata
  • Un file .lic valido o una chiave di licenza a consumo dal tuo account GroupDocs

Come impostare la licenza groupdocs java?

Carica il file di licenza dal classpath o da una posizione esterna usando un InputStream. Questo approccio funziona sia in ambienti web che desktop ed elimina i percorsi di file codificati. Posizionando la licenza in src/main/resources e invocando la classe License all’avvio dell’applicazione, garantisci che l’SDK sia completamente sbloccato prima che vengano eseguite operazioni sui metadati.

Passo 1: Aggiungi la dipendenza Maven

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

Passo 2: Posiziona il file di licenza

Copia GroupDocs.Metadata.lic in src/main/resources in modo che sia incluso nel tuo JAR.

Passo 3: Carica la licenza all’avvio dell’applicazione

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

La classe License è il punto di ingresso per applicare una licenza GroupDocs.Metadata; legge l’XML crittato e attiva tutte le funzionalità premium.

Passo 4: Verifica che la licenza sia attiva

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

Eseguendo la verifica stampa true, confermando che la licenza è stata applicata correttamente.

Come utilizzare la licenza a consumo (pay‑per‑use) in Java

La licenza a consumo consente di pagare in base all’uso reale anziché a un costo fisso anticipato. La classe Metered gestisce l’attivazione online; ogni chiamata API segnala l’utilizzo a GroupDocs per la fatturazione, e puoi interrogare i crediti rimanenti programmaticamente. Sostituisci la chiamata setLicense con Metered.setMeteredKey per passare a questo modello:

import com.groupdocs.metadata.metered.Metered;

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

La classe Metered gestisce l’attivazione online; ogni chiamata API segnala l’utilizzo a GroupDocs per la fatturazione.

Problemi comuni e soluzioni

  • File di licenza non trovato – Assicurati che il file sia nel classpath (src/main/resources) e riferiscilo con una barra iniziale (/GroupDocs.Metadata.lic).
  • Errore di licenza non valida – Verifica che il file .lic corrisponda alla versione del prodotto che stai usando; rigeneralo dal portale GroupDocs se necessario.
  • Chiave a consumo rifiutata – Controlla nuovamente la stringa della chiave per spazi extra o interruzioni di riga; la chiave deve essere una singola linea continua.

Tutorial disponibili

How to Set GroupDocs.Metadata License in Java Using InputStream

Scopri come configurare una licenza GroupDocs.Metadata usando un InputStream in Java. Sblocca le funzionalità avanzate di gestione dei documenti con questa guida passo‑passo.

Risorse aggiuntive

Domande frequenti

Q: Posso usare lo stesso file di licenza per più servizi Java?
A: Sì, un singolo file .lic può essere condiviso tra qualsiasi numero di applicazioni Java purché vengano eseguite sotto lo stesso accordo di licenza.

Q: La licenza supporta le distribuzioni cloud (ad es., AWS, Azure)?
A: Assolutamente; la licenza è indipendente dall’ambiente. Basta assicurarsi che il file sia accessibile al contenitore di runtime.

Q: Come posso passare da una versione di prova a una licenza completa senza tempi di inattività?
A: Distribuisci il nuovo file .lic e riavvia l’applicazione; l’SDK rileverà la nuova licenza al successivo avvio.

Q: Cosa succede se la chiave a consumo scade?
A: Le chiamate API inizieranno a restituire un’eccezione di licenza. Aggiorna la chiave dal tuo account GroupDocs per riprendere l’uso.

Q: Esiste un modo per verificare programmaticamente la quota di utilizzo rimanente?
A: Sì, chiama Metered.getUsageInfo() per recuperare il consumo attuale e i crediti rimanenti.

Ultimo aggiornamento: 2026-06-07
Testato con: GroupDocs.Metadata 23.12 per Java
Autore: GroupDocs

Tutorial correlati