Generación de PDFs en Java: Un enfoque práctico usando HTML y iText 🚀

¡Hola, desarrolladores! En el desarrollo de aplicaciones empresariales, es muy común la necesidad de generar documentos en formato PDF de manera dinámica. Ya sea para facturas, reportes o cartas, la capacidad de convertir contenido HTML en un PDF es una habilidad muy valiosa.

En este artículo, te voy a mostrar una forma sencilla y efectiva de crear archivos PDF en Java, utilizando una librería popular como iText. Lo más interesante de este método es que nos permite definir el contenido y la estructura del documento usando HTML, lo que facilita enormemente el diseño y la personalización.

Aquí te presento un ejemplo de código que ilustra el proceso.

Paso 1: Generar el cuerpo HTML del PDF

El primer paso es construir el contenido que queremos convertir a PDF. Lo haremos como si estuviéramos creando una página web, utilizando un StringBuilder para ir agregando las etiquetas HTML. En este ejemplo, creamos una carta básica con la fecha, un saludo y un cuerpo de texto.

/**
* Obtiene el contenido HTML para la carta.
* @return String con el contenido HTML.
*/
private String obtainHtmlFile() {
SimpleDateFormat sdf = new SimpleDateFormat("MMMM dd 'de' yyyy");
StringBuilder html = new StringBuilder();
Calendar cal = Calendar.getInstance();
Date dateNow = cal.getTime();

html.append("<html>");
html.append("<head>");
html.append("<meta http-equiv='Content-Type' content='text/html; charset=UTF-8' />");
html.append("</head>");
html.append("<body>");
html.append("Bogotá, ").append(sdf.format(dateNow)).append("");
html.append(" ");
html.append("Señora");
html.append("Pepito Perez");
html.append("Ciudad");
html.append(" ");
html.append("REF: Envío de PDF");
html.append("Cordial Saludo,");
html.append(" ");
html.append("</body>");
html.append("</html>");

return html.toString();
}

Este método devuelve una cadena de texto que contiene todo el HTML que se utilizará para el documento. Puedes personalizar este StringBuilder para incluir variables dinámicas, listas, tablas o cualquier otro elemento HTML.

Paso 2: Convertir HTML a PDF

Una vez que tenemos el HTML, el siguiente paso es usar la librería iText para generar el archivo PDF. En este ejemplo, el método generarPDF toma el HTML, crea un documento PDF y lo rellena con el contenido.

/**
* Genera un archivo PDF a partir de un String HTML.
* @param dir Directorio donde se guardará el archivo.
* @param name Nombre del archivo.
* @return El nombre del archivo PDF generado.
*/
private String generarPDF(File dir, String name) {
String nameFilePdf = "";
String bodyHtml = obtainHtmlFile(); // Asumimos que este método ya está definido

try {
Document document = new Document(PageSize.A4);
PdfWriter.getInstance(document, new FileOutputStream(dir.getPath() + "/" + name + ".pdf"));

document.open();
document.addCreationDate();

HTMLWorker htmlWorker = new HTMLWorker(document);
htmlWorker.parse(new StringReader(new String(bodyHtml.getBytes(), "UTF-8")));

document.close();
nameFilePdf = name + ".pdf";

} catch (Exception e) {
e.printStackTrace();
}

return nameFilePdf;
}

Análisis del código:

Document document = new Document(PageSize.A4);: Creamos un objeto Document de iText y definimos el tamaño de la página, en este caso, A4.
PdfWriter.getInstance(...): Aquí se configura el PdfWriter para que escriba el contenido del documento en un archivo de salida (FileOutputStream).
document.open(): Abre el documento para comenzar a agregar contenido.
HTMLWorker htmlWorker = new HTMLWorker(document);: Creamos una instancia de HTMLWorker, una clase de iText que se encarga de procesar HTML.
htmlWorker.parse(...): Con este método, el HTMLWorker lee el HTML y lo traduce en elementos que pueden ser agregados al PDF.
document.close(): Cierra el documento, guardando el archivo.

Conclusión

Este enfoque te brinda una gran flexibilidad para generar documentos PDF complejos de manera sencilla. Puedes separar la lógica de negocio de la lógica de presentación, ya que el contenido se puede generar en HTML y luego convertir a PDF.

¿Qué otros métodos utilizas para generar PDFs en Java? ¡Comparte tu experiencia en los comentarios y sigamos aprendiendo juntos!

Blog Oficial MaclaTech

Buscar este blog