Convertir HTML a PDF en Java

Los archivos PDF tienen muchas ventajas sobre otros formatos y, en ocasiones, es posible que necesites convertir HTML a PDF. Esto es particularmente útil para crear versiones de páginas web de alta calidad y fáciles de imprimir, generar informes o compartir documentos que son difíciles de editar o modificar.

La capacidad de convertir documentos HTML de manera fácil y confiable a otros formatos es una de las características principales de Aspose.HTML for Java. En este artículo, encontrará información sobre cómo convertir HTML a PDF usando los métodos convertHTML() de la clase Converter y cómo aplicar PdfSaveOptions.

HTML a PDF mediante una sola línea de código Java

La conversión de HTML a PDF es una característica muy solicitada y Aspose.HTML for Java ofrece una solución sencilla. A través de métodos estáticos en la clase Converter, puedes convertir un documento HTML en un archivo PDF con solo una línea de código.

// Invoke the convertHTML() method to convert the HTML to PDF
Converter.convertHTML("<h1>Convert HTML to PDF!</h1>", ".", new PdfSaveOptions(), "convert-with-single-line.pdf");

En el ejemplo, utilizamos el método convertHTML(content, baseUri, options, outputPath) de la clase Converter que toma cuatro parámetros: cadena con el código HTML a convertir, la carpeta base para el archivo HTML de entrada, un instancia de la clase PdfSaveOptions y la ruta del archivo de salida donde se guardará el archivo convertido.

Convertir HTML a PDF en Java

Repasemos las instrucciones paso a paso para un escenario simple de conversión de HTML a PDF:

1. Cargue un archivo HTML usando uno de los constructores HTMLDocument() de la clase HTMLDocument. Puede cargar HTML desde un archivo, código HTML, secuencia o URL (consulte el artículo Creación de un documento HTML). En el ejemplo, utilizamos el constructor HTMLDocument(dirección) que inicializa un documento HTML a partir de un archivo.
2. Cree un nuevo objeto PdfSaveOptions. Utilice el constructor vacío PdfSaveOptions() para convertir con las opciones de guardado predeterminadas.
3. Utilice el método сonvertHTML(document, options, outputPath) de la clase Converter para guardar HTML como un archivo PDF.

Revise el siguiente fragmento de código Java, que muestra el proceso de conversión de HTML a PDF con instrucciones paso a paso:

// Prepare HTML code and save it to a file
String code = "<span>Hello, World!!</span>";
try (java.io.FileWriter fileWriter = new java.io.FileWriter("link-to-incoming-document.html")) {
    fileWriter.write(code);
}

// Initialize an HTML document from the file
HTMLDocument document = new HTMLDocument("link-to-incoming-document.html");

// Initialize PdfSaveOptions
PdfSaveOptions options = new PdfSaveOptions();

// Convert HTML to PDF
Converter.convertHTML(document, options, "document-output.pdf");

Opciones de guardado – Clase PdfSaveOptions

Aspose.HTML for Java permite convertir HTML a PDF utilizando opciones de guardado predeterminadas o personalizadas. PdfSaveOptions le permite personalizar el proceso de renderizado. Puede especificar el tamaño de página, márgenes, permisos de archivo, tipo de medio, etc.

Metod	Description
setJpegQuality(value)	Specifies the quality of JPEG compression for images. The default value is 95.
getCss()	Gets a CssOptions object which is used for configuration of CSS properties processing.
setBackgroundColor(value)	Sets the color that will fill the background of every page. By default, this property is Transparent.
setPageSetup(value)	This method sets a page setup object and uses it for configuration output page-set.
setHorizontalResolution(value)	Sets horizontal resolution for internal images, in pixels per inch. By default this property is 300 dpi.
setVerticalResolution(value)	Sets vertical resolution for output images in pixels per inch. The default value is 300 dpi.
setEncryption	This method gets or sets encryption details. If it is not set, then no encryption will be performed.

Para obtener más información sobre PdfSaveOptions, lea el artículo Convertidores de ajuste fino.

Puede descargar los ejemplos completos y los archivos de datos desde GitHub.

Convierta HTML a PDF usando PdfSaveOptions

Con Aspose.HTML for Java, puede convertir archivos mediante programación con control total sobre una amplia gama de parámetros de conversión. Sólo sigue unos pocos pasos:

1. Cargue un archivo HTML usando uno de los constructores HTMLDocument() de la clase HTMLDocument.
2. Cree un nuevo objeto PdfSaveOptions y especifique las propiedades requeridas. El constructor PdfSaveOptions() inicializa una instancia de la clase PdfSaveOptions que se pasa al método convertHTML().
3. Utilice el método сonvertHTML(document, options, outputPath) de la clase Converter para guardar HTML como un archivo PDF.

El siguiente ejemplo de Java muestra cómo utilizar PdfSaveOptions y crear un archivo PDF con tamaño de página personalizado, márgenes, resoluciones, color de fondo y especificación de compresión:

// Initialize an HTML document from a file
HTMLDocument document = new HTMLDocument("drawing.html");

// Initialize PdfSaveOptions. Set up the page-size 500x300 pixels, margins,
// resolutions and change the background color to AliceBlue
PdfSaveOptions options = new PdfSaveOptions();
options.setHorizontalResolution(new Resolution(200, UnitType.AUTO));
options.setVerticalResolution(new Resolution(200, UnitType.AUTO));;
options.setBackgroundColor(Color.getAliceBlue());
options.setJpegQuality(100);
options.getPageSetup().setAnyPage(new Page(new Size(500, 300), new Margin(20, 10, 10, 10)));

// Convert HTML to PDF
Converter.convertHTML(document, options, "drawing-options.pdf");

En el ejemplo anterior, se utilizaron varias opciones para guardar PDF:

• setJpegQuality() especifica la calidad de compresión JPEG para imágenes.
• setBackgroundColor() establece el color que rellena el fondo.
• setHorizontalResolution() y setVerticalResolution() establecen resoluciones horizontales y verticales para archivos PDF de salida.
• setPageSetup() especifica el tamaño de página y los márgenes del documento de salida.

Un ejemplo más de Java. Aquí creamos un documento HTML desde cero: preparamos el código HTML y lo guardamos en un archivo. Luego aplicamos PdfSaveOptions para convertir HTML a PDF:

// Prepare HTML code and save it to a file
String code = "<h1>  PdfSaveOptions Class</h1> " +
        "<p>Using PdfSaveOptions Class, you can programmatically " +
        "apply a wide range of conversion parameters " +
        "such as BackgroundColor, HorizontalResolution, VerticalResolution, PageSetup, etc.</p>";

FileHelper.writeAllText("save-options.html", code);

// Initialize an HTML Document from the HTML file
HTMLDocument document = new HTMLDocument("save-options.html");

// Set up the page-size, margins and change the background color to AntiqueWhite
PdfSaveOptions options = new PdfSaveOptions();
options.setBackgroundColor(Color.getAntiqueWhite());
options.getPageSetup().setAnyPage(
        new Page(
                new Size(Length.fromInches(4.9f), Length.fromInches(3.5f)),
                new Margin(30, 20, 10, 10)
        )
);

// Convert HTML to PDF
Converter.convertHTML(document, options, "save-options-output.pdf");

Conclusión

La conversión de HTML a PDF es una función útil para crear documentos de alta calidad, que se pueden compartir y que se pueden imprimir. Aspose.HTML for Java proporciona una solución sólida con la clase Converter, que le permite convertir fácilmente HTML a PDF utilizando métodos flexibles como convertHTML() y PdfSaveOptions personalizables.

La clase PdfSaveOptions permite a los desarrolladores personalizar la salida especificando tamaños de página, márgenes, resoluciones, colores de fondo, opciones de compresión, cifrado, etc., asegurando resultados precisos y profesionales. Si crea informes y guarda contenido web como documentos PDF, Aspose.HTML for Java simplifica el proceso con un código mínimo.

Aspose.HTML ofrece un Convertidor de HTML a PDF gratuito en línea que convierte HTML a PDF con alta calidad, fácil y rápido. ¡Simplemente cargue, convierta sus archivos y obtenga el resultado en unos segundos!