iText - ¿Como generar un PDF con iText? - Clases fundamentales en iText - ¿Como ingresar texto a un PDF con iText?

Continuando con nuestros pasos por  iText (Link introducción a itext), hoy vamos a ensuciarnos un poco viendo código.

Antes de comenzar a codificar vamos hablar de las clases fundamentales y su funcionamiento.

Clases fundamentales en iText

• com.lowagie.text.Document: Es la clase principal para la generación de documentos PDF. Esta es la primera clase que es instanciada. Una vez que el documento es creado, se deberá proceder a escribir dentro de él. Contiene el tamaño y margenes del documento.
• com.lowagie.text.pdf.PdfWriter: Es la clase que permite escribir en el PDF.
• com.lowagie.text.Paragraph: Es la clase que representa el párrafo a escribir.
• com.lowagie.text.Chapter: Es la clase que representa un capítulo en el documento PDF. Este es creado utilizando un párrafo como título y un entero como número del capítulo.
• com.lowagie.text.Font: esta clase contiene todas las especificaciones de las fuentes, tamaños, estilos y colores de las letras a utilizar en el documento. Varias de las fuentes son declaradas estáticamente en esta clase.

¿Como generar un PDF con iText?

Como dijimos mas arriba, lo primero que tenemos que hacer es una instancia de la clase Document.

Document documento = new Document();

Esta clase contiene los siguientes constructores:

• Document(): Constructor que utiliza por defecto el tipo de hoja A4.
• Document(Rectangle pageSize): Constructor al cual se le pasa por parámetro el tamaño de hoja y toma por defecto los margenes  36, 36, 36, 36.
• Document(Rectangle pageSize, float marginLeft, float marginRight,float marginTop, float marginBottom): Constructor al cual se le pasa por parámetro el tamaño de la hoja y los margenes a gusto.

Tenemos que definir el tipo de documento que vamos a escribir.

• PdfWriter getInstance(final Document document, final OutputStream os): Constructor en el cual se le pasa el documento el cual se va a escribir (document) y el path de salida del pdf generado, incluyendo en el mismo el nombre del pdf el cual se generar y la extensión .pdf. 

Al utilizar el PdfWriter  hay que contemplar las siguientes excepciones:

• DocumentException: Excepción producida en la generación del documento.
• IOException: Excepción producida por algún error con el archivo de salida, pudiendo ser de lectura y/o escritura.

"(En versiones viejas de iText se podía usar escritores RTF y HTML, pero a partir de la versión 5.0 ya no hay soporte para los mismos)."

A modo de ejemplo le pasare el documento previamente generado y el nombre del archivo el cual sera "Ejemplo.pdf". (Al poner el nombre del archivo sin la ubicación completa lo generara en el mismo lugar donde se esta ejecutando.)

PdfWriter.getInstance(documento, new FileOutputStream("Ejemplo.pdf"));

Una vez configurada la estructura del documento,  se debe abrir antes de comenzar a insertar párrafos, textos, figuras, etc.

documento.open();

"No se puede agregar Meta-Información o escribir el header luego que se haya abierto el archivo."

Para agregar párrafos al documentos iText nos brinda la clase Paragraph.

Esta clase contiene los siguientes constructores:

• Paragraph(String string): El constructor recibe por parámetro una cadena, la cual representa el texto a ingresar.
• Paragraph(String string, Font font): El constructor recibe por parámetro una cadena, la cual representa el texto a ingresar y tambien el tipo de fuente.
• Paragraph(Phrase phrase): El constructor recibe por parámetro otro párrafo.

Paragraph parrafo = new Paragraph("Ejemplo de iText - El lado oscuro de java");

Una ves que obtuvimos el párrafo solo quedaría agregarlo al documento.

documento.add(parrafo);

Finalmente cerramos el documento.

documento.close();

Resultado:

PDF generado con iText

Código completo:

Bueno espero que les allá resultado fácil y entendible! Cualquier cosa me comentan.
Saludos