Zastosowanie klucza licencyjnego do IronPDF for Java odblokowuje pełne możliwości produkcyjne. Bez ważnego klucza licencyjnego IronPDF działa w trybie próbnym i stempluje każdy wygenerowany PDF znak wodny — dopuszczalny dla rozwoju i oceny, ale nieodpowiedni do wdrożeń produkcyjnych. W niniejszym przewodniku omówiono trzy sposoby stosowania klucza licencyjnego: w kodzie Java podczas uruchamiania, za pośrednictwem pliku config.properties oraz sposób weryfikacji, czy klucz jest aktywny.
Szybki start: Zastosuj klucz licencyjny IronPDF w Java
Jak uzyskać klucz licencyjny IronPDF?
IronPDF for Java jest bezpłatny do oceny w rozwoju. W trybie próbnym każdy wygenerowany PDF nosi znak wodny IronPDF. Aby usunąć znak wodny i wdrożyć w produkcji, wymagany jest płatny lub próbny klucz licencyjny.
Dostępne są dwie opcje:
Kup licencję — odwiedź stronę licencjonowania IronPDF Java, aby wybrać plan, który odpowiada twoim potrzebom wdrożeniowym.
- Start a free 30-day trial — request a trial license key to evaluate IronPDF without restrictions in a live environment.
Gdy klucz dotrze e-mailem, trzymaj go dostępnego do poniższych kroków. Ten sam klucz działa zarówno dla metod aplikacji opartych na kodzie, jak i plikach.
Jak dodać IronPDF jako zależność Java?
Przed zastosowaniem klucza licencyjnego IronPDF musi być na ścieżce klas. Można to osiągnąć na dwa sposoby: zadeklarować to jako zależność Maven lub ręcznie dodać plik .jar.
Opcja 1: Maven (pom.xml)
Dodaj następujące dwa wpisy do bloku <dependencies> w pliku pom.xml. Pierwszy pobiera bibliotekę IronPDF; drugi dodaje logger SLF4J, który IronPDF używa wewnętrznie.
//:path=pom.xml
<dependencies>
## Jak zastosować klucz licencyjny poprzez plik konfiguracyjny?
W przypadku projektów, w których konfiguracja jest oddzielona od kodu — takich jak aplikacje dwunastu czynników lub wdrożenia, które zmieniają klucze bez ponownego wdrażania — preferowana jest metoda pliku `config.properties`.
Dodaj jedną linię do `config.properties`:
```properties
//:path=config.properties
IRONPDF_LICENSE_KEY=IRONPDF-MYLICENSE-KEY-1EF01
//:path=pom.xml
<dependencies>
## Jak zastosować klucz licencyjny poprzez plik konfiguracyjny?
W przypadku projektów, w których konfiguracja jest oddzielona od kodu — takich jak aplikacje dwunastu czynników lub wdrożenia, które zmieniają klucze bez ponownego wdrażania — preferowana jest metoda pliku `config.properties`.
Dodaj jedną linię do `config.properties`:
```properties
//:path=config.properties
IRONPDF_LICENSE_KEY=IRONPDF-MYLICENSE-KEY-1EF01
Umieść plik w katalogu roboczym uruchamianej aplikacji lub w katalogu głównym ścieżki klas. IronPDF czyta tę właściwość automatycznie podczas uruchamiania. Nie są wymagane zmiany w kodzie, gdy klucz się zmienia — zaktualizuj plik i uruchom ponownie proces.
Jak zweryfikować, że klucz licencyjny jest aktywny?
Po zastosowaniu klucza za pomocą jednej z metod, License.isValidLicense() potwierdza, czy IronPDF rozpoznaje go jako prawidłowy. Dodaj to sprawdzenie do rutyny startowej lub punktu kontrolnego zdrowia.
//: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() zwraca true, gdy format klucza jest poprawny, licencja nie wygasła, a klucz pasuje do produktu. Zwraca false w przypadku nieprawidłowych kluczy, wygasłych kluczy próbnych lub kluczy wydanych dla innego produktu Iron Software. Po każdej zmianie licencji, wyczyść i zbuduj ponownie projekt przed uruchomieniem tego testu, aby uniknąć wpływu przestarzałych danych klasy na wynik.
| Zachowanie | Tryb próbny (bez klucza) | Tryb licencjonowany |
|---|---|---|
| Znak wodny w pliku PDF | Tak — na każdej stronie | Nie |
| Wdrożenie produkcyjne | Niedozwolone | Dozwolone |
| Dostęp do funkcji | Całe API dostępne | Całe API dostępne |
| License.isValidLicense() | Zwraca false |
Zwraca true |
Jakie są kolejne kroki?
Z ważnym zastosowanym kluczem licencyjnym, IronPDF for Java jest gotowy do użycia produkcyjnego. Następujące zasoby pomagają przejść od konfiguracji do implementacji:
- Rozpocznij pracę z IronPDF for Java — oficjalny samouczek dla początkujących obejmujący renderowanie HTML-na-PDF, czytanie PDF i powszechne operacje na dokumentach.
- Przykłady kodu IronPDF Java — biblioteka uruchamialnych przykładów obejmujących tworzenie PDF, edycję, stemplowanie, wypełnianie formularzy i więcej.
- Dokumentacja API IronPDF for Java — pełna dokumentacja metod i klas dla pakietu
com.ironsoftware.ironpdf. - Kup lub uaktualnij licencję — rozwiń się od licencji dla jednego dewelopera do wdrożenia Enterprise lub OEM w miarę rozwoju projektu. Start a free trial if evaluation is still ongoing.
Dla pytań technicznych zespół wsparcia IronPDF jest dostępny poprzez czat na żywo i e-mail.
Często Zadawane Pytania
Co się stanie, jeśli użyję IronPDF for Java bez klucza licencyjnego?
Bez ważnego klucza licencyjnego, IronPDF działa w trybie próbnym i dodaje znaku wodnego na każdej generowanej stronie PDF. Wszystkie funkcje API pozostają dostępne, ale wyjście z znakiem wodnym nie nadaje się do wdrożeń produkcyjnych.
Jak uzyskać klucz licencyjny IronPDF dla Java?
Zakup licencję na stronie licencjonowania IronPDF Java lub złóż wniosek o darmowy 30-dniowy klucz próbny. Obie opcje usuwają znak wodny próbny i pozwalają na użycie produkcyjne przez czas trwania licencji.
Jak zastosować klucz licencyjny IronPDF w kodzie Java?
Wywołaj License.setLicenseKey("YOUR-LICENSE-KEY") na samym początku swojej aplikacji, przed użyciem jakiejkolwiek innej klasy lub metody IronPDF. Klucz obowiązuje przez cały czas trwania procesu JVM.
Jak zastosować klucz licencyjny przy użyciu pliku config.properties?
Dodaj linie IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY do pliku config.properties i umieść plik w katalogu roboczym aplikacji lub w katalogu classpath. IronPDF automatycznie go odczytuje podczas uruchamiania.
Co zwraca License.isValidLicense()?
Zwraca true, gdy klucz jest poprawnie sformatowany, nie wygasł i pasuje do produktu IronPDF. Zwraca false dla nieprawidłowy formatów kluczy, wygasłych kluczy próbnych lub kluczy wydanych dla innego produktu Iron Software.
Czy metoda klucza licencyjnego różni się między wersjami Java a .NET IronPDF?
Tak. W Java klasa to com.ironsoftware.ironpdf.License a metoda to License.setLicenseKey(). W .NET równoważna właściwość to IronPdf.License.LicenseKey. Format klucza jest wspólny dla platform, co umożliwia licencje wieloplatformowe.
Jakie typy projektów Java obsługuje aplikacja licencyjna oparta na kodzie?
Wywołanie License.setLicenseKey() działa w samodzielnych aplikacjach Java, usługach Spring Boot, aplikacjach Jakarta EE, projektach Android i wszelkich innych środowiskach opartych na JVM.
Czy muszę ponownie skompilować mój projekt po zmianie klucza licencyjnego?
Kiedy używasz metody opartej na kodzie, tak — oczyść i ponownie zbuduj, aby uniknąć przestarzałych skompilowanych klas. Kiedy używasz config.properties, wystarczy restart procesu bez pełnego przebudowywania, co ułatwia rotację kluczy w produkcji.


