HTML vers PDF en Java

Option 1 : Installer IronPDF en tant que Dépendance Maven

Pour installer IronPDF dans un projet Java à l'aide de Maven, ajoutez les artefacts suivants dans la section de dépendance du fichier pom.xml du projet Java.

<dependencies>
    <!-- IronPDF Library -->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <!-- SLF4J for logging (optional but recommended) -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>

<dependencies>
    <!-- IronPDF Library -->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <!-- SLF4J for logging (optional but recommended) -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>

Le premier artefact référence la dernière version de la bibliothèque IronPDF. Le deuxième artefact fait référence à une implémentation de SLF4J. Cette dépendance est nécessaire pour permettre au moteur de rendu d'IronPDF de générer des messages de journalisation pendant l'exécution. Les ingénieurs logiciels peuvent remplacer cette dépendance par d'autres fournisseurs de journalisation (tels que Logback et Log4J) ; ou l'omettre entièrement s'ils n'ont pas besoin ou ne souhaitent pas de journalisation.

Exécutez la commande mvn install dans un terminal au répertoire racine du projet Java pour télécharger les bibliothèques mentionnées précédemment.

Option 2 : Installer le JAR IronPDF Manuellement

Les développeurs qui préfèrent ne pas utiliser Maven ou tout autre système de gestion des dépendances devront télécharger le fichier JAR de la bibliothèque IronPDF (et l'implémentation SLF4J facultative) et l'ajouter manuellement au chemin de classe de leur projet.

Téléchargez le fichier JAR IronPDF directement à partir du téléchargement JAR IronPDF (ou à partir du dépôt Maven).

2.1 Importer le Package IronPDF

Tous les composants de conversion et de traitement d'IronPDF sont contenus dans le package com.ironsoftware.ironpdf.

Inclure l'instruction d'importation suivante en haut des fichiers source Java (où IronPDF sera utilisé) pour rendre ces composants accessibles au code source de l'application.

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

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

2.2. Définir la Clé de Licence (optionnel)

IronPDF pour Java est gratuit à utiliser. Cependant, pour les utilisateurs gratuits, il marquera les documents PDF avec un filigrane d'arrière-plan en mosaïque (comme montré dans l'image ci-dessous).

Pour utiliser IronPDF afin de générer des PDF sans les filigranes, la bibliothèque doit utiliser une clé de licence valide. La ligne de code ci-dessous configure la bibliothèque avec une clé de licence.

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

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

La clé de licence doit être définie avant de générer des fichiers PDF ou de personnaliser le contenu des fichiers. Nous recommandons d'appeler la méthode setLicenseKey avant toutes les autres lignes de code.

Achetez une clé de licence à partir de la page de licence d'IronPDF, ou contactez-nous pour obtenir une clé de licence d'essai gratuite.

2.3 Définir l'Emplacement du Fichier de Log (optionnel)

Par défaut (et en supposant qu'un fournisseur SLF4J soit installé), IronPDF génère des messages de journal vers un fichier texte appelé IronPdfEngine.log situé dans le répertoire racine de l'application Java.

Pour spécifier un nom et un emplacement différents pour le fichier journal, utilisez la méthode Settings.setLogPath :

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

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

2.4. Créer un PDF à partir d'une Chaine HTML

PdfDocument.renderHtmlAsPdf convertit une chaîne de contenu HTML en un document PDF.

L'exemple de code suivant utilise un seul élément de titre pour générer un nouveau fichier.

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");

La méthode renderHtmlAsPdf peut provenir d'images, de feuilles de style et de scripts situés dans des dossiers sur un ordinateur ou sur un lecteur réseau. L'exemple suivant produit un document PDF à partir de HTML qui référence un fichier CSS et une image situés dans un dossier assets :

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");

Un second argument (facultatif) à renderHtmlAsPdf permet aux développeurs de spécifier un chemin de base à partir duquel référencer les ressources Web. Ce chemin peut être vers un répertoire sur le système de fichiers local ou même un chemin URL.

Pour en savoir plus sur la méthode renderHtmlAsPdf, consultez cet exemple de code sur l'utilisation du HTML pour créer un PDF, ou lisez la page Référence API pour la classe PdfDocument pour un contrôle encore plus grand sur le rendu HTML en PDF.

2.5. Créer un PDF à partir d'une URL

Les développeurs peuvent convertir des pages web en ligne en documents PDF à l'aide de la méthode PdfDocument.renderUrlAsPdf d'IronPDF.

L'exemple suivant rend l'article Wikipedia en contenu PDF.

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");

Pour en savoir plus sur la conversion de pages web en contenu PDF, consultez cet exemple de code sur la conversion d'une URL en PDF.

2.6. Créer un PDF à partir d'un Fichier HTML

IronPDF peut également rendre un document HTML stocké sur un système de fichiers local directement dans son format PDF équivalent.

Le prochain exemple de code utilise cette facture comme une démonstration du monde réel de l'efficacité d'IronPDF à convertir des fichiers HTML.

Le balisage HTML de la facture est reproduit ici pour plus de commodité :

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>

Supposons que le fichier HTML ait été enregistré dans un dossier appelé "invoices" avec son fichier CSS et son fichier JavaScript. Nous pouvons utiliser IronPDF pour convertir le fichier HTML comme suit :

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");

Comme pour les exemples de conversion de chaîne HTML en PDF, IronPDF résout correctement toutes les URL relatives dans un document HTML vers leurs chemins corrects sur le système de fichiers. En conséquence, le fichier PDF que produit cet exemple est capable de capturer parfaitement les influences visuelles que toutes les feuilles de style et scripts référencés auraient normalement sur une page Web.