Grupo de Usurios Java

http://www.guj.com.br

Gerao de Relatrio com JasperReports e iReport

Carlos Feliz Paixo
Este documento descreve a instalao, configurao e utilizao de duas ferramentas open-source para a gerao de relatrios em Java: JasperReports e iReport. realizado um exemplo de gerao de relatrio no formato PDF, utilizando uma base de dados em Firebird, demonstrando assim o poder dessas ferramentas.

Introduo
Dentre as tarefas de um sistema, a mais comum a gerao de relatrio. Presente na maioria dos sistemas, mas muitas vezes no suficientemente reconhecida, esta tarefa constitui um importante mdulo do sistema. Basicamente, o processo de gerao de relatrio resume-se na definio do design e mapeamento de dados para campos dentro de um layout definido. Nesse contexto, surgiram ferramentas comerciais com intuito de auxiliar neste processo. No passado, essa rea foi completamente dominada por produtos comerciais, como o Crystal Reports, que com o passar do tempo tornaram-se cada vez mais robustos no que diz respeito a novas funcionalidades, como o suporte a diferentes tipos de fontes de dados. Porm, o que se v hoje o surgimento de ferramentas open-source com o mesmo objetivo, e to ou mais robustas que as comerciais, com a grande convenincia de serem gratuitas. o caso das ferramentas foco deste documento: JasperReports e iReport..

Links:
JasperReports: http://jasperreports.sourceforge.net iReport: http://ireport.sourceforge.net

JasperReports
JasperReports um poderoso framework open-source para gerao de relatrios. Escrito em Java, essa biblioteca apresenta grande habilidade na organizao e apresentao de contedo, permitindo a gerao dinmica de relatrios em diversos formatos, como PDF, HTML, XLS, CSV e XML, podendo ainda ser utilizada em qualquer aplicao Java, incluindo aplicaes desktop, Web e distribudas.

Funcionamento
Antes de iniciar a utilizar a biblioteca JasperReports, necessrio a compreenso de seu funcionamento (Veja a fig. 1). O design do relatrio, incluindo a localizao dos campos a serem preenchidos e seus respectivos nomes, para futuro mapeamento, so definidos em um arquivo XML atravs de tags XML que obedecem a uma estrutura, vocabulrio e restries declarados em um arquivo DTD (jasperreports.dtd). Usando XML, o designer pode definir textos estticos, imagens, linhas, formas geomtricas, como retngulos e elipses, e suas localizaes dentro do relatrio. Pode-se, ainda, e principalmente, definir os campos que sero preenchidos dinamicamente a partir de uma base de dados. O arquivo XML precisa ser compilado, gerando um arquivo .jasper, isto , contendo a verso compilada do cdigo XML. Isto implica na compilao de todas as expresses Java definidas no arquivo XML, sendo realizadas vrias verificaes em tempo de compilao. Diferentes objetos JasperReports so usados para representar as etapas do processo de gerao de relatrio: JasperDesign: Representa a definio do relatrio. A partir do template XML criado um JasperDesign. JasperReport: Representa o JasperDesign compilado. O processo de compilao verifica o design do relatrio e compila o design em um objeto JasperReport. JasperPrint: Representa o relatrio gerado. criado um JasperPrint a partir de um JasperReport, contendo o relatrio preenchido.

Dados
Para produzir um relatrio precisamos fornecer dados ao Jasper. Estes dados podem ser recuperados de diferentes lugares, como de uma base de dados em um SGBD ou em um arquivo XML. Para recuperarmos informaes de um banco de dados relacional, precisamos realizar uma consulta (query)

Grupo de Usurios Java http://www.guj.com.br Pgina 1

Grupo de Usurios Java

http://www.guj.com.br

em linguagem SQL. Essa query pode ser inserida ao cdigo XML ou ser realizada por uma classe Java, gerando um objeto ResulSet, que ser passado s classes do Jasper para o preenchimento do relatrio. O JasperReports suporta vrios tipos de datasources (fonte de dados) atravs de uma interface especfica chamada JRDataSource. H uma implementao padro desta interface para objetos ResultSet, chamada JRResultSetDataSource, ou seja, possvel realizar consultas, gerando objetos ResultSet e passando ao JasperReports para o preenchimento do relatrio. Quando a fonte de dados um ResultSet, este objeto deve conter todas as colunas a serem mapeadas para seus campos correspondentes no relatrio. A figura 1 ilustra o funcionamento do JasperReports:

Fig. 1: Etapas para a gerao de relatrio com JasperReports. No linguajar Jasper", um datasource somado a um arquivo .jasper gera um "print", que pode ser "exportado" para os formatos PDF, HTML, XML, CVS ou XLS.

Campos, Parmetros, Variveis e Expresses

Campos (Fields) so reas especficas que recebero diretamente os dados das respectivas colunas referenciadas. O relatrio deve conter um campo com o mesmo nome da coluna a qual faz referncia. Por exemplo, para os dados da coluna Nome do tipo VARCHAR, da tabela Cliente, serem mapeados para o relatrio, um campo Nome deve ser definido no arquivo XML da seguinte forma: <field name=Nome class=java.lang.String/> Parmetros so dados passados para a operao de preenchimento, que no podem ser encontrados normalmente na fonte de dados. So declarados, por exemplo, da seguinte forma: <parameter name=TituloDoRelatorio class=java.lang.String/> E passados via cdigo Java, atravs da classe HashMap: Map parametros = new HashMap( ); parametros.put( Cliente, Carlos Paixo ); Outra importante utilizao de parmetros na query do relatrio. Por exemplo: Select * FROM CLIENTE WHERE CLIENTE=$P{Cliente} O relatrio ser gerado apenas para o cliente passado por parmetro. Variveis so utilizadas para simplificar o projeto do relatrio. Atravs de uma varivel podemos definir somente uma vez uma expresso, que seja usada freqentemente durante o design do relatrio, chamando-a quando precisarmos daquela funcionalidade. Elas podem referenciar tipos internos de clculos, como contagem (count), soma (sum), mdia (average), menor (lowest), maior (highest), etc. Por exemplo, o clculo do valor total da compra: <variable name=ValorTotalCompraSum class=java.lang.Double calculation=Sum> <variable expression> ${ValorProduto} </variable expression> </variable> Em uma expresso, uma varivel pode referenciar outras variveis do relatrio, mas somente se aquelas variveis foram definidas previamente no projeto do relatrio. Assim, a ordem em que as variveis so declaradas no relatrio importante.
Grupo de Usurios Java http://www.guj.com.br Pgina 2

Grupo de Usurios Java

http://www.guj.com.br

Para as variveis que executam o clculo ns podemos especificar o nvel em que devem ser reinicializadas. O nvel Report (de relatrio) significa que a varivel ser inicializada somente uma vez, no comeo do relatrio, e que executa o clculo especificado at que o fim do relatrio seja alcanado. Mas ns podemos escolher executar o clculo em nvel de pgina, coluna ou de grupo. O exemplo abaixo demonstra o mesmo clculo anterior em nvel de pgina. Nossa varivel ser inicializada com zero no comeo de cada nova pgina: <variable name=ValorTotalCompraSum class=java.lang.Double resetType=Page calculation=Sum> <variable expression> ${ValorProduto} </variable expression> <initialValueExpression> new Double( 0 ) </initialValueExpression> </variable> Existem tambm variveis internas da ferramenta, com nomes auto-explicativos, prontas para o uso nas expresses: PAGE_NUMBER, COLUMN_NUMBER, REPORT_COUNT, PAGE_COUNT, COLUMN_COUNT, GroupName_COUNT. Expresses (Expressions) so utilizadas para especificar o contedo de campos de texto, na realizao de clculos freqentes, por exemplo. Todas elas so expresses Java que podem conter em sua sintaxe: campos, parmetros e variveis de relatrio. Por exemplo: <textFieldExpression> Sr.(a) + $F{Cliente} + " realizou um total de compras no valor de " + $V{ValorTotalCompraSum} + " no dia " + (new SimpleDateFormat("dd/MM/yyyy")).format($F{DataCompra}) + "." </textFieldExpression>

Layout
Para a melhor organizao e definio do design do relatrio, o JasperReports divide o layout em reas pr-definidas, chamadas sees. Ao projetar um relatrio ns necessitamos definir a posio do contedo dentro de uma seo, levando em considerao o que ela representa na estrutura visual de um relatrio. A seguir esto as sees em que baseado o layout de relatrio: title, pageHeader, columnHeader, groupHeader, detail, groupFooter, columnFoter, pageFooter, summary.

Mais detalhes
Enquanto escrevia, o JasperReports encontrava-se em sua verso 0.5.x, na qual se baseia este documento. Maiores informaes em: http://jasperreports.sourceforge.net.

iReport
Criar o design do relatrio diretamente em XML pode ser uma tarefa custosa. Necessitava-se, ento, de uma ferramenta que automatizasse esse processo. O iReport veio preencher essa lacuna, permitindo definir o design do relatrio dentro de um ambiente grfico, contento todos os recursos que a biblioteca Jasper oferece. possvel definir relatrios com designs modernos e complexos sem se quer escrever uma linha de cdigo XML, que todo gerado automaticamente. O ambiente ainda oferece atalhos para tarefas de compilao e visualizao do relatrio, permitindo a realizao de testes, acelerando assim o processo de design. importante salientar que existem outras ferramentas com o mesmo objetivo que o iReport, mas que no so suficientemente maduras, no que diz respeito a facilidade de uso, e principalmente, no suporte as tags XML do JasperReports.

Mais detalhes
Abaixo esto outras alternativas para o design grfico do relatrio: - JasperDesign (http://sourceforge.net/projects/jasperdesign) - JasperEdit (http://sourceforge.net/projects/jasperedit) - OpenReports (http://sourceforge.net/projects/oreports) - JasperJEdit (http://www.sourceillustrated.com/jasperjedit) - JasperPal (http://sourceforge.net/projects/jasperpal)

Grupo de Usurios Java http://www.guj.com.br Pgina 3

Grupo de Usurios Java

http://www.guj.com.br

Fonte de Dados
O iReport d suporte a conexes JDBC, ODBC, e 4 tipos de datasources: 1 Empty data source (JREmptyDatasource): um especial datasource usado para preencher relatrios que no possuem registros ou dados recuperados. Este datasource usado quando pressionado o boto run: 2 XML DataSource: um datasource capaz de empacotar um arquivo XML e normalizar seu contedo. As nicas informaes necessrias para criar este tipo de datasource so: o nome do datasource e o nome do arquivo XML. 3 JavaBeans Set Datasource: um datasource capaz de empacotar uma Collection ou um Array de JavaBeans. necessrio uma classe especial de fbrica (factory) que fornea um mtodo esttico para gerar a coleo ou um array de JavaBeans. Para criar este datasource voc precisa de um nome para o datasource, o nome da classe que fornece o mtodo esttico para recuperar o Array/Collection de objetos e o nome deste mtodo, que ter uma definio como esta: public static Collection createMyCollection( ) ou public static Object[ ] createMyArray( ) necessrio setar o tipo de resultado (Collection ou Array). 4 Custom Datasource: este tipo de datasource genrico. O iReport no sabe como a interface JRDataSource implementada por esta conexo particular, mas isto no importante. necessrio uma classe especial de fbrica (factory) que fornea um mtodo esttico que retorne um JRDataSource. Para criar este datasource voc precisa do nome do datasource, do nome da classe que fornece o mtodo esttico para recuperar o JRDataSource, e do nome deste mtodo que ter uma definio como esta: public static JRDataSource createMyJRDataSource( )

Mais detalhes
Enquanto escrevia, o iReport encontrava-se em sua verso 0.2.x, na qual se baseia este documento. Maiores informaes em: http://ireport.sourceforge.net.

Requisitos
Ambas as ferramentas possuem requisitos para o seu funcionamento, os quais so em sua maioria bibliotecas de terceiros, tambm gratuitas. Ao realizar o download opte pelos arquivos completos, pois estes possuem todas as bibliotecas necessrias. No necessrio baixar o jasperreports, pois o iReport j o traz em sua pasta lib, entretanto, interessante ver os exemplos e o javadoc fornecidos pelo JasperReports.

Mais detalhes
Voc pode ver a lista completa de requisitos para o JasperReports e iReport nos links abaixo: JasperReports: http://jasperreports.sourceforge.net/requirements.html iReport: http://ireport.sourceforge.net/cap2.html#2.1 Instalando e configurando
1. Descompacte os arquivos do iReport no diretrio de sua preferncia. Cheque nesse momento se sero criadas as pastas referentes. 2. Cheque se o JDK e o Ant esto devidamente configurados, ou seja, se as variveis de ambiente JAVA_HOME e ANT_HOME foram criadas e esto apontando para os diretrios corretos. Lembre-se de setar o PATH com JAVA_HOME\bin e ANT_HOME\bin, e o CLASSPATH com JAVA_HOME\lib e ANT_HOME\lib. No caso dos dados a serem usados forem recuperados de um banco de dados voc deve tambm setar no CLASSPATH o driver JDBC do banco. 3. Copie o arquivo tools.jar, localizado na pasta lib de seu JDK instalado, para os diretrio ...\iReport\lib 4. Copie o driver JDBC de seu banco para a pasta lib do iReport. 5. Para testar a instalao do iReport, abra o prompt, v ao diretrio do iReport e digite ant iReport. Outra opo editar o arquivo iReport.bat (para Windows) ou iReport.sh (para Linux), localizados na
Grupo de Usurios Java http://www.guj.com.br Pgina 4

Grupo de Usurios Java

http://www.guj.com.br

pasta iReport-0.2.x. Corrija as variveis para apontarem para os diretrios corretos, executando o arquivo de lote. Se tudo ocorreu bem o iReport ir inicializar. H tambm uma forma de iniciar o iReport sem ter o Ant instalado. Para isso, execute o arquivo de lote chamado startup.bat (Windows) e statrtup.sh (Linux) localizados na pasta noAnt do diretrio principal do iReport. 6. Ao iniciar, v ao menu Tools >> Options, ir surgir uma janela (vide Fig. 2) onde voc deve localizar a aba External Programs, setando ali todos os programas externos a serem utilizados como visualizadores de relatrio. Aps isso clique em Save.

Fig. 2: Setando programas externos.

Exemplo
O exemplo a seguir utiliza como fonte de dados uma base simples no SGBD open source Firebird, mas voc pode adaptar o exemplo para uma base e um SGBD qualquer, desde que este possua um driver JDBC ou ODBC, devidamente configurado. O driver JDBC tipo 4 (conexo direta com o banco) do Firebird chamado de Jaybird.

Mais detalhes
Abaixo esto os links para realizar o download dos arquivos e ferramentas necessrias para o exemplo: Firebird - http://firebird.sourceforge.net Jaybird - http://www.ibphoenix.com/main.nfs?a=ibphoenix&page=ibp_download Base de dados acervo.fdb
Obs.: Este documento no descreve como utilizar outros tipos de datasources, isto ser feito em outra oportunidade.

Criando uma conexo

Antes de mais nada devemos criar uma conexo com nossa fonte de dados: 1. Selecione o menu Datasources >> Connection/Datasources. A janela que aparece lista todas as fontes de dados e conexes JDBC que voc define. Clique no boto New para criar uma nova conexo (ou datasource).

Fig. 3: Lista de conexes / datasources.

Grupo de Usurios Java http://www.guj.com.br Pgina 5

Grupo de Usurios Java

http://www.guj.com.br

2. Na janela que aparece escolha o tipo de conexo (no nosso caso Database JDBC Connection). Na mesma janela d um nome conexo. Por exemplo, BibliotecaPessoal FB. 3. No campo JDBC Driver, selecione o driver do seu banco. Caso no esteja listado, como no nosso caso, especifique um de acordo com o seu SGBD. Para o Firebird, digite org.firebirdsql.jdbc.FBDriver, lembrando que o driver deve estar no classpath. 4. Em JDBC URL digitamos o caminho para a nossa base de dados: jdbc:firebirdsql:localhost/3050:c://db//Acervo.fdb Obs.: A sintaxe da URL difere de SGBD para SGBD, consulte a documentao de seu banco para saber a sintaxe exata. Repare tambm no caminho para a base de dados. 5. Em Server Address digite o caminho para servidor de banco de dados, no nosso caso localhost. Em Database, entre com o nome do banco (Acervo.fdb) ou do alias. Entramos, ento, com o user sysdba e password masterkey. Temos a possibilidade de salvar a senha marcando a opo Save password.

Fig. 4: Criando uma nova conexo JDBC. 6. Para testarmos a conexo clicamos no boto Test. No esquea que o SGBD precisa estar rodando. Se tudo ocorreu bem a seguinte mensagem ir aparecer:

Fig. 5: Teste de conexo bem sucedido. 7. O prximo passo ir ao menu Build >> Set active connection, escolhendo na janela que aparece a conexo com a base que iremos utilizar para preencher o relatrio, no nosso caso: BibilotecaPessoal FB.

Fig. 6: Escolhendo a conexo. Obs.: importante salientar que a configurao de uma conexo dentro do iReport no obrigatria, pois podemos utiliz-lo apenas para criar o design do relatrio e compil-lo. As tarefas de preenchimento, exportao para um formato (pdf, por exemplo), e visualizao, ficam de responsabilidade de uma classe
Grupo de Usurios Java http://www.guj.com.br Pgina 6

Grupo de Usurios Java

http://www.guj.com.br

Java. Porm, conveniente, at mesmo para a realizao dos testes, termos um nico ambiente que alm de permitir a definio do layout, tambm permita visualizarmos, em diversos formatos, o resultado do design e preenchimento do relatrio atravs de um simples boto (Run): . Para isso, neces-srio que a conexo JDBC esteja funcionando.

Criando o Design do Relatrio

Considerando que o teste de conexo com o banco foi bem-sucedido iniciamos a etapa de design do relatrio. 1. V ao menu File >> New Document ou clique no boto: 2. Ir aparecer a janela Report Properties onde damos um nome ao nosso relatrio (Report Name) chamando-o de RelatorioBibliotecaPessoal (no pode haver espao entre as palavras). Ainda na mesma janela podemos configurar o tamanho da pgina, a sua orientao, as margens, o comprimento, largura e o espao entre as colunas, alm de outras opes mais avanadas.

Fig. 7: Configurando a pgina do relatrio. 3. Agora podemos criar o design de nosso relatrio (fig. 8), utilizando a barra de ferramentas:

Inserimos os elementos do relatrio, bastando clicarmos uma vez sobre o respectivo boto e logo aps no relatrio. O contedo dos elementos de texto e as configuraes de fonte esto disponveis atravs de um duplo clique sobre o elemento, assim como as configuraes para os elementos geomtricos. Na figura 8, os textos Relatrio Biblioteca Pessoal, Data:, Cdigo, Ttulo, Volume, Edio, Editora, Autor e Adquirido em so campos de texto esttico: A tabela constituda de dois Retngulos arredondados: todos campos (fields). , enquanto os outros elementos so

Fig. 8: Design do relatrio.

Grupo de Usurios Java http://www.guj.com.br Pgina 7

Grupo de Usurios Java

http://www.guj.com.br

4. Para definir os campos (fields) para preenchimento , precisamos conhecer os nomes das colunas das tabelas de onde recuperaremos os dados. O iReport permite a insero do SQL no cdigo XML atravs do menu Datasource >> Report query ou clicando no boto: 5. No campo da janela que aparece, na aba Report SQL Query, digitamos nossa query. Levando em considerao que o resultado dessa consulta deve conter os dados que preenchero o relatrio, o SQL deve ser bem estruturado. A mesma janela nos permite visualizar os nomes dos campos que fazem parte do resultado da consulta. Por exemplo, se digitarmos a consulta SELECT * FROM LIVRO e em seguida clicarmos no boto Read Fields visualizaremos todas as colunas da tabela LIVRO de nosso banco, e seus respectivos tipos. Para inserir esta consulta no cdigo XML devemos clicar no boto Save query to report.

Fig. 9: Visualizando os nomes das colunas contidas no resultado da consulta. Obs.: Em nosso exemplo no iremos inserir o SQL no cdigo XML. Realizaremos a conexo com o banco e a consulta em nossa classe Java, passando o objeto ResultSet gerado para o JasperReports. 6. Agora que conhecemos os nomes das colunas e seus tipos, podemos definir nossos campos (fields) no relatrio, registrando-os para o mapeamento dos dados. Para tanto, na mesma janela selecione o primeiro campo (coluna) que aparece e, segurando a tecla Shift, clique no ltimo campo, pressionando o boto Register fields to report. A mesma tarefa pode ser realizada indo ao menu View >> Report fields ou clicando no boto: A janela que aparece permite o registro de campos, parmetros e a criao de variveis no relatrio:

Fig. 10: Registrando os campos (fields).

Grupo de Usurios Java http://www.guj.com.br Pgina 8

Grupo de Usurios Java

http://www.guj.com.br

7. Aps registrarmos as colunas a serem mapeadas, devemos inserir elementos fields que faro referncia a elas para serem preenchidos. Para isso, depois de inserir um field, damos um duplo clique nele, surgindo assim uma janela onde, na aba Text Field, em TextField Expression Class, configuraremos a classe referente ao tipo da coluna que queremos mapear; e em Textfield expression, o nome desta coluna entre $F{ e }. Por exemplo, para mapear a coluna CODIGO que do tipo INTEGER, selecionamos em TextField Expression Class, a classe java.lang.Integer, e em Textfield expression digitamos $F{CODIGO}. Realize o mesmo processo para as outras colunas (TITULO, AUTOR, VOLUME, EDICAO, EDITORA, DATA_ADQUIRIDO), atentando para o tipo da coluna.

Fig. 11: Mapeando a coluna CODIGO. 8. Podemos tambm criar expresses para efetuar clculos ou formataes sobre os dados provenientes das colunas mapeadas, assim como, optar a que nvel executar esta expresso. (veja Variveis e Expresses) Em nosso exemplo inserimos a dada atual de impresso do relatrio, formatando-a de acordo com o padro brasileiro. Para isso, inserimos um field, damos um duplo clique sobre ele, e na janela que aparece, na aba Text Field, digitamos a seguinte expresso Java no campo TextField Expression: new SimpleDateFormat( "dd/MM/yyyy" ).format( new Date( ) )

Fig. 12: Inserindo a data atual formatada no relatrio. Outro exemplo pode ser visto ao inserirmos o nmero das pginas de nosso relatrio. Para isso, utilizamos a varivel interna $V{PAGE_NUMBER}.

Grupo de Usurios Java http://www.guj.com.br Pgina 9

Grupo de Usurios Java

http://www.guj.com.br

Inserimos dois fields no relatrio. No primeiro, no campo Evaluation time, escolhemos o nvel de execuo Now, que considerar a pgina atual e para o segundo field, o nvel Report, que significa que a varivel ser inicializada somente uma vez, no comeo do relatrio, e que executa o clculo especificado at que o fim do relatrio seja alcanado, ou seja, a quantidade de total de pginas.

Fig. 13: Nmero da pgina atual.

Fig. 14: Nmero total de pginas.

9. Para informarmos ao iReport em que formato desejamos visualizar o relatrio, vamos ao menu Build, escolhendo uma das opes de visualizao ali existentes.

Fig. 15: Opes de visualizao. Obs.: Podemos agora realizar um teste, clicando no boto .

Gerando relatrio a partir de uma classe

Vimos at o momento como configurar e utilizar o iReport para montar o layout de nosso relatrio, e tambm visualiz-lo para fins de teste. Nesta seo, veremos na prtica como gerar um relatrio em formato pdf a partir de uma classe simples. A classe RelatorioBibliotecaPessoal ser apresentada e descrita posteriormente. Supe-se que voc j utilizou o iReport para criar o design do relatrio e definir os campos a serem preenchidos, que estas informaes foram salvas em um arquivo XML, e que este foi compilado neste mesmo ambiente, gerando um arquivo .jasper. Este ltimo arquivo (.jasper) ser utilizado pela classe a seguir: /* pacotes necessrios */ import dori.jasper.engine.*; import dori.jasper.view.JasperViewer; import java.sql.*; import java.util.*;
Grupo de Usurios Java http://www.guj.com.br Pgina 10

Grupo de Usurios Java

http://www.guj.com.br

public class RelatorioBibliotecaPessoal { /* Realiza conexo com o banco de dados, retornando o objeto Connection */ private static Connection getConnection( ) throws ClassNotFoundException, SQLException { String driver = "org.firebirdsql.jdbc.FBDriver"; String url = "jdbc:firebirdsql:localhost/3050:c://db//Acervo.FDB"; String user = "sysdba"; String password = "masterkey"; Class.forName(driver); Connection con = DriverManager.getConnection( url, user, password ); return con; } /* Gera Relatorio e visualiza-o */ public void geraRelatorio( ) throws JRException, Exception { Connection con = getConnection( ); Statement stm = con.createStatement( ); String query = "select * from Livro"; ResultSet rs = stm.executeQuery( query ); /* implementao da interface JRDataSource para DataSource ResultSet */ JRResultSetDataSource jrRS = new JRResultSetDataSource( rs ); /* HashMap de parametros utilizados no relatrio. Sempre instanciados */ Map parameters = new HashMap(); // parameters.put("COLUNA", valor); /* Preenche o relatrio com os dados. Gera o arquivo BibliotecaPessoal.jrprint */ JasperFillManager.fillReportToFile( "BibliotecaPessoal.jasper", parameters, jrRS );

/* Exporta para o formato PDF */ JasperExportManager.exportReportToPdfFile( "BibliotecaPessoal.jrprint" ); /* Preenche o relatorio e o salva diretamente em arquivo PDF. Sem a necessidade do .jrprint */ // JasperRunManager.runReportToPdfFile("BibliotecaPessoal.jasper", parameters, jrRS); /* Visualiza o relatrio em formato PDF */ JasperViewer.viewReport( "BibliotecaPessoal.pdf", false ); } public static void main(String[] args) throws JRException, Exception { new RelatorioBibliotecaPessoal().geraRelatorio(); } } Basicamente, a classe anterior realiza os seguintes passos: 1. O mtodo geraRelatorio() chama o mtodo getConnection() para realizar a conexo com o banco de dados e retornar um objeto Connection. 2. realizada a consulta sql, gerando um objeto ResultSet com os dados referentes ao preenchimento do relatrio. Este objeto passado ao construtor da classe JRResultSetDataSource (implementao padro da interface JRDataSource para ResultSet) do JasperReports, criando o objeto datasource (jrRS). 3. O objeto datasource (jrRS) passado como parmetro para o mtodo esttico fillReportToFile() da classe dori.jasper.engine.JasperFillManager para o preenchimento do relatrio, assim como o XML compilado (BibliotecaPessoal.jasper) e possveis parmetros (parameters). Este procedimento cria o arquivo (BibliotecaPessoal.jrprint) referente ao relatrio preenchido.

Grupo de Usurios Java http://www.guj.com.br Pgina 11

Grupo de Usurios Java

http://www.guj.com.br

Obs.: O HashMap de parmetros deve ser instanciado, mesmo no havendo a utilizao destes no relatrio. So exigidos por todos os mtodos de preenchimento do JasperReports. 4. O arquivo .jrprint (BibliotecaPessoal.jrprint) passado como parmetro para o mtodo exportReportToPdfFile() da classe dori.jasper.engine.JasperExportManager para exportar o relatrio para o formato pdf.

Mais detalhes
Outros formatos suportados pelo JasperReports podem ser obtidos a partir da utilizao de seus mtodos referentes. Consulte a documentao (javadoc) do JasperReports para conhec-los: http://jasperreports.sourceforge.net/api/index.html
Obs.: A classe dori.jasper.engine.JasperRunManager pode substituir a utilizao das classes JasperFillManager e JasperExportManager nos passos 3 e 4. Seu mtodo runReportToPdfFile(), por exemplo, recebe como parmetros o arquivo .jasper referente ao relatrio compilado, possveis parmetros (parameters) e o objeto JRResultSetDataSource. 5. Finalizando, utilizada a classe dori.jasper.viewer.JasperViewer, uma GUI para a visualizao do relatrio em pdf. Seu mtodo viewReport() recebe como parmetro o nome do arquivo de relatrio e um boolean referente ao formato do arquivo de relatrio, ou seja, true para arquivos XML e false para outro.

Concluso
Demonstramos a interao do JasperReports com o iReport, para a gerao de relatrios. Vimos como instalar e configurar o iReport, assim como utiliz-lo para desenhar relatrios estruturados que sero processados pelo JasperReports. Ambas as ferramentas demonstradas aqui, se completam e mostram-se poderosas, oferecendo ao desenvolvedor um amplo conjunto de recursos na organizao e apresentao de contedo de um relatrio. A utilizao destas, permite o rpido desenvolvimento de um relatrio estruturado e complexo de modo gil e facilitado.
Carlos Feliz Paixo (carlosfpaixao@yahoo.com.br) programador Java e estagirio de desenvolvimento do Servio Federal de Processamento de Dados (Serpro) Departamento SUNAT - Regional Belm-PA - usando JasperReports (jasperreports.sourceforge.net) e iReport (ireport.sourceforge.net) para a gerao de relatrios.

Grupo de Usurios Java http://www.guj.com.br Pgina 12