1. IronPDF
  2. Docs
  3. Pour commencer

IronPDF for Java - Créer, éditer et lire des PDF dans des applications Java

This article was translated from English: Does it need improvement?
Translated
View the article in English

À propos d'IronPDF for Java

IronPDF for Java est une bibliothèque développée et maintenue par Iron Software qui aide les ingénieurs logiciels à créer, modifier et extraire du contenu PDF dans des projets Java 8+, Kotlin et Scala.

IronPDF for Java s'appuie sur le succès et la popularité de IronPDF for .NET.

IronPDF for Java utilise gRPC pour communiquer avec le IronPdfEngine.

IronPDF excelle à

  • Générer des PDF à partir de : HTML, URL, JavaScript, CSS, et de nombreux formats d'image
  • Ajout d'en-têtes/pieds de page, de signatures, de pièces jointes, de mots de passe et de sécurité
  • Optimisation des performances : Prise en charge complète du multithreading et de l'asynchronisme
  • Et bien plus encore ! Visitez notre site web pour voir tous nos exemples de code et une liste complète de nos 50+ fonctionnalités

Utilisation d'IronPDF for Java

Définir IronPDF for Java comme une dépendance de Java

dépendance pom.xml

Pour définir IronPDF comme une dépendance, veuillez ajouter ce qui suit à votre pom.xml :

<dependencies>

<!--Adds IronPDF Java. Use the latest version in the version tag.-->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

<!--Adds the slf4j logger which IronPDF Java uses.-->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>

</dependencies>
<dependencies>

<!--Adds IronPDF Java. Use the latest version in the version tag.-->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

<!--Adds the slf4j logger which IronPDF Java uses.-->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>

</dependencies>
XML

Télécharger le fichier jar

Optionnellement, téléchargez manuellement le fichier JAR de IronPDF pour une utilisation autonome.

Première construction et exécution

Les binaires du IronPdfEngine seront automatiquement téléchargés lors de la première exécution du projet. Le processus IronPdfEngine démarrera lorsque vous appellerez une fonction IronPdf pour la première fois, et s'arrêtera lorsque votre application sera fermée ou lorsqu'elle entrera dans un état d'inactivité.

Installer le moteur IronPDF en tant que dépendance Maven

En ajoutant IronPdfEngine comme dépendance Maven, les binaires seront téléchargés lors du chargement des dépendances :

  • Cette approche évitera un long processus de démarrage, car les binaires d'IronPdfEngine seront déjà téléchargés.

  • En outre, il sera utile pour les configurations de déploiement qui n'autorisent pas le téléchargement à partir de sources externes.

    Ajoutez simplement un ou plusieurs des extraits de code suivants à votre fichier pom.xml si vous travaillez sur une application multiplateforme :

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 (Intel)

<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 (Apple Silicon)

<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

Commencer à écrire du code Java

Une fois que la dépendance est définie, vous pouvez commencer en ajoutant l'instruction import com.ironsoftware.ironpdf.* en haut de votre code Java. Voici un exemple simple de conversion de HTML en PDF pour commencer :

// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));
// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));
JAVA

Il s'agit d'un autre exemple simple qui démontre la conversion d'une URL en PDF :

// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the URL as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url_saved.pdf"));

PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");
// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the URL as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url_saved.pdf"));

PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");
JAVA

Exemple complet Main.java

package org.example;  

// Import statement for IronPDF Java  
import com.ironsoftware.ironpdf.*;  
import java.io.IOException;  
import java.nio.file.Paths;  

public class Main {  

    public static void main(String [] args) throws IOException {
        // Apply your license key
        License.setLicenseKey("YOUR-LICENSE-KEY");  

        // Set a log path  
        Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));  

        // Render the HTML as a PDF. Stored in myPdf as type PdfDocument  
        PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");  

        // Save the PdfDocument to a file  
        myPdf.saveAs(Paths.get("html_saved.pdf"));

    }  

}
package org.example;  

// Import statement for IronPDF Java  
import com.ironsoftware.ironpdf.*;  
import java.io.IOException;  
import java.nio.file.Paths;  

public class Main {  

    public static void main(String [] args) throws IOException {
        // Apply your license key
        License.setLicenseKey("YOUR-LICENSE-KEY");  

        // Set a log path  
        Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));  

        // Render the HTML as a PDF. Stored in myPdf as type PdfDocument  
        PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");  

        // Save the PdfDocument to a file  
        myPdf.saveAs(Paths.get("html_saved.pdf"));

    }  

}
JAVA

Autres informations sur les réglages

Note : Veuillez noter que toutes les opérations de paramétrage, de journalisation et de licence doivent être exécutées avant que les méthodes IronPDF ne soient appelées.

Application de la clé de licence

Pour appliquer votre clé de licence, ajoutez ce qui suit au début de votre méthode :

com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");
com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");
JAVA

Enregistrement

IronPDF Java utilise le logger slf4j pour les besoins de journalisation. Pour activer la journalisation, utilisez :

com.ironsoftware.ironpdf.Settings.setDebug(true);
com.ironsoftware.ironpdf.Settings.setDebug(true);
JAVA

Pour spécifier le chemin du journal IronPdfEngine, ajoutez :

com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));
com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));
JAVA

Licences et assistance disponibles

Achetez une licence pour IronPDF pour l'utiliser dans des projets en direct. Des licences d'essai de 30 jours sont également disponibles pour les utilisateurs en essai.

Pour la liste complète des exemples de code, tutoriels, informations de licence et documentation, visitez : ressources IronPDF for Java.

Pour plus de soutien et de demandes, veuillez contacter notre équipe d'assistance.