Appliquer une clé de licence à IronPDF for Java déverrouille toute la capacité de production. Sans clé de licence valide, IronPDF fonctionne en mode d'essai et appose un filigrane sur chaque PDF généré — acceptable pour le développement et l'évaluation, mais pas convenable pour le déploiement en direct. Ce guide présente trois méthodes pour appliquer une clé de licence : dans le code Java au démarrage, via un fichier config.properties, et comment vérifier que la clé est active.

Démarrage rapide : Appliquer une clé de licence IronPDF en Java

Comment obtenir une clé de licence IronPDF ?

IronPDF for Java est gratuit pour évaluer en développement. En mode d'essai, chaque PDF produit comporte un filigrane IronPDF. Pour retirer le filigrane et déployer en production, une clé de licence payante ou d'essai est requise.

Deux options sont disponibles :

Une fois la clé reçue par e-mail, gardez-la disponible pour les étapes ci-dessous. La même clé fonctionne pour les méthodes d'application basées sur le code et sur les fichiers.

Comment ajouter IronPDF en tant que dépendance Java ?

Avant d'appliquer une clé de licence, IronPDF doit être dans le chemin des classes. Il existe deux façons d'y parvenir : le déclarer comme dépendance Maven ou ajouter manuellement le fichier .jar.

Option 1 : Maven (pom.xml)

Ajoutez les deux entrées suivantes au bloc <dependencies> dans votre pom.xml. La première récupère la bibliothèque IronPDF ; la seconde ajoute le logger SLF4J qu'IronPDF utilise en interne.

//:path=pom.xml
<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>
//:path=pom.xml
<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>
XML

Remplacez 20xx.xx.xxxx par la dernière version d'IronPDF for Java. Après avoir économisé pom.xml, exécutez mvn install (ou laissez votre IDE se synchroniser) pour télécharger la dépendance.

Option 2 : JAR manuel

Si Maven ne fait pas partie de la chaîne d'outils de compilation, téléchargez le fichier IronPDF Java .jar et ajoutez-le manuellement au classpath du projet. Cette approche convient aux constructions basées sur Ant ou aux projets qui gèrent les dépendances sans un gestionnaire de packages.

Comment appliquer une clé de licence dans le code Java ?

La méthode la plus directe consiste à appeler License.setLicenseKey() dès le tout début du démarrage de l'application — avant l'exécution de toute opération PDF. Placer l'appel dans la méthode main est l'approche la plus sûre.

//:path=MyApplication.java
import com.ironsoftware.ironpdf.License;

public class MyApplication {
    public static void main(String[] args) {
        // Apply your license key before using any IronPDF feature
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // IronPDF is now fully licensed — no watermarks on output PDFs
        System.out.println("IronPDF license applied.");
    }
}
//:path=MyApplication.java
import com.ironsoftware.ironpdf.License;

public class MyApplication {
    public static void main(String[] args) {
        // Apply your license key before using any IronPDF feature
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // IronPDF is now fully licensed — no watermarks on output PDFs
        System.out.println("IronPDF license applied.");
    }
}
JAVA

Cette approche fonctionne dans tous les types de projets Java : applications autonomes, services Spring Boot, applications Jakarta EE et projets Android. La clé est stockée en mémoire pour la durée de vie du processus JVM ; aucune écriture dans le système de fichiers ne se produit.

Comment appliquer une clé de licence via un fichier de configuration ?

Pour les projets qui séparent la configuration du code — tels que les applications " twelve-factor " ou les déploiements qui font tourner les clés sans redéploiement —, la méthode du fichier config.properties est préférable.

Ajouter une ligne à config.properties :

//:path=config.properties
IRONPDF_LICENSE_KEY=IRONPDF-MYLICENSE-KEY-1EF01

Placez le fichier dans le répertoire de travail de l'application en cours d'exécution ou à la racine du chemin des classes. IronPDF lit automatiquement cette propriété au démarrage. Aucune modification du code n'est requise lorsque la clé change — mettez à jour le fichier et redémarrez le processus.

Comment vérifier que la clé de licence est active ?

Après avoir appliqué une clé par l'une ou l'autre méthode, License.isValidLicense() vérifie si IronPDF la reconnaît comme valide. Ajoutez cette vérification à une routine de démarrage ou à un point de terminaison de vérification de santé.

//:path=LicenseVerification.java
import com.ironsoftware.ironpdf.License;

public class LicenseVerification {
    public static void main(String[] args) {
        String licenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

        // Returns true if the key is valid and the license is active
        boolean isValid = License.isValidLicense(licenseKey);

        if (isValid) {
            System.out.println("License is valid — watermarks are disabled.");
        } else {
            System.out.println("License is invalid or expired. PDFs will include a trial watermark.");
        }
    }
}
//:path=LicenseVerification.java
import com.ironsoftware.ironpdf.License;

public class LicenseVerification {
    public static void main(String[] args) {
        String licenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

        // Returns true if the key is valid and the license is active
        boolean isValid = License.isValidLicense(licenseKey);

        if (isValid) {
            System.out.println("License is valid — watermarks are disabled.");
        } else {
            System.out.println("License is invalid or expired. PDFs will include a trial watermark.");
        }
    }
}
JAVA

License.isValidLicense() renvoie true lorsque le format de la clé est correct, que la licence n'a pas expiré et que la clé correspond au produit. Elle renvoie false pour les clés mal formées, les clés d'essai expirées ou les clés émises pour un autre produit Iron Software. Après tout changement de licence, nettoyez et reconstruisez le projet avant d'exécuter cette vérification pour éviter que des données de classe obsolètes n'affectent le résultat.

IronPDF for Java — Comportement en mode d'essai vs sous licence
Comportement Mode d'essai (pas de clé) Mode sous licence
filigrane PDF Oui — sur chaque page Non
Déploiement en production Nonn autorisé Autorisé
Accès aux fonctionnalités API complète disponible API complète disponible
License.isValidLicense() Retourne false Retourne true

Quelles sont les prochaines étapes?

Avec une clé de licence valide appliquée, IronPDF for Java est prêt pour l'utilisation en production. Les ressources suivantes vous aident à passer de la configuration à la mise en œuvre :

Pour des questions techniques, l'équipe de support IronPDF est disponible via chat en direct et email.

Questions Fréquemment Posées

Que se passe-t-il si j'utilise IronPDF for Java sans clé de licence ?

Sans clé de licence valide, IronPDF fonctionne en mode d'essai et appose un filigrane sur chaque page PDF qu'il génère. Toutes les fonctionnalités de l'API restent accessibles, mais la sortie marquée n'est pas adaptée au déploiement en production.

Comment obtenir une clé de licence IronPDF for Java ?

Achetez une licence sur la page de licence IronPDF Java, ou demandez une clé d'essai gratuite de 30 jours. Les deux options permettent de retirer le filigrane d'essai et d'autoriser l'utilisation en production pour la durée de la licence.

Comment appliquer une clé de licence IronPDF dans le code Java ?

Appelez License.setLicenseKey("YOUR-LICENSE-KEY") au tout début de votre application, avant que toute autre classe ou méthode IronPDF ne soit utilisée. La clé s'applique pour la durée de vie du processus JVM.

Comment appliquer une clé de licence en utilisant un fichier config.properties ?

Ajoutez la ligne IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY à votre fichier config.properties et placez le fichier dans le répertoire de travail de l'application ou à la racine du classpath. IronPDF le lit automatiquement au démarrage.

Que retourne License.isValidLicense() ?

Il retourne true lorsque la clé est correctement formatée, n'a pas expiré, et correspond au produit IronPDF. Il retourne false pour les clés mal formées, les clés d'essai expirées, ou les clés émises pour un autre produit Iron Software.

La méthode de clé de licence diffère-t-elle entre les versions Java et .NET d'IronPDF ?

Oui. En Java, la classe est com.ironsoftware.ironpdf.License et la méthode est License.setLicenseKey(). En .NET, l'équivalent est IronPdf.License.LicenseKey défini en tant que propriété. Le format de la clé est partagé entre les plateformes pour les licences multiplateformes.

Quels types de projets Java le code d'application de licence prend-il en charge ?

L'appel License.setLicenseKey() fonctionne dans les applications Java autonomes, les services Spring Boot, les applications Jakarta EE, les projets Android, et tout autre runtime basé sur JVM.

Dois-je reconstruire mon projet après avoir changé la clé de licence ?

Lors de l'utilisation de la méthode basée sur le code, oui — nettoyez et reconstruisez pour éviter les classes compilées obsolètes. Lors de l'utilisation de config.properties, un redémarrage du processus est suffisant sans une reconstruction complète, ce qui facilite la rotation des clés en production.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Version : 2026.5 just released
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ?
exécuter un échantillon Regardez votre code HTML se transformer en PDF.