1. IronPDF
  2. Commencer
  3. Utilisez IronPDFEngine

Curtis Chau
Curtis Chau
Mis à jour:

IronPdfEngine est un serveur gRPC qui effectue chaque opération PDF — création, modification, lecture et rendu. La bibliothèque IronPDF for Java est un wrapper d'API autour de ce serveur : lorsque votre code Java appelle n'importe quelle méthode IronPDF, IronPdfEngine exécute le travail. Par défaut, IronPDF for Java lance IronPdfEngine en tant que sous-processus local et gère automatiquement son cycle de vie. Pour des déploiements plus avancés — microservices partagés, conteneurs Docker, ou réseaux isolés — vous pouvez exécuter IronPdfEngine en tant que serveur distant autonome à la place.

Démarrage rapide : Configurer IronPdfEngine for Java

Comment configurer IronPdfEngine for Java

  1. Ajoutez la dépendance IronPDF à votre fichier pom.xml
  2. Choisissez un mode local : téléchargement à l'exécution ou dépendance intégrée
  3. Pour le mode distant, utilisez setIronPdfEngineHost pour configurer l'adresse de l'hôte
  4. Pour le mode distant, utilisez setIronPdfEnginePort pour configurer le port
  5. Appelez toute méthode de rendu IronPDF — IronPdfEngine gère le travail PDF

Veuillez noterChaque version de IronPDF for Java nécessite une version correspondante de IronPdfEngine. La compatibilité entre versions n'est pas supportée. Utilisez Settings.getIronPdfEngineVersion() pour confirmer la version requise.

Quel mode de déploiement devez-vous utiliser ?

IronPdfEngine prend en charge deux approches de déploiement : local et distant. Le choix entre ces deux modes dépend de l'architecture de votre application.

Mode local (par défaut) est le bon choix pour les applications autonomes, les outils de bureau et les déploiements sur un seul serveur. IronPDF for Java démarre automatiquement IronPdfEngine en tant que sous-processus — aucune infrastructure distincte n'est nécessaire. En mode local, il y a deux options pour obtenir les binaires IronPdfEngine : les télécharger lors du premier démarrage ou les intégrer comme une dépendance Maven.

Mode distant convient aux systèmes distribués où une seule instance IronPdfEngine sert plusieurs nœuds d'application. C'est également l'approche privilégiée pour les déploiements basés sur Docker, les pods Kubernetes, les réseaux isolés qui ne peuvent pas télécharger des binaires à l'exécution, et tout scénario où la centralisation du traitement PDF réduit la surcharge par service.

Les sections ci-dessous couvrent les deux modes en détail.

Comment configurez-vous IronPdfEngine localement ?

Deux options existent pour exécuter IronPdfEngine localement. Les deux produisent le même comportement d'exécution — la différence est quand et comment le binaire de l'engin arrive sur la machine cible.

Option 1 : Télécharger IronPdfEngine à l'exécution

Par défaut, après l'ajout de la dépendance principale ironpdf, IronPDF détecte la plateforme hôte (par exemple, Windows x64 ou Linux x64) lors de la première exécution et télécharge le binaire IronPdfEngine correspondant depuis Internet.

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

Après le téléchargement initial, le binaire est mis en cache localement et les exécutions suivantes commencent sans appel réseau.

Option 1 — Téléchargement à l'exécution : Compromis
AvantageLimitation
La taille du paquet d'application la plus petite Accès internet requis lors du premier démarrage
Prend en charge plusieurs plateformes cibles à partir d'un seul artefact Démarrage plus lent lors du premier démarrage tant que le binaire se télécharge

Option 2 : Intégrer IronPdfEngine comme une dépendance (Recommandé)

IronPDF Java fournit des artefacts Maven spécifiques à la plateforme qui intègrent IronPdfEngine sous la forme d'un fichier .zip au sein de la dépendance. La bibliothèque l'extrait et l'utilise automatiquement — aucun appel réseau n'est nécessaire à l'exécution.

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

Ajoutez ensuite l'artefact de plateforme pour votre environnement cible. Installez uniquement l'artefact pour votre plateforme cible — chacun est volumineux, et les installer tous gonfle inutilement la construction.

Windows x64

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

Windows x86

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

Linux x64

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

macOS x64

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

macOS ARM (Apple Silicon)

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

Veuillez noterLes versions des dépendances ironpdf et ironpdf-engine-xxx-xxx doivent correspondre exactement. La chaîne de version se réfère à la version de publication IronPDF for Java, pas au numéro de version interne de IronPdfEngine.

Option 2 — Dépendance intégrée : Compromis
AvantageLimitation
Démarrage plus rapide — pas d'étape de téléchargement Paquet d'application plus volumineux
Aucun accès internet requis après l'installation Doit spécifier la plateforme cible explicitement
Comportement cohérent dans des environnements isolés Installer plusieurs artefacts de plateforme augmente considérablement la taille de la construction

Comment vous connectez-vous à un IronPdfEngine distant ?

Le mode distant permet à plusieurs instances d'application de partager un seul serveur IronPdfEngine via gRPC. C'est courant dans les architectures de microservices, les déploiements conteneurisés, et les environnements où le traitement PDF est centralisé.

Comment vérifiez-vous la version requise d'IronPdfEngine ?

La correspondance des versions est stricte — IronPDF for Java 2024.2.2 nécessite exactement IronPdfEngine 2024.2.2. Utilisez getIronPdfEngineVersion pour vérifier la version requise avant de déployer le serveur :

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

Déployez ou extrayez l'image Docker ou le binaire IronPdfEngine correspondant à la chaîne de version retournée.

Comment configurez-vous la connexion distante ?

Supposons qu'IronPdfEngine s'exécute à 123.456.7.8:33350. Définissez l'hôte et le port avant d'appeler toute méthode IronPDF. La meilleure pratique est de placer ces appels au démarrage de l'application, avant toute opération PDF :

//:path=Main.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);
//:path=Main.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);
JAVA

Après l'exécution de ces deux lignes, tous les appels IronPDF suivants dans votre application sont dirigés vers le serveur distant. Aucun sous-processus local IronPdfEngine n'est lancé, et aucune dépendance de moteur spécifique à la plateforme n'est requise dans votre pom.xml.

ConseilsAssurez-vous que l'adresse hôte d'IronPdfEngine est accessible depuis votre serveur d'applications et que le port 33350 est ouvert dans tous les pare-feu ou groupes de sécurité entre les deux.

À quoi ressemble une configuration distante complète ?

L'exemple suivant se connecte à une instance distante de IronPdfEngine et rend une chaîne HTML en un fichier PDF — la même API utilisée en mode local, avec seulement la configuration différente :

//: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");
    }
}
JAVA

Le PDF généré est renvoyé au processus Java via gRPC et enregistré localement. Le serveur distant gère tout le rendu basé sur Chrome, le chargement des polices et la résolution des ressources.

Quelles sont les prochaines étapes?

Avec IronPdfEngine configuré, l'ensemble complet des fonctionnalités IronPDF for Java est disponible — HTML vers PDF, édition PDF, fusion, estampillage, et plus encore.

Questions Fréquemment Posées

Qu'est-ce que IronPdfEngine et pourquoi IronPDF for Java en a-t-il besoin ?

IronPdfEngine est un serveur gRPC qui exécute toutes les opérations PDF — création, édition, lecture, et rendu. IronPDF for Java est un API wrapper autour de ce serveur, donc chaque appel de méthode Java est traité par IronPdfEngine. Sans lui, la bibliothèque Java ne peut effectuer aucun travail PDF.

Quelle est la différence entre IronPdfEngine local et distant ?

Le mode local démarre IronPdfEngine comme sous-processus sur la même machine que votre application Java — pas d'infrastructure supplémentaire requise. Le mode distant se connecte à un serveur IronPdfEngine autonome via gRPC, qui convient aux microservices, déploiements Docker, et nœuds de traitement PDF partagés.

Quand dois-je utiliser IronPdfEngine distant au lieu du local ?

Utilisez IronPdfEngine distant lorsque vous avez besoin que plusieurs instances d'application partagent un serveur de traitement PDF, lors du déploiement dans des environnements Kubernetes ou Docker Compose, ou lors de l'exécution dans des réseaux isolés qui ne peuvent pas télécharger des binaires au runtime.

Comment configurer une connexion à IronPdfEngine distant en Java ?

Appelez Settings.setIronPdfEngineHost() avec l'IP ou le nom d'hôte du serveur et Settings.setIronPdfEnginePort() avec le numéro de port au démarrage de l'application, avant d'invoquer toute méthode IronPDF. Le port par défaut de IronPdfEngine est 33350.

Quel artifact Maven dois-je utiliser pour inclure IronPdfEngine en tant que dépendance ?

Ajoutez l'artifact spécifique à la plateforme correspondant à votre cible de déploiement — par exemple, ironpdf-engine-linux-x64 pour les serveurs Linux ou ironpdf-engine-windows-x64 pour Windows. La version de l'artifact doit correspondre exactement à la version de la dépendance ironpdf principale.

Comment vérifier quelle version de IronPdfEngine ma bibliothèque Java nécessite-t-elle ?

Appelez Settings.getIronPdfEngineVersion() dans votre code Java. Il retourne la chaîne de version exacte qui doit correspondre au binaire IronPdfEngine ou à l'image Docker que vous déployez.

Puis-je installer plusieurs dépendances de moteurs pour différentes plateformes dans un même projet ?

Techniquement oui, mais chaque artifact est volumineux et en installer plus d'un augmente inutilement la taille de votre build. Installez uniquement l'artifact correspondant à votre plateforme de déploiement cible.

Ai-je besoin d'une connexion Internet pour utiliser IronPDF for Java ?

Seulement si vous utilisez l'option de téléchargement en temps réel (aucune dépendance spécifique à la plateforme dans pom.xml). Lors de la première exécution, IronPDF télécharge le binaire IronPdfEngine pour votre plateforme. Après ce téléchargement, aucun accès internet n'est requis. Si vous ajoutez la dépendance de la plateforme intégrée ou utilisez le mode distant, aucun accès internet n'est nécessaire à tout moment.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Version : 2026.5 just released
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ?
exécuter un échantillon Regardez votre code HTML se transformer en PDF.