Supongamos que tenemos la necesidad de conectar una aplicación a una base de datos, crear un documento PDF,etc. , pero no tenemos las librerías necesarias para ello entonces la solución sería usar Grapes.
¿Qué es Grapes?
Se trata de un gestor de dependencias que nos permite usar librerías sin la necesidad de agregarlas a nuestro CLASSPATH.
Ejemplo. Crear un documento PDF mediante la librería itext (itextpdf) usando Grapes.
Para usar esta herramienta es necesario importar lo siguiente:
import groovy.grape.Grape
Se deben cumplir estas convenciones:
- group: grupo de módulos a usar, la libreía o librerías a usar
- module: un módulo en específico de la librería
- version: la versión a usar
Entonces quedaría así:
@Grapes(@Grab(group='com.itextpdf', module='itextpdf', version='5.1.2'))
Defino que librería se va usar, el módulo y la versión.
Por lo tando también debemos importar las librerías necesarias para crear el documento PDF:
//para crear el archivo
import java.io.FileOutputStream
import java.io.IOException
//librería itextpdf para crear el documento PDF
import com.itextpdf.text.Document
import com.itextpdf.text.DocumentException
import com.itextpdf.text.Paragraph
import com.itextpdf.text.pdf.PdfWriter
Ahora creamos una función «principal» del programa y le agregamos la anotación @Grapes y @Grab:
@Grapes(@Grab(group='com.itextpdf', module='itextpdf', version='5.1.2'))
def principal() throws DocumentException, IOException {
//nombre del documento
def documento="micodigo.pdf"
Document document = new Document();
PdfWriter.getInstance(document, new FileOutputStream(documento));
document.open();
//el contenido del PDF
document.add(new Paragraph("Usando Grapes en Groovy"));
document.add(new Paragraph("www.lineadecodigo.com"));
document.close();
println "Se ha creado el documento PDF"
}
Ahora solo falta invocar esa función:
//método principal del programa
principal()
Compilamos:
groovyc UsoGrapes.groovy
Listamos las dependencias:
grape list
Y finalmente ejecutamos el programa:
groovy UsoGrapes.groovy
Si todo salio bien obtendremos un documento PDF.
