Définir la licence GroupDocs Java – Guide de licence

Dans ce tutoriel complet, vous découvrirez comment définir la licence groupdocs java pour des applications de niveau production. Une licence appropriée débloque l’ensemble complet des fonctionnalités de GroupDocs.Metadata — telles que l’extraction de métadonnées, l’édition et les contrôles de conformité—tout en maintenant votre déploiement conforme sur le plan juridique. Nous parcourrons le placement du fichier de licence, le chargement basé sur InputStream et les options de licence à compte‑à‑rebours, afin que vous puissiez intégrer GroupDocs.Metadata en toute confiance dans n’importe quel projet Java.

Réponses rapides

  • Quel type de fichier est requis pour une licence GroupDocs.Metadata ? Un fichier XML .lic simple contenant la clé de licence chiffrée.
  • Puis‑je charger la licence depuis un flux ? Oui—utilisez License.setLicense(InputStream) pour éviter de coder en dur les chemins de fichiers.
  • Une licence à compte‑à‑rebours (pay‑per‑use) est‑elle prise en charge ? Absolument ; appelez Metered.setMeteredKey(String) avec votre clé.
  • Ai‑je besoin d’une dépendance d’exécution séparée ? Seulement le JAR principal de GroupDocs.Metadata ; la licence est intégrée dans la même bibliothèque.
  • La licence fonctionnera‑t‑elle sur toutes les versions de Java ? Elle prend en charge Java 8 à 17, couvrant la majorité des environnements d’entreprise.

Qu’est‑ce que “set groupdocs license java” ?

« set groupdocs license java » désigne le processus d’application d’un fichier de licence GroupDocs.Metadata valide dans une application Java afin que le SDK fonctionne sans restrictions d’évaluation. Cela implique de charger le fichier XML .lic fourni au moment de l’exécution, ce qui supprime les filigranes d’essai, permet un traitement illimité des documents et active les fonctionnalités avancées de manipulation des métadonnées pour tous les formats pris en charge.

Pourquoi utiliser la licence GroupDocs.Metadata en Java ?

GroupDocs.Metadata prend en charge plus de 30 formats d’entrée et de sortie—y compris PDF, DOCX, XLSX, PPTX et les fichiers image—et peut traiter des documents jusqu’à 2 Go tout en maintenant l’utilisation de la mémoire en dessous de 150 Mo grâce à son architecture de streaming. Une licence appropriée garantit 100 % de disponibilité des fonctionnalités et supprime la limite de 5 pages appliquée aux évaluations non licenciées.

Prérequis

  • Java 8 ou plus récent (Java 17 recommandé)
  • Système de construction Maven ou Gradle pour ajouter la dépendance GroupDocs.Metadata
  • Un fichier .lic valide ou une clé de licence à compte‑à‑rebours provenant de votre compte GroupDocs

Comment définir la licence groupdocs java ?

Chargez le fichier de licence depuis le classpath ou un emplacement externe en utilisant un InputStream. Cette approche fonctionne à la fois dans les environnements web et desktop et élimine les chemins de fichiers codés en dur. En plaçant la licence dans src/main/resources et en invoquant la classe License au démarrage de l’application, vous vous assurez que le SDK est entièrement déverrouillé avant toute opération de métadonnées.

Étape 1 : Ajouter la dépendance Maven

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

Étape 2 : Placer le fichier de licence

Copiez GroupDocs.Metadata.lic dans src/main/resources afin qu’il soit empaqueté avec votre JAR.

Étape 3 : Charger la licence au démarrage de l’application

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 est le point d’entrée pour appliquer une licence GroupDocs.Metadata ; elle lit le XML chiffré et active toutes les capacités premium.

Étape 4 : Vérifier que la licence est active

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

L’exécution de la vérification affiche true, confirmant que la licence est correctement appliquée.

Comment utiliser la licence à compte‑à‑rebours (pay‑per‑use) en Java

La licence à compte‑à‑rebours vous permet de payer en fonction de l’utilisation réelle plutôt que d’un coût fixe initial. La classe Metered gère l’activation en ligne ; chaque appel d’API rapporte l’utilisation à GroupDocs pour la facturation, et vous pouvez interroger les crédits restants programmaticalement. Remplacez l’appel setLicense par Metered.setMeteredKey pour passer à ce modèle :

import com.groupdocs.metadata.metered.Metered;

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

La classe Metered gère l’activation en ligne ; chaque appel d’API rapporte l’utilisation à GroupDocs pour la facturation.

Problèmes courants et solutions

  • Fichier de licence introuvable – Assurez‑vous que le fichier se trouve dans le classpath (src/main/resources) et référez‑le avec une barre oblique initiale (/GroupDocs.Metadata.lic).
  • Erreur de licence invalide – Vérifiez que le fichier .lic correspond à la version du produit que vous utilisez ; régénérez‑le depuis le portail GroupDocs si nécessaire.
  • Clé de licence à compte‑à‑rebours rejetée – Vérifiez à nouveau la chaîne de la clé pour des espaces ou des sauts de ligne supplémentaires ; la clé doit être une seule ligne continue.

Tutoriels disponibles

Comment définir la licence GroupDocs.Metadata en Java en utilisant InputStream

Apprenez à configurer une licence GroupDocs.Metadata en utilisant un InputStream en Java. Débloquez les fonctionnalités avancées de gestion de documents avec ce guide étape par étape.

Ressources supplémentaires

Questions fréquemment posées

Q : Puis‑je utiliser le même fichier de licence pour plusieurs services Java ?
R : Oui, un seul fichier .lic peut être partagé entre un nombre quelconque d’applications Java tant qu’elles fonctionnent sous le même accord de licence.

Q : La licence prend‑elle en charge les déploiements cloud (par ex., AWS, Azure) ?
R : Absolument ; la licence est indépendante de l’environnement. Assurez‑vous simplement que le fichier est accessible au conteneur d’exécution.

Q : Comment passer d’une version d’essai à une licence complète sans interruption ?
R : Déployez le nouveau fichier .lic et redémarrez l’application ; le SDK prend la nouvelle licence lors de la prochaine initialisation.

Q : Que se passe‑t‑il si la clé à compte‑à‑rebours expire ?
R : Les appels d’API commenceront à renvoyer une exception de licence. Rafraîchissez la clé depuis votre compte GroupDocs pour reprendre l’utilisation.

Q : Existe‑t‑il un moyen de vérifier programmaticalement le quota d’utilisation restant ?
R : Oui, appelez Metered.getUsageInfo() pour récupérer la consommation actuelle et les crédits restants.

Dernière mise à jour : 2026-06-07
Testé avec : GroupDocs.Metadata 23.12 pour Java
Auteur : GroupDocs

Tutoriels associés