在IronPDF for Java中套用授權金鑰

This article was translated from English: Does it need improvement?
Translated
View the article in English

將授權金鑰套用至IronPDF for Java可以解鎖完整的生產能力。 沒有有效的授權金鑰,IronPDF會以試用模式運行,並在每個生成的PDF上標記浮水印——這在開發和評估中可接受,但不適合實時部署。 本指南介紹三種套用授權金鑰的方法:在Java程式碼中啟動、通過config.properties檔案,以及如何確認金鑰處於啟用狀態。

快速入門:在Java中套用IronPDF授權金鑰

您如何取得IronPDF授權金鑰?

IronPDF for Java在開發中免費評估。 在試用模式下,每個製作的PDF都帶有IronPDF浮水印。 要移除浮水印並部署至生產環境,需要付費或試用授權金鑰。

有兩個選項可用:

一旦授權金鑰通過電子郵件送達,請將其保留以便後續步驟使用。 相同的金鑰可用於基於程式碼和基於文件的應用方法。

您如何將IronPDF新增為Java依賴項?

在套用授權金鑰之前,IronPDF必須位於classpath上。 有兩種方法可以達成此目標:將其聲明為Maven依賴項或手動新增.jar檔案。

選項1:Maven (pom.xml)

將以下兩項目新增到您的<dependencies>區塊中。 第一項拉入IronPDF程式庫; 第二項新增IronPDF內部使用的SLF4J記錄器。

//: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

最新的IronPDF for Java版本替換20xx.xx.xxxx。 保存mvn install(或讓您的IDE同步)以下載依賴項。

選項2:手動JAR

如果Maven不是構建工具鏈的一部分,下載IronPDF Java .jar檔案並將其手動新增到專案的classpath。 此方法適合基於Ant的构建或不使用包管理器管理依賴項的專案。

您如何在Java程式碼中套用授權金鑰?

最直接的方法是,在應用程式啟動的最開始調用License.setLicenseKey() — 在進行任何PDF操作之前。 在main方法中放置該調用是最安全的方法。

//: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

此方法適用於所有Java專案型別:獨立應用程式、Spring Boot服務、Jakarta EE應用和Android專案。 金鑰會在JVM過程的生命週期中儲存在記憶體中; 不會進行檔案系統寫入。

您如何通過配置檔案套用授權金鑰?

對於將配置與程式碼分隔的專案 — 例如十二因素應用程式或在不重新部署的情況下旋轉金鑰的部屬 — 使用config.properties檔案的方法較佳。

config.properties中新增一行:

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

將檔案放置在正在運行的應用程式的工作目錄中或classpath根目錄中。 IronPDF在啟動時自動讀取此屬性。當金鑰更改時,不需要程式碼更改——更新文件並重新啟動過程即可。

您如何驗證授權金鑰處於活動狀態?

通過任何方法套用金鑰後,License.isValidLicense()確認IronPDF是否將其識別為有效。 將此檢查新增到啟動例程或健康檢查端點。

//: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

當金鑰格式正確、授權尚未到期且金鑰與產品匹配時,true。 對於格式不正確的金鑰、已到期的試用金鑰或為不同Iron Software產品發行的金鑰,將返回false。 在任何授權更改後,需清理並重建專案再執行此檢查,以免陳舊的類資料影響結果。

IronPDF for Java — 試用與授權行為
行為 試用模式(無金鑰) 授權模式
PDF浮水印 是 — 每頁
生產部署 不允許 允許
功能存取 完整API可用 完整API可用
License.isValidLicense() 返回false 返回true

接下來的步驟是什麼?

套用有效授權金鑰後,IronPDF for Java即可投入生產使用。 以下資源有助於從設置到實施:

如有技術問題,IronPDF支援團隊可以通過即時聊天和電子郵件提供協助。

常見問題

如果我在沒有授權金鑰的情況下使用IronPDF for Java會怎樣?

如果沒有有效的授權金鑰,IronPDF會在試用模式下運行,並在每個生成的PDF頁面上加上浮水印。所有API功能仍然可用,但帶浮水印的輸出不適合生產部署。

我如何獲得Java的IronPDF授權金鑰?

在IronPDF Java授權頁面購買授權,或申請免費30天試用金鑰。這兩種選擇都可移除試用浮水印,並允許在授權期間內進行生產使用。

我如何在Java程式碼中套用IronPDF授權金鑰?

在應用的最開始使用License.setLicenseKey("YOUR-LICENSE-KEY"),在使用任何其他IronPDF類別或方法之前。金鑰在JVM進程的生命周期內生效。

我如何使用config.properties檔案套用授權金鑰?

IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY加入您的config.properties檔案,並將檔案放置在應用工作目錄或classpath根目錄。IronPDF在啟動時自動讀取。

License.isValidLicense()返回什麼?

當金鑰格式正確、未過期並匹配IronPDF產品時,返回true。對於格式不正確的金鑰、過期的試用金鑰或為不同Iron Software產品發行的金鑰,返回false

Java和.NET版本的IronPDF中的授權金鑰方法是否不同?

是的。在Java中,類別是com.ironsoftware.ironpdf.License,方法是License.setLicenseKey()。在.NET中,等效的設置為IronPdf.License.LicenseKey屬性。金鑰格式在各平台之間共享,以支持多平台授權。

哪些Java專案型別支持基於程式碼的授權金鑰應用?

License.setLicenseKey()呼叫可在獨立Java應用、Spring Boot服務、Jakarta EE應用、Android專案及其他任何基於JVM的運行環境中工作。

更改授權金鑰後是否需要重建專案?

使用基於程式碼的方法時,需要——清理並重建以避免陳舊的編譯類。使用config.properties時,重啟進程即可,而無需完全重建,這使得在生產中旋轉金鑰更加簡單。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

準備好開始了嗎?
版本: 2026.6 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想要快速證明嗎?
運行範例 觀看您的HTML變成PDF。