Comment utiliser IronPdfEngine

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.

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

IronPDF pour Java et IronPdfEngine

IronPdf for Java nécessite IronPdfEngine pour fonctionner. Le code Java est juste un masque API sur IronPdfEngine gRPC. Donc, lorsque vous appelez n'importe quelle méthode dans IronPdf for Java, la magie se produira à l'intérieur de IronPdfEngine !

Par défaut, IronPdf for Java créera IronPdfEngine en tant que sous-processus et communiquera avec lui jusqu'à ce que votre application s'arrête.

A noter
Chaque version d'IronPDF for Java nécessite une version spécifique d'IronPdfEngine. La compatibilité entre les versions n'est pas assurée.

IronPDF pour Java avec IronPdfEngine local

Option 1 : Télécharger IronPdfEngine à 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 fichiers binaires corrects d'IronPdfEngine 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

Pour

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

Cons

  • L'accès à l'internet est nécessaire pour les premières courses
  • Temps de démarrage lent

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

IronPDF Java vous permet d'ajouter IronPdfEngine comme dépendance. Ces dépendances IronPdfEngine regroupent IronPdfEngine dans un fichier .zip et seront extraites et utilisées automatiquement.

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

A noter
ironpdf et ironpdf-engine-xxx-xxx doivent avoir la même version de dépendance.

la version de la dépendance ironpdf-engine-xxx-xxx ne se réfère pas à la version de IronPdfEngine à l'intérieur.

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

A noter
Chaque dépendance est assez importante, il n'est donc pas conseillé de toutes les installer.

Pour

  • 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 spécifier les plates-formes cibles.

IronPDF for Java avec IronPdfEngine à distance

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

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

Comment se connecter

Supposez que IronPdfEngine est opérationnel à distance à 123.456.7.8:33350

Consulter les instructions pour extraire et exécuter IronPdfEngine

Vous devez simplement indiquer à IronPdf où se trouve IronPdfEngine (veuillez vous assurer que l'adresse est accessible, non bloquée par le pare-feu). Ajoutez ce code à l'étape initiale de votre application (ou juste avant d'appeler une méthode 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

Aussi simple que cela ! Après cela, votre application sera connectée au IronPdfEngine distant !

Pour IronPdfEngine à distance, il n'est pas nécessaire d'installer IronPdfEngine en tant que dépendance. Vous pouvez ignorer la section intitulée "Option 2 (recommandée) installer IronPdfEngine en tant que dépendance."