1. IronPDF
  2. Commencer
  3. Utilisez IronPdfEngine

How to Use IronPdfEngine

Curtis Chau
Curtis Chau
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine est un serveur gRPC conçu pour gérer diverses opérations IronPDF, notamment la création, l'écriture, l'édition et la lecture de PDF.

Comment utiliser IronPdfEngine comme serveur distant

  1. Installer la bibliothèque Java pour utiliser IronPdfEngine
  2. Inclure la bibliothèque dans le fichier pom.xml
  3. Utilisez la méthode `setIronPdfEngineHost` pour configurer l'hôte
  4. Utilisez la méthode `setIronPdfEnginePort` pour configurer le port
  5. Utilisez l'IronPdfEngine pour rendre HTML en PDF avec un moteur de rendu identique à celui de Chrome

Lien pour télécharger IronPDF pour Java sur ironpdf.com

IronPdf pour Java et IronPdfEngine

IronPDF for Java requiert IronPdfEngine pour fonctionner. Le code Java sert de masque d'API sur IronPdfEngine gRPC. Lorsque vous invoquez une méthode dans IronPDF for Java, le traitement réel se produit à l'intérieur d'IronPdfEngine !

Par défaut, IronPdf for Java lancera IronPdfEngine en tant que sous-processus et interagira avec lui jusqu'à ce que votre application se ferme.

[{i :(Chaque version d'IronPDF for Java nécessite une version spécifique d'IronPdfEngine. La compatibilité entre les versions n'est pas prise en charge.)}]

IronPdf pour Java avec IronPdfEngine local

Option 1 : Télécharger IronPdfEngine au moment de l'exécution

Par défaut, après avoir installé IronPDF dans votre projet Java, lors de la première exécution, IronPdf détectera votre plateforme (par exemple, Windows x64) et téléchargera les binaires IronPdfEngine appropriés depuis internet.

<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

Avantages

  • Votre dossier de candidature sera peu volumineux.
  • Peut être déployé sur de nombreuses plateformes.

Cons

  • Un accès à Internet est nécessaire pour les premiers tirages.
  • Temps de démarrage lent.

Option 2 (recommandée) : Installer IronPdfEngine en tant que dépendance

IronPdf Java vous permet d'ajouter directement IronPdfEngine en tant que dépendance. Ces dépendances enveloppent IronPdfEngine dans un fichier .zip, ce qui permet de l'extraire et de l'utiliser automatiquement.

Vous pouvez choisir d'installer une ou plusieurs de ces dépendances d'IronPdfEngine.

[{i :(ironpdf et ironpdf-engine-xxx-xxx la version de la dépendance doit être la même. ironpdf-engine-xxx-xxx ne fait pas référence à la version interne d'IronPdfEngine.)}]

Pour 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

Pour 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

Pour 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

Pour 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

Pour 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 :(Chaque dépendance est assez importante, il n'est donc pas conseillé de les installer toutes.)]]

Avantages

  • Temps de démarrage plus rapide.
  • L'accès à Internet n'est pas nécessaire après l'installation de la dépendance.

Cons

  • Votre dossier de candidature sera volumineux.
  • Nécessité de préciser les plateformes cibles.

IronPdf pour Java avec IronPdfEngine à distance

Pour utiliser un IronPdfEngine à distance, une version spécifique est nécessaire. Par exemple, si IronPdf for Java version 2024.2.2 nécessite IronPdfEngine version 2024.2.2, n'utilisez pas la version 2024.2.1. Utilisez la méthode getIronPdfEngineVersion pour vérifier la version requise.

// Get the version of the IronPdfEngine needed for the current Java version
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
// Get the version of the IronPdfEngine needed for the current Java version
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

Comment se connecter

Supposons qu'IronPdfEngine s'exécute à distance à 123.456.7.8:33350.

Référer aux instructions sur la façon de tirer et d'exécuter IronPdfEngine

Pour vous connecter, indiquez l'emplacement d'IronPdfEngine (assurez-vous que l'adresse est accessible et qu'elle n'est pas bloquée par des pare-feu). Ajoutez ce code lors de la phase initiale de votre application (ou juste avant d'invoquer une méthode IronPDF).

// Set the host and port for a remote IronPdfEngine connection
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
// Set the host and port for a remote IronPdfEngine connection
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
JAVA

C'est aussi simple que cela ! Après avoir exécuté ce code, votre application se connecte au serveur distant IronPdfEngine !

Dans le cas d'IronPdfEngine à distance, l'installation d'IronPdfEngine en tant que dépendance n'est pas nécessaire. Vous pouvez sauter la section intitulée "Option 2 (recommandée) : Installer IronPdfEngine en tant que dépendance."

Questions Fréquemment Posées

Qu'est-ce que IronPdfEngine et comment est-il lié aux opérations PDF en Java?

IronPdfEngine est un serveur gRPC qui gère les opérations PDF comme la création, la modification et la lecture. En Java, il fonctionne comme le backend pour IronPDF, qui sert de masque d'API sur IronPdfEngine.

Comment puis-je rendre du HTML en PDF en Java en utilisant IronPdfEngine?

Vous pouvez utiliser la bibliothèque IronPDF en Java pour rendre du HTML en PDF. Le processus implique de configurer IronPdfEngine et d'utiliser ses méthodes, telles que RenderHtmlAsPdf, pour convertir le contenu HTML en format PDF.

Pourquoi les opérations PDF en Java nécessitent-elles une compatibilité de version avec IronPdfEngine?

La compatibilité des versions est cruciale car chaque version d'IronPDF pour Java est conçue pour fonctionner avec une version spécifique de IronPdfEngine, garantissant des opérations transparentes et évitant les problèmes de compatibilité.

Quels sont les avantages d'utiliser IronPdfEngine localement dans les projets Java?

Utiliser IronPdfEngine localement peut conduire à des temps de démarrage plus rapides et éliminer le besoin d'accès à Internet après l'installation. Cela permet un traitement PDF plus efficace directement au sein de l'application Java.

Comment configurer IronPdfEngine pour une utilisation sur un serveur distant en Java?

Pour configurer IronPdfEngine pour un usage distant, définissez l'hôte et le port du serveur en utilisant les méthodes setIronPdfEngineHost et setIronPdfEnginePort dans votre application Java, en veillant à ce que le serveur soit accessible.

Que devrais-je considérer en décidant de télécharger les fichiers binaires de IronPdfEngine à l'exécution?

Le téléchargement des fichiers binaires à l'exécution résulte en un package d'application plus léger et une flexibilité de déploiement multiplateforme. Cependant, cela nécessite un accès Internet initialement et peut entraîner des temps de démarrage plus lents.

IronPdfEngine peut-il être utilisé sans l'installer comme une dépendance?

Oui, IronPdfEngine peut être utilisé sans installation comme une dépendance en téléchargeant les fichiers binaires nécessaires à l'exécution. Cette approche est adaptée aux environnements dynamiques où la taille de l'application est une préoccupation.

Comment puis-je m'assurer que ma bibliothèque Java PDF utilise la bonne version d'IronPdfEngine?

Vous pouvez vérifier la version de IronPdfEngine requise pour votre bibliothèque Java PDF en utilisant la méthode getIronPdfEngineVersion, garantissant la compatibilité et le bon fonctionnement.

Quelles sont les étapes pour installer IronPdfEngine dans un projet Java?

Pour installer IronPdfEngine, incluez la bibliothèque Java IronPDF dans votre projet, configurez l'hôte et le port du serveur, et connectez-vous à IronPdfEngine en utilisant les paramètres appropriés dans le code de votre application.

Est-il nécessaire d'avoir un accès Internet lors de l'utilisation d'IronPdfEngine en Java?

Un accès à Internet est nécessaire lorsque vous choisissez de télécharger les fichiers binaires de IronPdfEngine à l'exécution. Cependant, si IronPdfEngine est installé en tant que dépendance, l'accès à Internet n'est pas requis après la configuration initiale.

IronPDF est-il compatible avec .NET 10 et quels avantages cela apporte-t-il ?

Oui. IronPDF prend en charge .NET 10 sans aucune manipulation complexe, offrant ainsi des performances améliorées, une meilleure stabilité d'exécution et une compatibilité avec les nouvelles fonctionnalités du langage. Il fonctionne parfaitement avec toutes les versions modernes de .NET, y compris .NET 8, 9 et 10.

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 : 2025.11 vient de sortir