在IronPDF for Java中应用许可密钥

如何将IronPDF添加为Java依赖项？

在应用许可证密钥之前，IronPDF必须在类路径上。 实现这一点有两种方法：将其声明为Maven依赖或手动添加.jar文件。

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

如何在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项目类型：独立应用程序、Spring Boot服务、Jakarta EE应用程序和Android项目。 密钥在JVM进程的生命周期中存储在内存中； 不会发生文件系统写入。

如何通过配置文件应用许可证密钥？

对于那些将配置与代码分离的项目——如十二因素应用或在不重新部署情况下轮换密钥的部署——采用config.properties文件方法是较可取的。

添加一行到config.properties：

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

将文件放置在运行应用程序的工作目录中或类路径根目录上。 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.");
        }
    }
}

当密钥格式正确、许可证未过期并且密钥与产品匹配时，true。 对于格式错误的密钥、过期的试用密钥或针对不同Iron Software产品颁发的密钥，它返回false。 任何许可证变更后，都应在运行此检查之前清理并重建项目，以避免过时的类数据影响结果。

下一步是什么？

应用了有效的许可证密钥后，IronPDF for Java即可用于生产。 以下资源有助于从设置到实施：

• 开始使用IronPDF for Java — 官方入门教程，涵盖HTML到PDF渲染、PDF阅读和常见文档操作。
• IronPDF Java代码示例 — 可运行示例库，涵盖PDF创建、编辑、加盖、填表等。
• IronPDF Java API Reference — 提供关于com.ironsoftware.ironpdf包的完整方法和类文档。
• 购买或升级许可证 — 随着项目的成长，从单个开发者许可证扩展到企业或OEM部署。 开始免费试用若评估仍在进行中。

对于技术问题，IronPDF支持团队可通过实时聊天和电子邮件提供支持。