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.

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
XML

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.");
        }
    }
}
JAVA

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.

IronPDF for Java — Tryb próbny vs. Zachowanie licencjonowane
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:

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.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.