Generando tablas en archivos Pdf con Java e iText

Estándar

Si he de ser honesto esta es la razón de que halla decidido aprender a mas detalle como se usa
la librería iText, la necesidad de crear tablas para generar reportes de datos, por fortuna el procedimiento es muy sencillo.

Cree un proyecto Java con la librería iText, esto se describió en una entrada anterior, hecho esto cree un paquete tablas y una clase Tablas, en la que ponga el siguiente código, las partes que generan la tabla se describirán después

package tablas;
import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfPCell;
import com.itextpdf.text.pdf.PdfPTable;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;

public class Tablas {
    
    static public void main(String[] args)
    {
        Document document = new Document();
        
        try{
            PdfWriter.getInstance(document, new FileOutputStream("tablas.pdf"));
            document.open();
            
            // Este codigo genera una tabla de 3 columnas
            PdfPTable table = new PdfPTable(3);                
            
            // addCell() agrega una celda a la tabla, el cambio de fila
            // ocurre automaticamente al llenar la fila
            table.addCell("Celda 1");
            table.addCell("Celda 2");
            table.addCell("Celda 3");
            
            table.addCell("Celda 4");
            table.addCell("Celda 5");
            table.addCell("Celda 6");
            
            table.addCell("Celda 7");
            table.addCell("Celda 8");
            table.addCell("Celda 9");
            
            // Si desea crear una celda de mas de una columna
            // Cree un objecto Cell y cambie su propiedad span
            
            PdfPCell celdaFinal = new PdfPCell(new Paragraph("Final de la tabla"));
            
            // Indicamos cuantas columnas ocupa la celda
            celdaFinal.setColspan(3);
            table.addCell(celdaFinal);
            
            // Agregamos la tabla al documento            
            document.add(table);
            
            document.close();
            
        }catch(Exception e)
        {
            System.err.println("Ocurrio un error al crear el archivo");
            System.exit(-1);
        }
    }
}

El archivo resultado tablas.pdf lucirá de este modo:

Imagen

Figura 1 – Resultado

Los comentarios indican donde esta el código notable, el cual describiremos a continuación:

PdfPTable table = new PdfPTable(3);
Genera un objecto PdfPTable , el constructor nos permite indicar el numero de *columnas* que
tendrá la tabla.

table.addCell(“Celda 1”);
Agrega una celda a la tabla, permite agregar varios objectos, en este caso una cadena de texto
Notara que no hay mención de un salto de columna o similar, esto no es necesario, ya que la función
automáticamente realiza el salto de fila.

PdfPCell celdaFinal = new PdfPCell(new Paragraph(“Final de la tabla”));
Esta linea de código crea un objecto PdfPCell, el cual representa una celda en la tabla, posiblemente
se pregunte por que fue necesario crear este objecto aparte, la razón es sencilla para acceder a sus
propiedades, como lo es setColSpan.

celdaFinal.setColspan(3);
Esta propiedad de los objectos PdfPCell nos permite indicar cuantas columnas debe de abarcar la celda muy útil para la generación de títulos, o como en este caso pies de la tabla.

table.addCell(celdaFinal);
Esta sobrecarga del método addCell agrega la celda que acabamos de crear a la tabla.

Esto cubre lo básico del uso de iText, seguramente notara lo sencillo que seria usar estas funciones con ciclos para poder generar una tabla de reporte bastante completa

Espero que esta información halla sido de utilidad y nos vemos en otra entrada.

Referencias:

http://www.geek-tutorials.com/java/itext/itext_table.php

Anuncios

iText, Generación de archivo Pdf en Java

Estándar

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

Creando el proyecto

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

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

Lib

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

05_contenido

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

06_lib_agregada

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

07_via_de_construccion

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

08_librerias

Figura 8 – Librerías

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

09_agregar_librerias

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

10_resultado

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/