如何将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代码中应用许可证密钥？

最直接的方法是在应用程序启动之初——即在执行任何 PDF 操作之前——调用 License.setLicenseKey()。 在 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.");
        }
    }
}

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

下一步是什么？

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

• 开始使用IronPDF for Java — 官方入门教程，涵盖HTML到PDF渲染、PDF阅读和常见文档操作。
• IronPDF Java代码示例 — 可运行示例库，涵盖PDF创建、编辑、加盖、填表等。
• IronPDF Java API 参考 — com.ironsoftware.ironpdf 包的完整方法和类文档。
• 购买或升级许可证 — 随着项目的成长，从单个开发者许可证扩展到企业或OEM部署。 Start a free trial if evaluation is still ongoing.

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