1. IronPDF
  2. 始めましょう
  3. IronPdfEngineを使用します

IronPdfEngineの使い方

2024年2月22日
更新済み 2024年10月20日
共有:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngineは、PDFの作成、書き込み、編集、および読み取りを含むさまざまなIronPDF操作を管理するように設計されたgRPCサーバーです。

IronPdfEngineをリモートサーバーとして使用する方法

  1. Javaライブラリをインストールして、IronPdfEngineを利用します
  2. pom.xmlファイルにライブラリを含めます。
  3. setIronPdfEngineHost メソッドを使用してホストを設定します。
  4. setIronPdfEnginePortメソッドを利用してポートを設定する
  5. IronPdfEngineを使用してHTMLをChromeレンダラーと同一の形式でPDFにレンダリングします。

ironpdf.comでのIronPDF for Javaのダウンロードリンク

IronPDF for JavaとIronPdfEngine

IronPdf for Java には IronPdfEngine が必要です。 JavaコードはIronPdfEngine gRPCのAPIマスクです。 したがって、IronPdf for Javaで任意のメソッドを呼び出すと、その魔法はIronPdfEngineの内部で起こります！

デフォルトでは、IronPdf for JavaはIronPdfEngineをサブプロセスとして起動し、アプリケーションがシャットダウンするまでIronPdfEngineと通信します。

次の内容にご注意ください。
IronPDF for Java の各バージョンはIronPdfEngineの特定のバージョンを必要とします。バージョン間の互換性はサポートされていません。

ローカルIronPdfEngineを使用したIronPDF for Java

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

デフォルトでは、JavaプロジェクトにIronPdfをインストールした後、最初の実行時に、IronPdfはプラットフォーム（例：Windows x64）を検出し、インターネットから正しいIronPdfEngineバイナリをダウンロードします。

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>20xx.xx.xx</version>
</dependency>
<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>20xx.xx.xx</version>
</dependency>
XML

長所

  • アプリケーションパッケージは小さくなります。
  • 多くのプラットフォームにデプロイ可能

欠点

  • 初回の実行時にはインターネットアクセスが必要です
  • 起動時間が遅い

オプション2（推奨）IronPdfEngineを依存としてインストールする

IronPDF for Javaでは、依存関係としてIronPdfEngineを追加することができます。 これらのIronPdfEngine依存関係は、IronPdfEngineを.zipファイルにバンドルし、self抽出して自動的に使用します。

以下のIronPdfEngine依存関係の1つまたは複数をインストールすることができます。

次の内容にご注意ください。
ironpdf と ironpdf-engine-xxx-xxx の依存関係バージョンは同じでなければなりません。

ironpdf-engine-xxx-xxx 依存バージョンは、内部のIronPdfEngineのバージョンを指しているわけではありません。)]

Windows x64用

 <dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
 <dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Windows x86用

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

Linux x64 用

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

macOS x64 用

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

macOS arm用

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

[{i:(それぞれの依存関係はかなり大きいので、すべてをインストールすることはお勧めできません。

長所

  • 起動時間の短縮。
  • 依存関係をインストールした後は、インターネットにアクセスする必要はありません。

欠点

  • あなたのアプリケーションパッケージは大きくなります。
  • 対象プラットフォームを指定する必要があります。

リモートIronPdfEngineを使用したIronPDF for Java

リモートのIronPdfEngineを使用するには、IronPdfEngineの特定のバージョンが必要です。 例えば、IronPDF for Java バージョン 2024.2.2 が IronPdfEngine バージョン 2024.2.2 を必要とする場合、IronPdfEngine バージョン 2024.2.1 を使用しないでください。必要なバージョンを確認するには、getIronPdfEngineVersion メソッドを使用します。

String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

接続方法

IronPdfEngineがリモートで123.456.7.8:33350で稼働していると仮定します。

IronPdfEngineの取得および実行方法の手順を参照

IronPdfにIronPdfEngineの場所を教えるだけです（そのアドレスにアクセス可能であり、ファイアウォールによってブロックされていないことを確認してください）。 このコードをアプリケーションの初期段階で追加してください（または、任意のIronPDFメソッドを呼び出す直前）。

com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
JAVA

それだけです！ その後、あなたのアプリケーションはリモートIronPdfEngineに接続されます！

リモートIronPdfEngineの場合、依存関係としてIronPdfEngineをインストールする必要はありません。 「オプション2（推奨）：IronPdfEngineを依存関係としてインストール」というタイトルのセクションをスキップしてください。