iText, Generación de archivo Pdf en Java

Durante la realización de algún programa es posible que llegue a necesitar crear algún tipo de recibo y/o reporte con el fin de tener una confirmación mas solida de las operaciones realizadas, la fecha en que se realizaron, o simplemente que se desee imprimir un comprobante de las mismas.

En estos casos el formato en el que normalmente se solicita es un archivo Pdf.

No es de extrañar por tanto que exista una librería en Java con la cual se puedan crear documentos en dicho formato de una forma bastante sencilla, que a su vez nos permite hacer uso de las funciones de formateo y localización que vienen incluidas con el formato.

Por esto se presenta este tutorial el cual cubre como dar de alta dicha librería para su uso en un proyecto del IDE Eclipse, mas un ejemplo sencillo de un programa

Antes de comenzar quisiera agradecer a Geek-tutorials.com que es donde encontré el tutorial que sirve de base para este, enlace al mismo que puede encontraste en la sección de referencias [1]

Creando el proyecto

Se asumirá ya se tiene instalado en entorno Eclipse, por lo que se comenzara con crear un nuevo proyecto, con el nombre ReciboPDF y presionamos finalizar

Figura 1 - Creando el proyecto de ejemplo

Notara que en el explorador de paquetes ahora esta nuestro nuevo proyecto, de clic sobre el signo + y notara la estructura del proyecto como se ve en la figura 2

Figura 2 - Estructura del proyecto

Ahora presione el botón derecho del ratón sobre el proyecto y vaya a nueva->carpeta y cree una carpeta llamada lib

Figura 3 - Nueva carpeta

Figura 4 - Carpeta para las librerías

Esta carpeta la usaremos para poner la librería iText, no es esencial del todo, pero es buena practica mantener las librerías en su propia carpeta.

Ahora descargue la librería desde http://sourceforge.net/projects/itext/ descargara un archivo itext-5.4.2.zip cuyo contenido se observa en la figura 5

Figura 5 - Contenidos de itext-5.4.2.zip

De ese archivo zip extraiga itextpdf-5.4.2.jar a la carpeta lib del proyecto

Ahora regrese a eclipse y presione F5 o a renovar en el menú contextual, con eso obtendrá algo como la figura 6, con el archivo jar ahora en la carpeta lib

Figura 6 - Librería detectada

Si bien la librería ya se encuentra en el directorio del proyecto aun falta agregarla a la ruta de construcción del proyecto, para esto presione con el botón derecho del raton sobre el nombre del proyecto y vaya a propiedades

Figura 7 - Via de Construcción Java

En el dialogo de propiedades seleccione "Via de Construcción Java" y vaya a la pestaña de propiedades como se ve en la figura 7

Ahí presione el boton añadir archivos Jar y seleccione itextpdf-5.4.2.jar como se ve en la figura 8 y presione aceptar

Figura 8 - Librerías

Vera que iText ahora aparece entre las librerías del proyecto, como muestra la figura 9

Figura 9 - Librerías del proyecto

Con esto ya podra usar la librería desde el proyecto, para prueba cree un paquete pruebaPDF y una nueva clase llamada PruebaPDF con el código:

package pruebaPDF;

import com.itextpdf.text.Document;
import com.itextpdf.text.pdf.PdfWriter;
import com.itextpdf.text.Paragraph;

import java.io.FileOutputStream;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Calendar;

public class PruebaPDF {
    
    public void ITextHelloWorld() throws Exception{
        Document document = new Document();        
        Calendar cal = Calendar.getInstance();
        Date fecha = new Date( cal.getTimeInMillis() );
        SimpleDateFormat formato = new SimpleDateFormat("dd/MM/yyyy");
        
        String parrafo = "Usaremos este parrafo como ejemplo de lo sencillo que es el uso de la libreria, pues como podria observar en el codigo esta cadena no lleva saltos de linea, mismos que la libreria agrego.";
        
        String parrafo2 = "A su vez podemos agregar datos con una simple concatenación, como ejemplo ponemos la fecha del dia en el formato deseado: " + formato.format(fecha) + " y como podemos ver tambien hacer uso de las diversas funciones de formateo de fecha y numeros, incluso formatos personalidades.";
        
        PdfWriter.getInstance(document, new FileOutputStream("recibo.pdf"));
        document.open();
        document.add(new Paragraph(parrafo));
        document.add(new Paragraph(parrafo2));
        document.close();
            
    }
    
    public static void main(String args[]){
        try{
            PruebaPDF p = new PruebaPDF();
            
            p.ITextHelloWorld();
            
        }catch(Exception e){
            System.out.println(e);
        }
    }
}

Si ejecuta el programa en el directorio raíz del proyecto encontrara un archivo recibo.pdf con el contenido mostrado en la figura 10

Figura 10 - Resultado

Con esto ya tiene un ejemplo sencillo de como usar la libreria, en futuras entradas veremos mas sobre el formateo de datos y de fechas.

Espero que esto ayude a los que deseen usar la librería y nos vemos en otra entrada

Referencias:
1 - Setup iText for project & Hello World - http://www.geek-tutorials.com/java/itext/setup_itext.php
2 - iText®, a JAVA-PDF library - http://sourceforge.net/projects/itext/