Das Anwenden eines Lizenzschlüssels auf IronPDF for Java schaltet die volle Produktionskapazität frei. Ohne einen gültigen Lizenzschlüssel läuft IronPDF im Testmodus und versieht jedes generierte PDF mit einem Wasserzeichen – akzeptabel für Entwicklung und Bewertung, aber nicht geeignet für Live-Bereitstellungen. Dieser Leitfaden führt durch drei Möglichkeiten, einen Lizenzschlüssel anzuwenden: im Java-Code beim Start, über eine config.properties-Datei und wie man überprüft, ob der Schlüssel aktiv ist.
Schnellstart: Anwenden eines IronPDF-Lizenzschlüssels in Java
Wie erhalten Sie einen IronPDF-Lizenzschlüssel?
IronPDF for Java ist kostenlos in der Entwicklung zu evaluieren. Im Testmodus trägt jedes erstellte PDF ein IronPDF-Wasserzeichen. Um das Wasserzeichen zu entfernen und in Produktion zu gehen, ist ein kostenpflichtiger oder Testlizenzschlüssel erforderlich.
Zwei Optionen sind verfügbar:
- Lizenz erwerben — Besuchen Sie die IronPDF Java Lizenzierungsseite, um einen Plan auszuwählen, der Ihren Bereitstellungsanforderungen entspricht.
- Start a free 30-day trial — request a trial license key to evaluate IronPDF without restrictions in a live environment.
Sobald der Schlüssel per E-Mail angekommen ist, bewahren Sie ihn für die untenstehenden Schritte verfügbar auf. Der gleiche Schlüssel funktioniert für Methoden der codebasierten und dateibasierten Anwendung.
Wie fügen Sie IronPDF als Java-Abhängigkeit hinzu?
Bevor Sie einen Lizenzschlüssel anwenden, muss IronPDF im Classpath sein. Es gibt zwei Möglichkeiten, dies zu erreichen: als Maven-Abhängigkeit deklarieren oder die Datei .jar manuell hinzufügen.
Option 1: Maven (pom.xml)
Fügen Sie die folgenden zwei Einträge in den Block <dependencies> in Ihrer Datei pom.xml ein. Der erste zieht die IronPDF-Bibliothek ein; der zweite fügt den SLF4J-Logger hinzu, den IronPDF intern verwendet.
//: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>
Ersetzen Sie 20xx.xx.xxxx durch die neueste Version von IronPDF for Java. Nachdem Sie pom.xml gespeichert haben, führen Sie mvn install aus (oder lassen Sie Ihre IDE synchronisieren), um die Abhängigkeit herunterzuladen.
Option 2: Manuelles JAR
Falls Maven nicht Teil der Build-Toolchain ist, laden Sie die IronPDF Java .jar-Datei herunter und fügen Sie sie manuell zum Klassenpfad des Projekts hinzu. Dieser Ansatz eignet sich für Ant-basierte Builds oder Projekte, die Abhängigkeiten ohne einen Paketmanager verwalten.
Wie wenden Sie einen Lizenzschlüssel im Java-Code an?
Die direkteste Methode ist der Aufruf von License.setLicenseKey() ganz zu Beginn des Programmstarts – bevor irgendeine PDF-Operation ausgeführt wird. Der Aufruf innerhalb der Methode main ist der sicherste Ansatz.
//: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.");
}
}
Dieser Ansatz funktioniert in allen Java-Projekttypen: eigenständige Anwendungen, Spring Boot-Dienste, Jakarta EE-Anwendungen und Android-Projekte. Der Schlüssel wird für die Laufzeit des JVM-Prozesses im Speicher gespeichert; keine Dateisystemschreibvorgänge erfolgen.
Wie wenden Sie einen Lizenzschlüssel durch eine Konfigurationsdatei an?
Für Projekte, bei denen die Konfiguration vom Code getrennt ist – wie beispielsweise Twelve-Factor-Anwendungen oder Bereitstellungen, bei denen Schlüssel ohne erneute Bereitstellung rotiert werden – ist die config.properties-Dateimethodik vorzuziehen.
Fügen Sie eine Zeile zu config.properties hinzu:
//:path=config.properties
IRONPDF_LICENSE_KEY=IRONPDF-MYLICENSE-KEY-1EF01
Platzieren Sie die Datei im Arbeitsverzeichnis der laufenden Anwendung oder am Classpath-Wurzelverzeichnis. IronPDF liest diese Eigenschaft automatisch beim Start aus. Es sind keine Codeänderungen erforderlich, wenn sich der Schlüssel ändert — aktualisieren Sie die Datei und starten Sie den Prozess neu.
Wie überprüfen Sie, ob der Lizenzschlüssel aktiv ist?
Nach dem Anwenden eines Schlüssels mit einer der beiden Methoden bestätigt License.isValidLicense(), ob IronPDF diesen als gültig erkennt. Fügen Sie diesen Check zu einer Startprozedur oder einem Health-Check-Endpunkt hinzu.
//: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() gibt true zurück, wenn das Schlüsselformat korrekt ist, die Lizenz nicht abgelaufen ist und der Schlüssel zum Produkt passt. Bei fehlerhaften Schlüsseln, abgelaufenen Testschlüsseln oder Schlüsseln, die für ein anderes Iron Software-Produkt ausgestellt wurden, wird false zurückgegeben. Nach jeder Lizenzänderung bereinigen und bauen Sie das Projekt neu auf, bevor Sie diesen Check durchführen, um veraltete Klassendaten zu vermeiden, die das Ergebnis beeinflussen könnten.
| Verhalten | Testmodus (kein Schlüssel) | Lizenzierter Modus |
|---|---|---|
| PDF-Wasserzeichen | Ja — auf jeder Seite | Nein |
| Produktionsbereitstellung | Nicht erlaubt | Erlaubt |
| Feature-Zugriff | Vollständige API verfügbar | Vollständige API verfügbar |
| License.isValidLicense() | Gibt false zurück |
Gibt true zurück |
Was sind die nächsten Schritte?
Mit einem gültigen Lizenzschlüssel angewendet, ist IronPDF for Java bereit für den Produktionseinsatz. Die folgenden Ressourcen helfen beim Übergang von der Einrichtung zur Implementierung:
- Erste Schritte mit IronPDF for Java — das offizielle Tutorial zum Einstieg, das HTML-zu-PDF-Rendering, PDF-Lesen und allgemeine Dokumentenoperationen abdeckt.
- IronPDF Java Code-Beispiele — eine Bibliothek von ausführbaren Beispielen für das Erstellen, Bearbeiten, Stempeln, Ausfüllen von Formularen und mehr von PDFs.
- IronPDF Java API Referenz – vollständige Methoden- und Klassendokumentation für das
com.ironsoftware.ironpdf-Paket. - Kaufen oder Upgrade einer Lizenz — skalieren Sie von einer Einzelentwicklerlizenz zu einer Enterprise- oder OEM-Bereitstellung, während das Projekt wächst. Start a free trial if evaluation is still ongoing.
Für technische Fragen steht das IronPDF-Supportteam via Live-Chat und E-Mail zur Verfügung.
Häufig gestellte Fragen
Was passiert, wenn ich IronPDF for Java ohne Lizenzschlüssel verwende?
Ohne einen gültigen Lizenzschlüssel läuft IronPDF im Testmodus und stempelt ein Wasserzeichen auf jede von ihm generierte PDF-Seite. Alle API-Funktionen bleiben zugänglich, aber mit Wasserzeichen versehenes Output ist für den Produktionseinsatz ungeeignet.
Wie erhalte ich einen IronPDF-Lizenzschlüssel for Java?
Erwerben Sie eine Lizenz auf der IronPDF-Java-Lizenzierungsseite oder beantragen Sie einen kostenlosen 30-Tage-Testschlüssel. Beide Optionen entfernen das Test-Wasserzeichen und erlauben die Produktionseinsätze für die Dauer der Lizenz.
Wie wende ich einen IronPDF-Lizenzschlüssel im Java-Code an?
Rufen Sie License.setLicenseKey("YOUR-LICENSE-KEY") ganz am Anfang Ihrer Anwendung auf, bevor eine andere IronPDF-Klasse oder -Methode verwendet wird. Der Schlüssel gilt für die gesamte Dauer des JVM-Prozesses.
Wie wende ich einen Lizenzschlüssel mit einer config.properties-Datei an?
Fügen Sie die Zeile IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY in Ihre config.properties Datei ein und platzieren Sie die Datei im Arbeitsverzeichnis der Anwendung oder im Stamm des Classpath. IronPDF liest sie beim Start automatisch.
Was gibt License.isValidLicense() zurück?
Es gibt true zurück, wenn der Schlüssel korrekt formatiert ist, nicht abgelaufen ist und dem IronPDF-Produkt entspricht. Es gibt false für falsch formatierte Schlüssel, abgelaufene Testschlüssel oder für ein anderes Iron Software-Produkt ausgestellte Schlüssel zurück.
Unterscheidet sich die Lizenzschlüssel-Methode zwischen der Java- und der .NET-Version von IronPDF?
Ja. In Java ist die Klasse com.ironsoftware.ironpdf.License und die Methode ist License.setLicenseKey(). In .NET ist das Äquivalent IronPdf.License.LicenseKey, das als Eigenschaft gesetzt wird. Das Schlüsselformat wird plattformübergreifend für Mehrplattformlizenzen verwendet.
Welche Java-Projekttypen werden von der lizenzierten Anwendung im Code unterstützt?
Der License.setLicenseKey()-Aufruf funktioniert in eigenständigen Java-Anwendungen, Spring Boot-Diensten, Jakarta EE-Anwendungen, Android-Projekten und jeder anderen JVM-basierten Laufzeit.
Muss ich mein Projekt nach dem Ändern des Lizenzschlüssels neu bauen?
Beim Einsatz der codebasierten Methode ja — bereinigen und neu bauen, um alte kompilierte Klassen zu vermeiden. Bei Verwendung von config.properties reicht ein Prozess-Neustart ohne vollständigen Neuaufbau aus, was das Rotieren von Schlüsseln in der Produktion erleichtert.


