Comment créer des fichiers PDF en Java

Qu'est-ce que IronPDF for Java, et pourquoi l'utiliser ?

IronPDF for Java est une bibliothèque de génération et de manipulation de PDF basée sur le moteur de rendu Chromium. Parce qu'il rend le HTML exactement comme Chrome le fait, il gère les mises en page complexes, les polices personnalisées, les animations CSS, le contenu généré par JavaScript, et les images intégrées sans code de mise en page manuel.

La bibliothèque couvre l'ensemble du cycle de vie des PDF dans une seule dépendance. Les développeurs peuvent créer des documents à partir de zéro, convertir du contenu HTML existant, fusionner ou diviser des fichiers, ajouter des filigranes, crypter avec des mots de passe, extraire du texte et des images, et générer des formulaires remplissables, le tout via une API cohérente. Pour les flux de travail riches en HTML, IronPDF évite les calculs manuels de mise en page requis par les bibliothèques PDF de bas niveau comme Apache PDFBox.

Contrairement à iText, qui nécessite une licence open-source AGPL pour la plupart des utilisations commerciales, IronPDF est livré avec une licence conviviale pour les entreprises et ne nécessite pas de révision complexe de la conformité des licences. IronPDF for Java est livré sous forme d'artifact Maven et fonctionne sur Windows, Linux et macOS. Il s'intègre avec Spring Boot, Jakarta EE et les applications Java autonomes. La bibliothèque prend également en charge les déploiements serveur sur AWS, Azure et Google Cloud.

Quels sont les prérequis pour utiliser IronPDF en Java ?

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/maven-full.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/maven-full.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/gradle-dependency.gradle
implementation 'com.ironsoftware:ironpdf:2024.9.1'

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/imports.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.render.ChromePdfRenderOptions;
import com.ironsoftware.ironpdf.render.PaperOrientation;
import com.ironsoftware.ironpdf.render.PaperSize;
import com.ironsoftware.ironpdf.security.SecurityOptions;
import com.ironsoftware.ironpdf.security.SecurityManager;
import java.io.IOException;
import java.nio.file.Paths;

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/imports.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.render.ChromePdfRenderOptions;
import com.ironsoftware.ironpdf.render.PaperOrientation;
import com.ironsoftware.ironpdf.render.PaperSize;
import com.ironsoftware.ironpdf.security.SecurityOptions;
import com.ironsoftware.ironpdf.security.SecurityManager;
import java.io.IOException;
import java.nio.file.Paths;

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/license-setup.java
License.setLicenseKey("Your-License-Key");

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/license-setup.java
License.setLicenseKey("Your-License-Key");

Comment créer un PDF à partir d'une chaîne HTML en Java ?

Transmettez toute chaîne HTML directement à PdfDocument.renderHtmlAsPdf(). IronPDF renvoie une instance PdfDocument représentant le document finalisé en mémoire. Appelez saveAs() pour l'écrire sur le disque.

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-to-pdf.java
// HTML content with inline CSS
String htmlContent = "<h1>Hello World!</h1><p>This is an example HTML string.</p>";

// Render HTML string to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save to disk
pdf.saveAs(Paths.get("html.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-to-pdf.java
// HTML content with inline CSS
String htmlContent = "<h1>Hello World!</h1><p>This is an example HTML string.</p>";

// Render HTML string to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save to disk
pdf.saveAs(Paths.get("html.pdf"));

renderHtmlAsPdf() prend en charge l'intégralité des spécifications HTML5 et CSS3, y compris les polices Web, Flexbox, les mises en page en grille et l'exécution de JavaScript. L'exemple suivant utilise un modèle HTML multi-lignes avec des styles personnalisés :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-styled.java
// Multi-line HTML with CSS styling using a text block (Java 13+)
String styledHtml = """
    <!DOCTYPE html>
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; margin: 40px; }
            h1 { color: #2563eb; border-bottom: 2px solid #e5e7eb; padding-bottom: 8px; }
            .summary { background: #f3f4f6; padding: 16px; border-radius: 4px; }
        </style>
    </head>
    <body>
        <h1>Invoice #1042</h1>
        <div class="summary">
            <p>Amount due: $1,250.00</p>
            <p>Due date: 2024-06-01</p>
        </div>
    </body>
    </html>
    """;

PdfDocument invoice = PdfDocument.renderHtmlAsPdf(styledHtml);
invoice.saveAs(Paths.get("invoice.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-styled.java
// Multi-line HTML with CSS styling using a text block (Java 13+)
String styledHtml = """
    <!DOCTYPE html>
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; margin: 40px; }
            h1 { color: #2563eb; border-bottom: 2px solid #e5e7eb; padding-bottom: 8px; }
            .summary { background: #f3f4f6; padding: 16px; border-radius: 4px; }
        </style>
    </head>
    <body>
        <h1>Invoice #1042</h1>
        <div class="summary">
            <p>Amount due: $1,250.00</p>
            <p>Due date: 2024-06-01</p>
        </div>
    </body>
    </html>
    """;

PdfDocument invoice = PdfDocument.renderHtmlAsPdf(styledHtml);
invoice.saveAs(Paths.get("invoice.pdf"));

L'exemple de facture ci-dessus utilise des blocs de texte Java (disponibles depuis Java 13) pour un HTML multi-lignes plus propre. Pour les anciennes versions de Java, concaténez la chaîne HTML manuellement ou chargez-la à partir d'un fichier à l'aide de renderHtmlFileAsPdf(). Pour un aperçu plus large de la conversion de HTML en PDF, y compris le rendu JavaScript, consultez le tutoriel HTML to PDF for Java.

Comment créer un PDF à partir d'un fichier HTML local en Java ?

Utilisez PdfDocument.renderHtmlFileAsPdf() pour convertir un fichier HTML stocké sur le système de fichiers local. Passez le chemin sous forme de chaîne ; les chemins relatifs sont résolus par rapport au répertoire de travail actuel :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-file-to-pdf.java
// Convert a local HTML file to PDF
PdfDocument filePdf = PdfDocument.renderHtmlFileAsPdf("invoice-template.html");

// Save the converted document
filePdf.saveAs(Paths.get("invoice_output.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-file-to-pdf.java
// Convert a local HTML file to PDF
PdfDocument filePdf = PdfDocument.renderHtmlFileAsPdf("invoice-template.html");

// Save the converted document
filePdf.saveAs(Paths.get("invoice_output.pdf"));

IronPDF résout tous les actifs référencés (fichiers CSS externes, images locales et bibliothèques JavaScript) par rapport au répertoire du fichier HTML. Cela signifie que vous pouvez créer un modèle HTML complet avec des feuilles de style liées et le passer par IronPDF sans modifier aucun chemin d'actif.

La méthode accepte à la fois un chemin String et un objet java.nio.file.Path. Pour une utilisation en production, préférez les chemins absolus pour éviter l'ambiguïté du répertoire de travail. Voir l'exemple de fichier HTML en PDF pour une démonstration fonctionnelle complète.

Comment créer un PDF à partir d'une URL de page Web en Java ?

PdfDocument.renderUrlAsPdf() récupère une URL active, l'affiche à l'aide de Chromium et renvoie un fichier PDF. Cela est utile pour capturer des instantanés de tableau de bord, générer des reçus PDF à partir de pages de réception hébergées ou archiver du contenu web :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf.java
// Render a live web page to PDF
PdfDocument webPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
webPdf.saveAs(Paths.get("ironpdf-homepage.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf.java
// Render a live web page to PDF
PdfDocument webPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
webPdf.saveAs(Paths.get("ironpdf-homepage.pdf"));

Pour les pages protégées par une authentification HTTP, transmettez les identifiants via ChromePdfRenderOptions :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf-auth.java
// Configure render options with login credentials
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();
renderOptions.setAuthUsername("username");
renderOptions.setAuthPassword("password");

// Render authenticated page to PDF
PdfDocument securedPdf = PdfDocument.renderUrlAsPdf("https://your-internal-app.com/report", renderOptions);
securedPdf.saveAs(Paths.get("internal-report.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf-auth.java
// Configure render options with login credentials
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();
renderOptions.setAuthUsername("username");
renderOptions.setAuthPassword("password");

// Render authenticated page to PDF
PdfDocument securedPdf = PdfDocument.renderUrlAsPdf("https://your-internal-app.com/report", renderOptions);
securedPdf.saveAs(Paths.get("internal-report.pdf"));

Voir l'exemple de code URL en PDF pour des détails. Pour des flux de connexion plus complexes utilisant des cookies ou une authentification par formulaire, voir gestion des connexions au site web.

Comment contrôler la taille de la page, l'orientation et les marges ?

Utilisez ChromePdfRenderOptions pour personnaliser la mise en page du PDF de sortie. Passez les options configurées en tant que deuxième argument à toute méthode de rendu. Les paramètres les plus courants sont l'orientation de la page, la taille du papier et les marges :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/pdf-formatting.java
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();

// Set landscape orientation (default is portrait)
renderOptions.setPaperOrientation(PaperOrientation.LANDSCAPE);

// Use US Letter paper size (default is A4)
renderOptions.setPaperSize(PaperSize.LETTER);

// Set margins in millimeters (top, right, bottom, left)
renderOptions.setMarginTop(15);
renderOptions.setMarginRight(15);
renderOptions.setMarginBottom(15);
renderOptions.setMarginLeft(15);

// Include background colors and images
renderOptions.setPrintHtmlBackgrounds(true);

// Apply options when rendering
PdfDocument report = PdfDocument.renderHtmlAsPdf("<h1>Quarterly Report</h1>", renderOptions);
report.saveAs(Paths.get("report.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/pdf-formatting.java
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();

// Set landscape orientation (default is portrait)
renderOptions.setPaperOrientation(PaperOrientation.LANDSCAPE);

// Use US Letter paper size (default is A4)
renderOptions.setPaperSize(PaperSize.LETTER);

// Set margins in millimeters (top, right, bottom, left)
renderOptions.setMarginTop(15);
renderOptions.setMarginRight(15);
renderOptions.setMarginBottom(15);
renderOptions.setMarginLeft(15);

// Include background colors and images
renderOptions.setPrintHtmlBackgrounds(true);

// Apply options when rendering
PdfDocument report = PdfDocument.renderHtmlAsPdf("<h1>Quarterly Report</h1>", renderOptions);
report.saveAs(Paths.get("report.pdf"));

ChromePdfRenderOptions propose plus de 30 paramètres en plus de ceux indiqués ci-dessus, notamment la résolution (DPI), le délai d'exécution JavaScript, le facteur de Zoom et le type de média CSS. Consultez les paramètres de génération de PDF pour obtenir la liste complète. Pour les formats de papier personnalisés ne figurant pas dans l'énumération PaperSize, consultez la section sur les formats de papier PDF personnalisés.

Comment ajouter une protection par mot de passe à un PDF en Java ?

SecurityOptions contrôle les mots de passe de lecture et de propriétaire ainsi que les indicateurs d'autorisation. Passez SecurityOptions au SecurityManager du document avant d'économiser :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-basic.java
// Create security settings with a user-facing password
SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setUserPassword("shareable");

// Apply security to the document
PdfDocument urlPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
SecurityManager securityManager = urlPdf.getSecurity();
securityManager.setSecurityOptions(securityOptions);

// Save the password-protected document
urlPdf.saveAs(Paths.get("protected.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-basic.java
// Create security settings with a user-facing password
SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setUserPassword("shareable");

// Apply security to the document
PdfDocument urlPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
SecurityManager securityManager = urlPdf.getSecurity();
securityManager.setSecurityOptions(securityOptions);

// Save the password-protected document
urlPdf.saveAs(Paths.get("protected.pdf"));

Pour un contrôle plus strict, définissez un mot de passe propriétaire et restreignez des opérations spécifiques :

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-advanced.java
SecurityOptions advancedSecurity = new SecurityOptions();

// User password: required to open the file
advancedSecurity.setUserPassword("user-open-pass");

// Owner password: required to change security settings
advancedSecurity.setOwnerPassword("owner-admin-pass");

// Restrict editing operations
advancedSecurity.setAllowPrint(false);
advancedSecurity.setAllowCopy(false);
advancedSecurity.setAllowEditContent(false);
advancedSecurity.setAllowEditAnnotations(false);

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-advanced.java
SecurityOptions advancedSecurity = new SecurityOptions();

// User password: required to open the file
advancedSecurity.setUserPassword("user-open-pass");

// Owner password: required to change security settings
advancedSecurity.setOwnerPassword("owner-admin-pass");

// Restrict editing operations
advancedSecurity.setAllowPrint(false);
advancedSecurity.setAllowCopy(false);
advancedSecurity.setAllowEditContent(false);
advancedSecurity.setAllowEditAnnotations(false);

Ouvrir le PDF demande à l'utilisateur un mot de passe :

Les lecteurs de PDF affichent une invite de mot de passe lorsque le document est protégé par un mot de passe utilisateur.

Après avoir saisi le bon mot de passe, le PDF s'ouvre et affiche l'intégralité du contenu :

Le document se rend normalement après que le bon mot de passe a été fourni.

Voir paramètres de sécurité et de métadonnées pour la liste complète des indicateurs de permission.

Comment générer des PDF dans une application Spring Boot ?

IronPDF s'intègre directement avec Spring Boot. Retournez un PDF sous forme de réponse HTTP sous forme de tableau d'octets depuis n'importe quelle méthode de contrôleur ; ce modèle fonctionne pour la génération de rapports à la demande, le téléchargement de factures et les exportations de données.

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/spring-boot-controller.java
import com.ironsoftware.ironpdf.*;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.io.IOException;

@RestController
@RequestMapping("/api/pdf")
public class PdfController {

    @GetMapping("/invoice/{id}")
    public ResponseEntity<byte[]> generateInvoice(@PathVariable String id) throws IOException {
        // Build HTML dynamically using the invoice ID
        String html = """
            <html><body>
              <h1>Invoice #%s</h1>
              <p>Amount due: $500.00</p>
            </body></html>
            """.formatted(id);

        // Render and return as PDF download
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
        byte[] pdfBytes = pdf.getBinaryData();

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_PDF);
        headers.setContentDispositionFormData("attachment", "invoice-" + id + ".pdf");

        return ResponseEntity.ok().headers(headers).body(pdfBytes);
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/spring-boot-controller.java
import com.ironsoftware.ironpdf.*;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.io.IOException;

@RestController
@RequestMapping("/api/pdf")
public class PdfController {

    @GetMapping("/invoice/{id}")
    public ResponseEntity<byte[]> generateInvoice(@PathVariable String id) throws IOException {
        // Build HTML dynamically using the invoice ID
        String html = """
            <html><body>
              <h1>Invoice #%s</h1>
              <p>Amount due: $500.00</p>
            </body></html>
            """.formatted(id);

        // Render and return as PDF download
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
        byte[] pdfBytes = pdf.getBinaryData();

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_PDF);
        headers.setContentDispositionFormData("attachment", "invoice-" + id + ".pdf");

        return ResponseEntity.ok().headers(headers).body(pdfBytes);
    }
}

La méthode getBinaryData() renvoie le PDF sous forme de tableau d'octets, que Spring Boot transmet directement au client. Aucun fichier temporaire n'est écrit sur le disque. Pour les déploiements à haut débit, instanciez License.setLicenseKey() dans une méthode @PostConstruct ou un écouteur de démarrage d'application plutôt que par requête.

Quelles sont les étapes suivantes pour la création de PDF en Java ?

Ce guide a démontré quatre approches pour générer des PDF en Java en using IronPDF : rendu de chaîne HTML, conversion de fichier local, capture d'URL et diffusion de réponse HTTP Spring Boot. Toutes les méthodes partagent la même API PdfDocument, ChromePdfRenderOptions pour le contrôle de mise en forme et SecurityOptions pour la protection d'accès.

IronPDF for Java prend également en charge l'ajout et l'estampillage de filigranes, la fusion de plusieurs fichiers PDF, la division des PDFs en pages individuelles, l'ajout de signatures numériques, le rendu de graphiques JavaScript en PDF, et l'impression programmatique de PDFs.

Commencez un essai gratuit pour générer des PDF sans filigranes, ou consultez les options de licence pour choisir un plan qui correspond à votre projet. Prêt à aller plus loin ? Consultez la page du tutoriel complet IronPDF for Java.