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 :
- Achetez une licence — visitez la page de licence IronPDF Java pour choisir un plan qui correspond à vos besoins de déploiement.
- Start a free 30-day trial — request a trial license key to evaluate IronPDF without restrictions in a live environment.
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>
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.");
}
}
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.");
}
}
}
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.
| 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 :
- Commencez avec IronPDF for Java — le tutoriel officiel pour démarrer couvre le rendu HTML en PDF, la lecture de PDF, et les opérations de documents courantes.
- Exemples de code IronPDF Java — une bibliothèque d'exemples exécutes couvrant la création de PDF, la modification, le tamponnage, le remplissage de formulaires, et plus.
- Référence de l'API Java d'IronPDF — documentation complète des méthodes et des classes du package
com.ironsoftware.ironpdf. - Acheter ou mettre à niveau une licence — étendre d'une licence développeur unique à un déploiement d'entreprise ou OEM au fur et à mesure que le projet grandit. Start a free trial if evaluation is still ongoing.
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.


