HTML a PDF en Java

Opción 1: Instalar IronPDF como dependencia de Maven

Para instalar IronPDF en un proyecto Java usando Maven, agrega los siguientes artefactos a la sección de dependencias del archivo pom.xml del proyecto 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>

El primer artefacto hace referencia a la última versión de la biblioteca IronPDF. El segundo artefacto hace referencia a una implementación de SLF4J. Esta dependencia es necesaria para permitir que el motor de renderizado de IronPDF genere mensajes de registro durante la ejecución. Los ingenieros de software pueden sustituir esta dependencia por otros proveedores de registro (como Logback y Log4J); o omitirla completamente si no necesitan o no desean registro.

Ejecute el comando mvn install dentro de un terminal en el directorio raíz del proyecto Java para descargar las bibliotecas mencionadas anteriormente.

Opción 2: Instalar el JAR de IronPDF manualmente

Los desarrolladores que prefieran no utilizar Maven o cualquier otro sistema de gestión de dependencias tendrán que descargar el archivo JAR de la biblioteca IronPDF (y la implementación opcional SLF4J) y añadirlo manualmente a la ruta de clases de su proyecto.

Descargue el archivo JAR de IronPDF directamente desde la descarga de JAR de IronPDF (o desde el repositorio de Maven).

2.1 Importar el paquete IronPDF

Todos los componentes de conversión y procesamiento de IronPDF están contenidos en el paquete com.ironsoftware.ironpdf.

Incluya la siguiente declaración de importación en la parte superior de los archivos fuente de Java (donde se utilizará IronPDF) para que estos componentes sean accesibles al código fuente de la aplicación.

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

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

2.2. Configurar la clave de licencia (opcional)

IronPDF para Java es gratuito para usar. Sin embargo, para usuarios gratuitos, colocará una marca de agua de fondo en mosaico en los documentos PDF (como se muestra en la imagen a continuación).

Para usar IronPDF para generar PDFs sin las marcas de agua, la biblioteca debe usar una clave de licencia válida. La línea de código a continuación configura la biblioteca con una clave de licencia.

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

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

La clave de licencia debe configurarse antes de generar archivos PDF o personalizar el contenido del archivo. Recomendamos que llame al método setLicenseKey antes de todas las demás líneas de código.

Adquiera una clave de licencia en la página de licencias de IronPDF o póngase en contacto con nosotros para obtener una clave de licencia de prueba gratuita.

2.3 Establecer la ubicación del archivo de registro (opcional)

Por defecto (y suponiendo que haya un proveedor SLF4J instalado), IronPDF genera mensajes de registro en un archivo de texto llamado IronPdfEngine.log ubicado en el directorio raíz de la aplicación Java.

Para especificar un nombre y ubicación diferente para el archivo de registro, use el método Settings.setLogPath:

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

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

2.4. Creación de un PDF a partir de una cadena HTML

PdfDocument.renderHtmlAsPdf convierte una cadena de contenido HTML en un documento PDF.

La siguiente muestra de código usa un único elemento de titular para generar un nuevo archivo.

// 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");

El método renderHtmlAsPdf puede obtener imágenes, hojas de estilo y scripts ubicados en carpetas en una computadora o en una unidad de red. El siguiente ejemplo produce un documento PDF desde HTML que hace referencia a un archivo CSS y una imagen ubicados en una carpeta 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 segundo argumento (opcional) para renderHtmlAsPdf permite a los desarrolladores especificar una ruta base desde la cual referenciar activos web. Esta ruta puede ser un directorio en el sistema de archivos local o incluso una ruta de URL.

Obtenga más información sobre el método renderHtmlAsPdf en este ejemplo de código sobre el uso de HTML para crear un PDF, o lea sobre él en la página de referencia de la API para la clase PdfDocument para obtener un control aún mayor sobre la conversión de HTML a PDF.

2.5. Creación de un PDF a partir de una URL

Los desarrolladores pueden convertir páginas web en línea en documentos PDF utilizando el método PdfDocument.renderUrlAsPdf de IronPDF.

El siguiente ejemplo renderiza el artículo de Wikipedia en contenido 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");

Obtenga más información sobre la conversión de páginas web en contenido PDF en este ejemplo de código sobre la conversión de una URL en un PDF.

2.6. Creación de un PDF a partir de un archivo HTML

IronPDF también puede renderizar un documento HTML almacenado en un sistema de archivos local directamente en su formato equivalente en PDF.

El siguiente ejemplo de código usa esta factura como una demostración del mundo real de cuán bien IronPDF puede convertir archivos HTML.

El marcado HTML para la factura se reproduce aquí para conveniencia:

<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>

Supongamos que el archivo HTML ha sido guardado en una carpeta llamada "invoices" junto con su archivo CSS y archivo JavaScript. Podemos usar IronPDF para convertir el archivo HTML de la siguiente manera:

// 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");

Al igual que con los ejemplos de conversión de cadena HTML a PDF, IronPDF resuelve correctamente cualquier URL relativa en un documento HTML a sus rutas correctas en el sistema de archivos. Como resultado, el archivo PDF que produce este ejemplo es capaz de capturar perfectamente las influencias visuales que cualquier hoja de estilo y script referenciado normalmente tendría en una página web.