IronPdfEngineをセットアップする方法

オプション1：ランタイムでIronPdfEngineをダウンロード

デフォルトでは、コアironpdf依存関係を追加した後、IronPDFは最初の実行でホストプラットフォーム（例: Windows x64やLinux x64）を検出し、インターネットから一致するIronPdfEngineバイナリをダウンロードします。

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>

初回ダウンロード後、バイナリはローカルにキャッシュされ、後続の実行はネットワーク呼び出しなしで開始します。

オプション2：依存関係としてIronPdfEngineをバンドル（推奨）

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

必要なIronPdfEngineバージョンをどのように確認しますか？

バージョンの一致は厳密です — IronPDF for Java 2024.2.2はIronPdfEngine 2024.2.2が必要です。 サーバをデプロイする前に必要なバージョンを確認するためにgetIronPdfEngineVersionを使用してください。

:path=/static-assets/ironpdf-java/content-code-examples/get-started/use-ironpdfengine-8.java

// Retrieve the IronPdfEngine version required by this Java library build
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
System.out.println("Required IronPdfEngine version: " + ironPdfEngineVersion);

返されたバージョン文字列に一致するIronPdfEngine Dockerイメージまたはバイナリをデプロイまたはプルします。

リモート接続をどのように設定しますか？

IronPdfEngineが123.456.7.8:33350で実行されているものと仮定します。 任意のIronPDFメソッドを呼び出す前にホストとポートを設定してください。 ベストプラクティスは、PDF操作の前にアプリケーション起動時にこれらの呼び出しを行うことです。

:path=/static-assets/ironpdf-java/content-code-examples/get-started/use-ironpdfengine-9.java

// Configure IronPDF for Java to connect to a remote IronPdfEngine instance
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);

これら2行の実行後、アプリケーション内のすべてのIronPDF呼び出しはリモートサーバーにルートされます。 ローカルのIronPdfEngineサブプロセスは開始されず、pom.xmlにプラットフォーム固有のエンジンの依存関係も必要ありません。

33350が開いていることを確認してください。

完全なリモートセットアップとはどのようなものですか？

以下の例は、リモートIronPdfEngineインスタンスに接続し、HTML文字列をPDFファイルにレンダリングします — ローカルモードで使用されるAPIと同じで、構成のみが異なります。

//:path=Main.java
import com.ironsoftware.ironpdf.*;

public class Main {
    public static void main(String[] args) throws Exception {
        // Point the library to the remote IronPdfEngine server
        Settings.setIronPdfEngineHost("123.456.7.8");
        Settings.setIronPdfEnginePort(33350);

        // Render HTML to PDF — IronPdfEngine on the remote host performs the work
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from remote IronPdfEngine</h1>");
        pdf.saveAs("output.pdf");
    }
}

//:path=Main.java
import com.ironsoftware.ironpdf.*;

public class Main {
    public static void main(String[] args) throws Exception {
        // Point the library to the remote IronPdfEngine server
        Settings.setIronPdfEngineHost("123.456.7.8");
        Settings.setIronPdfEnginePort(33350);

        // Render HTML to PDF — IronPdfEngine on the remote host performs the work
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from remote IronPdfEngine</h1>");
        pdf.saveAs("output.pdf");
    }
}

レンダリングされたPDFはgRPCを介してJavaプロセスに返され、ローカルに保存されます。 リモートサーバーはすべてのChromeベースのレンダリング、フォントの読み込み、およびリソースの解決を処理します。