Você está na página 1de 164

C:\Users\LucilioRocha\Documents\NetBeansProjects\GesTenis\relatorios\reportFornecedor.jr

xml

JasperReports: Trabalhando com Relatórios em Java Parte 1 (Configurando o Ambiente)

09/10/2010

28 Votes

Parte 1 Parte 2 Parte 3 Parte 4 Parte 5

Olá a todos. Quem acompanha o blog sabe que no último post há duas semanas atrás eu pedi que vocês sugerissem o tema para o próximo tutorial. Dentre os temas que eu listei, o de criação de relatórios em Java foi o que ganhou. Este tutorial, como o de Flex e Java, vai ser dividido em algumas partes. Eu poderia escrever em apenas um post tudo sobre o tema, mas preferi dividir o tutorial em várias partes pequenas menores que os tutoriais sobre Flex para não ficar muito cansativo.

Nesta primeira parte (provavelmente a maior de todas), iremos aprender sobre o framework para criação relatórios que iremos utilizar, o JasperReports, entendendo seu funcionamento, aprendendo a obter e instalar o iReport, que é o editor de relatórios e preparar nosso ambiente de desenvolvimento. Irei novamente utilizar o NetBeans como IDE de desenvolvimento, mas você que usa o Eclipse ou qualquer outra IDE Java não vai ter dificuldades para seguir o tutorial.

Na segunda parte, iremos criar uma base de dados de teste para popularmos nossos relatórios e vamos aprender como criar, compilar e utilizar os relatórios criados em aplicações desktop. Na terceira parte, iremos aprender a criar subrelatórios. Na quarta, iremos utilizar fontes de dados data sources diferentes, permitindo então que possamos listar dados nos relatórios que não vem somente de consultas SQL. Por fim, na quinta e última parte, iremos aprender como utilizar nossos relatórios em uma página Web. Após todas essas partes, vocês terão a bagagem necessária para caminharem sozinhos ;)

Então, vamos começar!

Existem atualmente na indústria diferentes frameworks e engines para criação e processamento de relatórios. Dentre as soluções pagas, talvez o Crystal Reports seja a mais conhecida. O Crystal Reports é uma solução robusta e que pode ser utilizada com diversas linguagens de programação. Outra solução paga que é muito utilizada por quem trabalha com Delphi é o Quick Reports. Em Java, existem atualmente duas soluções que são mais utilizadas. O JasperReports, que é o framework gratuito mais popular e que iremos utilizar nos nossos tutoriais e o BIRT (Business Intelligence and Reporting Tools) que também é gratuito e é mais utilizado por quem trabalha com o Eclipse.

Como iremos utilizar o JasperReports, vale a pena então entendermos um pouco do seu funcionamento. Quando trabalhamos com ele, nós criamos os arquivos de código fonte dos nossos relatórios utilizando XML, sendo que esse arquivo fonte de extensão .jrxml passa por um processo de compilação para gerar gerar arquivos .jasper, que por sua vez são interpretados pela engine do JasperReports. Nós não iremos escrever esses arquivos .jrxml na mão, pois iremos construir nossos relatórios utilizando um editor WYSIWYG (What You See Is What You Get), o iReport. Atualmente, o iReport pode ser obtido em duas versões. Uma delas é standalone (criada usando a NetBeans Platform), não precisando de nenhum outro programa para ser utilizada, enquanto a outra é um plugin para o NetBeans. Iremos utilizar a versão em plugin.

Bem, já falei demais. Chega de blablablá, vamos começar a por a mão na massa, afinal essa é a melhor forma de aprender :D. Primeiro vamos baixar o iReport. Acesse então o endereço http://jasperforge.org/projects/ireport e procure o link de download. Na versão atual do site, para fazer o download, basta clicar no botão ―Download iReport Now―. Ao clicar no botão, serão apresentadas as versões disponíveis. Nós vamos escolher a última:

Plugin for NetBeans IDE 3.x. A versão atual do iReport é a 3.7.5. Note que a versão do iReport sempre vai ser a mesma do JasperReports.

Quando terminar de baixar, descompacte o arquivo ―iReport-3.7.5-plugin.zip‖ (a versão pode variar dependendo de quando você baixar o pacote). Serão extraídos 4 arquivos com a extensão .nbm (NetBeans Module). Esses arquivos são os pacotes dos plugins que serão instalados no NetBeans. Com o arquivo descompactado, abra então o seu NetBeans. Estou usando a útlima versão, 6.9.1. Com o NetBeans aberto, vá no menu Tools (Ferramentas) e escolha Plugins. Ao abrir o gerenciador de plugins, vá na aba Downloaded (Baixados?). É nessa aba que você instala os arquivos .nbm. Clique em Add Plugins (Adicionar Plugins). Veja a Figura abaixo:

Gerenciador de Plugins Ao clicar no botão Add Plugins , um diálogo será aberto. Neste

Gerenciador de Plugins

Ao clicar no botão Add Plugins, um diálogo será aberto. Neste diálogo, procure então pelos arquivos .nbm que foram descompactados a partir do pacote que fizemos download. Assim que os encontrar, selecione todos e clique Open (Abrir). Veja a Figura abaixo.

Escolhendo os pacotes Ao fazer isso, a janela do gerenciador de plugins será exibida novamente,

Escolhendo os pacotes

Ao fazer isso, a janela do gerenciador de plugins será exibida novamente, só que agora com os quatro pacotes sendo exibidos. Deixe os quatro pacotes marcados e clique em Install (Instalar). Veja a Figura abaixo.

Gerenciador de Plugins (instalação) No primeiro passo do instalador, clique em Next (Próximo). Marque o

Gerenciador de Plugins (instalação)

No primeiro passo do instalador, clique em Next (Próximo). Marque o checkbox para concordar com os termos da instalação e clique em Install. Aguarde o final da instalação. Quando a instalação terminar, provavelmente o NetBeans vai pedir para ser reiniciado. Reinicie a IDE. Quando o ambiente estiver aberto novamente, você vai perceber que na barra de ferramentas foi inserido um novo botão e um combobox. Ainda não iremos aprender para que eles servem, por enquanto entenda que eles fazem parte do plugin do iReport. Veja a Figura abaixo.

fazem parte do plugin do iReport. Veja a Figura abaixo. Barra de ferramentas alterada Com o

Barra de ferramentas alterada

Com o iReport instalado, vamos agora preparar a estrutura de uma aplicação que iremos usar nas próximas partes do tutorial. Inicie a criação de um novo projeto no NetBeans escolhendo um projeto do tipo Java Application (Aplicação Java). Veja a Figura abaixo.

Novo projeto Clique em Next . Em seguida, dê o nome ao projeto, sugiro ―TutorialRelatorios‖

Novo projeto

Clique em Next. Em seguida, dê o nome ao projeto, sugiro ―TutorialRelatorios‖ (sem as aspas), escolha onde o projeto vai ser salvo e marque a opção Use Dedicated Folder for Storing Libraries (essa opção vai fazer com que todos os arquivos .jar utilizados fiquem contidos dentro do projeto, sob o diretório ―lib‖), configure as outras opções de acordo com a Figura abaixo e clique em Finish.

Configurando o novo projeto Ao clicar em Finish, o projeto vai ser criado. A partir

Configurando o novo projeto

Ao clicar em Finish, o projeto vai ser criado. A partir de agora já poríamos começar a criar nossos relatórios no iReport, mas ainda faltam algumas configurações para que possamos fazer esses relatórios executarem dentro de uma aplicação. Para isso, ainda temos que adicionar o JasperReports no nosso projeto, bem como todas as suas dependências, além de termos também que organizar a estrutura do projeto para guardar nossos relatórios.

Primeiro vamos tratar dos .jars. Ao instalar os plugins do pacote do iReport, uma biblioteca padrão com os .jars é criada, mas ela vem com alguns erros, então vamos criar a nossa biblioteca para não termos dores de cabeça depois. Para isso, expanda o nó raiz do projeto e procure pelo nó Libraries (Bibliotecas). Clique com o botão direito e escolha Add Library (Adicionar Biblioteca). Veja a Figura abaixo.

Nova biblioteca Ao clicar em Add Library , o diálogo para a inserção de bibliotecas

Nova biblioteca

Ao clicar em Add Library, o diálogo para a inserção de bibliotecas será exibido. Neste diálogo, clique no botão Create… (Criar). Veja a Figura abaixo.

clique no botão Create… (Criar). Veja a Figura abaixo. Criando uma nova biblioteca Ao clicar em

Criando uma nova biblioteca

Ao clicar em Create, será exibido um novo diálogo, onde o nome e o tipo da nova biblioteca devem ser definidos. Em Library Name (Nome da Biblioteca), configure

como ―JasperReports-3.7.5″, lembrando de mudar o número da versão caso esteja utilizando uma versão mais nova. Em Library Type (Tipo da Biblioteca), deixe como Class Libraries (Bibliotecas de Classe). Por fim, clique no botão OK. Veja a Figura abaixo.

Classe). Por fim, clique no botão OK. Veja a Figura abaixo. Criando uma nova biblioteca Ao

Criando uma nova biblioteca

Ao clicar em OK, será exibido o diálogo Customize Library (Personalizar Biblioteca?).

É

nele que indicaremos os .jars que fazem parte da nossa biblioteca. Quando instalamos

o

plugin do iReport no NetBeans é criada uma pasta chamada ―ireport‖ dentro do

diretório de instalação e é lá que estão os .jars que precisamos. Sabendo disso, clique então no botão Add JAR/Folder (Adicionar JAR/Diretório). Veja a Figura abaixo.

Adicionando os JARs Com o diálogo aberto, procure pelo diretório onde a instalação do NetBeans

Adicionando os JARs

Com o diálogo aberto, procure pelo diretório onde a instalação do NetBeans foi feita. No meu caso, ele foi instalado em C:\Program Files (x86)\NetBeans 6.9.1\. Dentro deste diretório, procure pelo diretório chamado ―ireport‖ e entre nele. O conteúdo do diretório é exibido na Figura abaixo, sendo que os diretórios que nos interessam são o diretório ―libs‖ e o diretório ―modules‖ destacados na Figura.

libs e modules Primeiramente, acesse o diretório ―libs‖. Dentro dele, existe apenas um .jar (para

libs e modules

Primeiramente, acesse o diretório ―libs‖. Dentro dele, existe apenas um .jar (para a versão 3.7.5 do iReports). Selecione esse .jar (xalan.jar) e clique em Add JAR/Folder. Veja a Figura abaixo.

e clique em Add JAR/Folder . Veja a Figura abaixo. Adicionando xalan.jar Ao clicar, o NetBeans

Adicionando xalan.jar

Ao clicar, o NetBeans vai perguntar se você deseja mesmo criar um diretório dentro do diretório ―libs‖ (aquele que vai guardar nossas bibliotecas) com o nome de

JasperReports-3.7.5 (o nome que demos para a biblioteca, lebram?). Responda Sim. Veja a Figura abaixo.

a biblioteca, lebram?). Responda Sim. Veja a Figura abaixo. Alerta de criação de novo diretório Ao

Alerta de criação de novo diretório

Ao aceitar a criação do novo diretório, a janela Customize Libraries voltará a aparecer, agora com o xalan.jar sendo mostrado na lista de .jars. Além da pasta ―libs‖, precisamos adicionar também os .jars que estão dentro da pasta ―modules‖. Então clique novamente no botão Add JAR/Folder da janela Customize Libraries e entre no diretório ―modules‖. Dentro dele existirão alguns .jars, mas não são eles que queremos. Note que além dos .jars, existe um diretório chamado ―ext‖. Entre nele. Neste diretório estão TODAS as dependências do JasperReports. Para facilitar as coisas, iremos selecionar TODOS os .jars. Em um projeto real, o mais sensato seria selecionar apenas os .jars que você tem certeza que vão ser utilizados. Entretanto, esta abordagem traz um problema. O Jasper utiliza nos bastidores muitos desses .jars, mesmo que a gente pense que não. Um exemplo é o spring.jar :(. E o pior! A cada versão, as dependências mudam (já tive vários problemas com isso). Minha recomendação é que você selecione TODOS os .jars, e depois, caso já utilize um deles (por exemplo o Hibernate) recomendo então que você atualize o .jar para a versão mais nova. Enfim, selecione TODOS e clique em Add JAR/Folder. Veja a Figura abaixo.

você atualize o .jar para a versão mais nova. Enfim, selecione TODOS e clique em Add

Jars do diretório modules/ext

Ao fazer isso, novamente a janela Customize Library vai ser exibida, mostrando que todos os .jars foram inseridos. Clique em OK. Ao clicar, o diálogo Add Library será exibido novamente, mas agora com a nova biblioteca criada. Selecione-a (já vai estar selecionada por padrão) e clique em Add Library. Veja a Figura abaixo.

padrão) e clique em Add Library . Veja a Figura abaixo. Adicionando a biblioteca no projeto

Adicionando a biblioteca no projeto

Fazendo isso, o diálogo será fechado e você vai perceber que todos os .jars aparecerão dentro do projeto. Veja a Figura abaixo.

Projeto com a biblioteca adicionada Ok, já temos a biblioteca configurada com todos os .jars

Projeto com a biblioteca adicionada

Ok, já temos a biblioteca configurada com todos os .jars do JasperReports. Agora vamos criar um diretório no nosso projeto para conter as definições dos nossos relatórios (arquivos .jrxml). Para isso, clique com o botão direito no nó raiz do projeto e escolha Properties (Propriedades). Veja a Figura abaixo.

Acessando as propriedades do projeto Ao clicar em Properties , a janela de propriedades do

Acessando as propriedades do projeto

Ao clicar em Properties, a janela de propriedades do projeto será exibida. Nesta janela, selecione o primeiro nó à esquerda (Source Fonte) e do lado direito, na tabela Source Package Folders, clique em Add Folder… (Adicionar Diretório). Veja a Figura abaixo.

Propriedades do projeto Ao clicar em Add Folder , um diálogo será exibido. Neste diálogo,

Propriedades do projeto

Ao clicar em Add Folder, um diálogo será exibido. Neste diálogo, clique no botão localizado no canto superior direito. Veja a Figura abaixo.

Botão para criar um novo diretório Com isso, um novo diretório será criado. Dê o

Botão para criar um novo diretório

Com isso, um novo diretório será criado. Dê o nome de ―relatorios‖ (sem as aspas e sem acento agudo), selecione-o e clique em Open. Veja a Figura abaixo.

Diretório "relatorios" criado Ao clicar em Open , o novo diretório será inserido na tabela

Diretório "relatorios" criado

Ao clicar em Open, o novo diretório será inserido na tabela Source Package Folders. Na primeira coluna é apresentado o caminho do diretório, enquanto na segunda coluna é apresentado o label que vai identificar esse diretório dentro do projeto. Clique duas vezes na célula da segunda coluna que corresponde ao label do diretório criado e dê o nome de ―Relatórios‖. Cuidado! Ao terminar de editar o nome, tecle <ENTER>. Veja a Figura abaixo.

Configurando o novo diretório Ao fazer isso, o label será configurado (saindo da edição) e

Configurando o novo diretório

Ao fazer isso, o label será configurado (saindo da edição) e você agora deve clicar no botão OK das propriedades do projeto, aceitando assim as modificações que foram feitas. Veja a Figura abaixo.

Aceitando as configurações Pronto, terminamos a configuração do projeto. Se tudo tiver dado certo, o

Aceitando as configurações

Pronto, terminamos a configuração do projeto. Se tudo tiver dado certo, o novo diretório será exibido na estrutura do projeto, sendo que ele será identificado pelo label que foi configurado no passo anterior. Veja a Figura abaixo.

C:\Program Files\IreportPlugins

Estrutura do projeto atualizada Com isso terminamos a primeira parte do tutorial. Aprendemos alguns conceitos

Estrutura do projeto atualizada

Com isso terminamos a primeira parte do tutorial. Aprendemos alguns conceitos sobre o JasperReports e como instalar o iReport. Aprendemos também a criar e a inserir uma nova biblioteca no projeto, sendo que essa biblioteca corresponde aos .jars necessários para nós utilizarmos o JasperReports no nosso programa (quando formos abrir o relatório a partir do programa). Além disso, aprendemos a criar um diretório dedicado aos nossos relatórios. Então é isso. Terminamos a primeira parte do tutorial. Com o cenário pronto, agora podemos começar a brincar com o iReport e criar nossos primeiros relatórios.

O projeto completo até o momento pode ser obtido neste link.

Fiquem ligados, a próxima parte vem ai ;)

Parte 1 Parte 2 Parte 3 Parte 4 Parte 5

JasperReports: Trabalhando com Relatórios em Java Parte 2 (Primeiros Relatórios)

10/10/2010

22 Votes

Parte 1 Parte 2 Parte 3 Parte 4 Parte 5

Olá! Nesta segunda parte do tutorial sobre criação de relatórios, vamos fazer nossos primeiros exemplos, entretanto, para que possamos ver algum resultado, ou seja, nossos relatórios preenchidos com valores, precisamos de uma base de dados para extrairmos tais dados. Ao invés de criar uma base de dados na mão, iremos utilizar uma base já pronta. Nos nossos exemplos, vamos utilizar o MySQL como SGBD e iremos utilizar também o ―Sakila Sample Database‖ para extrairmos nossos dados. Essa base de dados, é uma base de exemplo que é disponibilizada no site no MySQL (http://dev.mysql.com/doc/sakila/en/sakila.html), que pode ser usada por desenvolvedores para fazer testes com consultas SQL. Como nossos primeiros relatórios vão trabalhar exclusivamente com SQL, vamos utilizar essa base de dados para facilitar nossa vida.

Então, mãos a obra! Primeiramente, acesse http://dev.mysql.com/doc/index-other.html e procure por ―Sample Databases―. Nesta seção, são apresentadas algumas bases de dados de exemplo que podemos baixar. Procure pela sakila database e baixe a base de dados escolhendo o formato desejado (TGZ ou Zip) na primeira coluna. Para facilitar, este link é o link para baixar a versão em Zip.

Quando terminar de baixar o arquivo, descompacte-o. Dentro dele estão contidos três arquivos:

1. sakila-schema.sql: é a estrutura da base de dados;

2. sakila-data.sql: são os dados da base de dados;

3. sakila.mwb: é um projeto do MySQL workbench (http://wb.mysql.com/).

Vamos então carregar os dois primeiros arquivos para o nosso SGBD. Para isso, abra o MySQL Command Line Client, digite a senha do root e tecle <ENTER> para fazer o login. Se estiver usando Linux, ou estiver com o bin do MySQL configurado no PATH do Windows, faça o login no MySQL usando o comando ―mysql -u root -p‖ (sem as aspas). Quando estamos logados no interpretador do MySQL, podemos utilizar alguns comandos para a administração das bases de dados existentes. Um desses comandos é o ―source‖ que é utilizado para carregar e executar comandos do SGBD que estão contidos em um arquivo de texto. Vamos utilizar então este comando para carregar os dois primerios arquivos do sakila database (a estrutura e os dados). Copiei os arquivos sakila-schema.sql e sakila-data.sql para o C: para facilitar a digitação do comando. Veja

na Figura abaixo o comando sendo usado para a carga do primeiro arquivo (sakila- schema.sql).

usado para a carga do primeiro arquivo (sakila- schema.sql). Usando o comando source para carregar o

Usando o comando source para carregar o arquivo sakila-schema.sql

Assim que você digitar o comando ―source C:/sakila-schema.sql;‖ (sem as aspas) e teclar <ENTER>, você vai ver que o interpretador do MySQL vai começar a processar o arquivo, gerando várias saídas. Se tudo der certo, uma base de dados chamada ―sakila‖ será criada, bem como todas as tabelas da sua estrutura. Se quiser verificar que a base de dados foi criada, basta dar o comando ―show databases;‖ (sem as aspas) para listar as bases de dados existentes.

Como exercício, da mesma forma que você carregou o arquivo sakila-schema.sql, você deve agora carregar o sakila-data.sql. Novamente os comandos serão processados e agora, além da estrutura da base de dados (criada no passo anterior), temos também vários dados para podermos utilizar em nossas consultas SQL e consequentemente em nossos relatórios, mas antes de partirmos para os relatórios, vamos falar um pouquinho da base de dados sakila. A seguir, uma imagem da estrutura da base, carregada no MySQL Workbench (clique na imagem para ampliar).

Estrutura da base de dados sakila Na base de dados sakila estão modeladas diversas tabelas

Estrutura da base de dados sakila

Na base de dados sakila estão modeladas diversas tabelas que representam os dados de uma locadora de DVDs fictícia. Não vou ficar comentando cada tabela, pois apenas com

a leitura do diagrama você vai conseguir entender os relacionamentos entre as elas, afinal, se você trabalha com bases de dados isso devere ser trivial :D.

Pronto! Agora sim! Vamos aos relatórios! Abra o NetBeans (se ainda não estiver aberto) e carregue o projeto que criamos na Parte 1 do tutorial. Caso você só tenha lido

o tutorial, não se preocupe, você pode baixar o projeto feito na Parte 1 neste link. Com o projeto aberto, expanda o nó ―Relatórios‖ do projeto. Você vai notar a existência do default package (pacote padrão). É nele que vamos criar os arquivos de código fonte dos nossos relatórios. Sendo assim, clique com o botão direito neste pacote e escolha New -> Other… (Novo -> Outro…). Veja a Figura abaixo.

Novo arquivo Ao clicar em Other… a janela de novo arquivo arquivo será aberta. Em

Novo arquivo

Ao clicar em Other… a janela de novo arquivo arquivo será aberta. Em Categories (Categorias) escolha Report (Relatório) e em File Types (Tipos de Arquivo) escolha Empty report (Relatório vazio) e clique em Next (Próximo). Veja a Figura abaixo.

Novo arquivo fonte de relatório Ao clicar em Next , preencha o campo File Name

Novo arquivo fonte de relatório

Ao clicar em Next, preencha o campo File Name (Nome do Arquivo) com ―Clientes‖ (sem as aspas) e clique em Finish (Finalizar/Terminar). Veja a Figura abaixo.

Criando o novo arquivo fonte de relatório Ao clicar em Finish , o arquivo de

Criando o novo arquivo fonte de relatório

Ao clicar em Finish, o arquivo de código fonte do relatório será criado (Clientes.jrxml) e a interface de edição do relatório será aberta, com o arquivo Clientes.jrxml carregado. Note que neste primeiro relatório, vamos simplesmente listar os dados de todos os clientes, que por sua vez estão contidos na tabela customer da base de dados sakila.

Vamos agora conhecer a interface do editor do iReport. A Figura abaixo contém diversas áreas numeradas que serão explicadas logo à seguir.

Interface gráfica do editor WYSIWYG do iReport 1. Gerenciamento de Datasources (Fontes de Dados): A

Interface gráfica do editor WYSIWYG do iReport

1. Gerenciamento de Datasources (Fontes de Dados): A área 1, destacada em amarelo, é utilizada para gerenciar os datasources que podem ser utilizados nos testes dos relatórios que estão sendo criados;

2. Área de edição do relatório: A área 2, destacada em azul escuro, contém o editor visual do relatório (descrito no item 3 a seguir), além de alguns botões onde podemos visualizar o editor WYSIWYG (Design), o código fonte do relatório (XML) e visualizar o relatório sendo executado (Preview), além de podermos configurar a forma que o relatório vai obter os dados que serão obtidos atravéz do datasource utilizado (primeiro botão após o botão Preview);

3. Editor do relatório: Essa área é utilizada para editar o formato do relatório, onde cada texto vai aparecer, quais bandas ele vai ter, etc. Existem vários tipos de bandas. As que são exibidas por padrão são:

o

Title: correponde ao cabeçalho do relatório. Aparece somente na primeira página;

o

Page Header: cabeçalho da página. Aparece em todas as páginas;

o

Column Header: cabeçalho das colunas. Aparece em todas as páginas;

o

Detail: exibe os dados provenientes do datasource, ou seja, são os dados que queremos mostrar no relatório;

o

Column Footer: rodapé das colunas. Aparece em todas as páginas;

o

Page Footer: rodapé da página. Aparece em todas as páginas;

o

Summary: resumo do relatório. Aparece apenas na última página.

5.

Propriedades: Área utilizada para exibir e editar as propriedades de um componente que esteja selecionado;

6. Report Inspector: É nesta área que as configurações do relatório são acessadas, como quais parâmetros ele contém, quais os campos que são utilizados, quais bandas estão visíveis, etc.;

7. Saída (Output): Nesta área são exibidos as saídas da execução e compilação do relatório corrente.

Se a explicação de cada área ficou confusa, não se preocupe. Você vai entender tudo daqui a pouco. Vamos começar então a mexer no nosso primeiro relatório. Primeiro então temos que configurar um datasource que vai trazer os dados de algum lugar. Note que esse datasource é utilizado apenas durante a edição do relatório. Quando formos executar o relatório dentro de um programa, teremos que passar o datasource programaticamente, mas isso nós vamos aprender depois. Pois bem, clique então no botão Report datasources (Fontes de dados do relatório). Veja a Figura abaixo.

(Fontes de dados do relatório). Veja a Figura abaixo. Botão Report datasources Ao clicar neste botão,

Botão Report datasources

Ao clicar neste botão, a janela de gerenciamento de datasources será exibida. Por padrão, apenas um datasource vai estar configurado no iReport. Este datasource, o Empty datasource (fonte de dados vazia) pode ser utilizado para visualizarmos apenas a estrutura do relatório. Vamos então criar o datasource para a base de dados sakila. Para isso, clique no botão New (Novo). Veja a Figura abaixo.

Gerenciador de datasources Ao clicar em New , uma nova janela será exibida. Nesta janela

Gerenciador de datasources

Ao clicar em New, uma nova janela será exibida. Nesta janela escolhemos o tipo de datasource que vamos utilizar. No nosso caso, é um Database JDBC connection, pois iremos obter os dados no nosso relatório utilizando uma query SQL, que por sua vez vai ser executada através de uma conexão JDBC. Por padrão, este tipo de datasource é o que vai estar selecionado no assistente. Caso não esteja selecionado, selecione-o e clique em Next. Veja a Figura abaixo.

Escolhendo o tipo de datasource Ao clicar em Next , a janela de configuração do

Escolhendo o tipo de datasource

Ao clicar em Next, a janela de configuração do datasource vai ser exibida. Nela precisamos preencher alguns campos:

Name: nome do datasource. Utilize ―Sakila – JDBC‖ (sem as aspas);

JDBC Driver: o tipo de driver que vamos utilizar. No nosso caso, é o driver do MySQL;

JDBC URL: endereço do banco de dados que queremos utilizar. No nosso caso é ―jdbc:mysql://localhost/sakila‖ (sem as aspas);

Username: nome do usuário. Estamos trabalhando em um ambiente de desenvolvimento, então vamos usar o root;

Password: senha do usuário. No meu caso a senha do root é root também;

Save password: salvar a senha utilizada. Pode deixar marcada essa opção, se não, toda hora que fizermos uma conexão, o iReport vai pedir a senha do usuário.

Obs: os campos Server Address e Database são preenchidos apenas se você quiser usar o Wizard (botão Wizard) para preencher a URL de conexão. Como já

sabemos o formato da URL para o MySQL e já preenchemos o endereço, não precisamos usar esses campos do Wizard.

Com tudo preenchido, clique em Save (Salvar). Veja a Figura abaixo.

preenchido, clique em Save (Salvar). Veja a Figura abaixo. Configurando o novo datasource Ao salvar o

Configurando o novo datasource

Ao salvar o datasource, a janela anterior será exibida, mostrando que o novo datasource foi configurado e está marcado como default (Padrão). Clique em Close para fechar a janela. Fazendo isso, você vai ver que o combobox que contém os datasources estará exibindo o datasource padrão, ou seja, o ―Sakila – JDBC‖ que criamos. Isso significa que quando formos criar uma query SQL no nosso relatório ou formos executá-lo para testar (Preview), o iReport vai usar o datasource que estiver selecionado neste combo. Novamente, reforço a ideia que este datasource é utilizado APENAS durante o desenvolvimento do relatório, seja na montagem de queries ou testes do relatório. Quando formos colocar o relatório para ser aberto em nosso programa, teremos que

passar programaticamente o datasource que o nosso relatório irá usar. Veja a Figura abaixo.

que o nosso relatório irá usar. Veja a Figura abaixo. Datasource "Sakila - JDBC" selecionado Muito

Datasource "Sakila - JDBC" selecionado

Muito bem. Configuramos o datasource que vamos utilizar e ele já está selecionado. Vamos agora ao relatório. Vamos agora editar a query SQL do Clientes.jrxml. Para isso, clique no botão que está destacado na Figura abaixo.

isso, clique no botão que está destacado na Figura abaixo. Acessando o editor de queries Ao

Acessando o editor de queries

Ao clicar no botão, a janela mostrada na Figura abaixo vai ser exibida.

Editor de queries Nesta janela é que vamos editar a query do nosso relatório. Ao

Editor de queries

Nesta janela é que vamos editar a query do nosso relatório. Ao inserir a query, os campos que ela retorna serão automaticamente carregados. Para este relatório, queremos listar todos os Clientes da locadora de DVDs, então iremos usar a query ―SELECT * FROM customer;‖ (sem as aspas). Assim que a query for preenchida e executada com sucesso, todos os campos que a execução dela retornar serão carregados, sendo que seus respecitvos tipos também serão obtidos. Veja a Figura abaixo.

Execução da query e carga dos campos Observando a Figura acima, você pode perceber que

Execução da query e carga dos campos

Observando a Figura acima, você pode perceber que ao executar a query informada foram obtidos os campos customer_id (tipo Integer), store_id (tipo Integer), first_name (tipo String) e assim por diante. Ao clicar em OK, esses campos (note que estão selecionados) serão inseridos na definição do relatório, bastando agora nós pegarmos esses campos e inserir cada um deles, ou os que nos forem relevantes, no Design do relatório. Para pegar os campos, expanda o nó Fields (Campos) do Report Inspector. Veja a Figura abaixo.

Campos inseridos na definiçao do relatório Suponha que queremos mostrar em nosso relatório apenas o

Campos inseridos na definiçao do relatório

Suponha que queremos mostrar em nosso relatório apenas o nome, o sobrenome e o e- mail de cada cliente. Sendo assim, selecione primeiro o campo ―first_name‖ e arraste para a banda Detail do relatório. Veja a Figura abaixo.

Iniciando a criação do relatório Note que onde você soltou o campo fist_name (na bada

Iniciando a criação do relatório

Note que onde você soltou o campo fist_name (na bada Detail), foi inserida uma caixa de texto do tipo Text Field (veja a paleta de componentes) com o valor $F{first_name}, onde $F denota o uso de um campo (F de Field) e o valor entre chaves é o nome do campo. Na banda Column Header foi inserida outra caixa de texto, só que apenas com o valor first_name. Essa caixa de texto inserida no cabeçalho da coluna é do tipo Static Text, ou seja, é um texto estático. Vamos mudar então o valor dessa segunda caixa para ―Nome‖ (sem as aspas) e organizar tanto a caixa de texto estático quanto a de texto dinâmico. Veja a Figura abaixo.

Organizando o relatório Vamos testar agora o relatório, afinal, queremos vê-lo funcionando. Procure pelo botão

Organizando o relatório

Vamos testar agora o relatório, afinal, queremos vê-lo funcionando. Procure pelo botão Preview e clique nele. O relatório será compilado e exibido. Veja a Figura abaixo.

Visualizando o relatório Legal, já estamos vendo os dados que vem do banco de dados

Visualizando o relatório

Legal, já estamos vendo os dados que vem do banco de dados no relatório, mas afinal, qual o motivo de um nome estar tão distante do outro? O motivo é que a banda Detail está muito alta. A altura da banda Detail sempre vai ser replicada para cada registro encontrado. Então, para melhorar isso, vamos diminuir a altura da banda Detail. Volte então na visualização no Designer (usando o botão Designer), selecione a linha azul no limite inferior da banda Detail e arraste até chegar na altura desejada. Caso você queira que a banda fique com o tamanho do conteúdo dela (o que tem dentro dela), clique duas vezes na linha azul. A banda vai ser redimensionada automaticamente. Veja a Figura abaixo.

Banda detail redimensionada Teste novamente o relatório. Você vai notar que agora os nomes estão

Banda detail redimensionada

Teste novamente o relatório. Você vai notar que agora os nomes estão mais perto um do outro. Agora, como exercício, arraste os campos last_name e email para o relatório (na banda Detail) e organize-os. Note que você pode redimensionar cada campo tanto na largura quanto na altura. Outra tarefa é voltar ao editor da query do relatório e inserir o comando ORDER BY na query, para ordenar os registros pelo nome (first_name). Quando fizer tudo isso e mandar visualizar, o resultado deve ser algo parecido com o apresentado na Figura abaixo.

Relatório atualizado Vamos deixar agora o relatório um pouco mais apresentável. Da mesma forma que

Relatório atualizado

Vamos deixar agora o relatório um pouco mais apresentável. Da mesma forma que fez com a banda Detail, diminua agora banda Colum Header. Clique com o botão direito na banda Page Header e escolha Delete band. Na banda Title, insira uma caixa de texto estática, troque o valor do texto para ―Clientes Cadastrados‖ (sem as aspas). Utilize o editor de propriedades do componente (área 5 da Figura onde são apresentadas as áreas do iReport) para configurar o tamanho da fonte do componente para 26, negrito (bold), configure o alinhamento horizontal (horizontal alignment) para centro (center) e o alinhamento vertical (vertical alignment) para meio (middle). Expanda o campo de texto para ele ocupar toda a largura da página do relatório. Configure os campos que definem as colunas da banda detail (aqueles campos de texto contidos no cabeçalho) para ficarem em negrito. Execute novamente o relatório. Na Figura abaixo é mostrado como seu relatório deve ter ficado no Preview.

Editando o relatório Para finalizar o design do nosso relatório, vamos adicionar o número de

Editando o relatório

Para finalizar o design do nosso relatório, vamos adicionar o número de página na banda Page Footer. No Report Inspector, procure pelo nó Variables e expanda-o. Uma das variáveis pré-configuradas se chama PAGE_NUMBER. Arraste-a para o lado direito da banda Page Footer e configure o alinhamento horizontal do texto para a direita (right). Dimensione a altura da banda Page Footer para ficar do tamanho do campo que foi inserido. Delete as bandas Column Footer e Summary (clique com o botão direito e escolha delete band em cada uma delas). O design do relatório deve estar como o da Figura abaixo.

Design final do relatório Teste seu relatório e veja que o número da página será

Design final do relatório

Teste seu relatório e veja que o número da página será exibido no final de cada página. Note que o campo do campo de texto que foi inserido (um campo dinâmico) é $V{PAGE_NUMBER}, sendo que o $V denota o uso de uma variável e o valor entre chaves é o nome de variável. Ainda vamos ver como criar variáveis e parâmetros manualmente (ainda não falei dos parâmetros).

Agora que já conseguimos criar nosso primeiro relatório, nós vamos aprender um detalhe muito importante que se conhecido, muitos problemas podem ser evitados. Quando usamos uma query no editor de queries e o iReport cria automaticamente os campos (Fields) para nós, ele atributi automaticamente um tipo para cada campo, dependendo, é claro, do tipo que aquele campo tem quando ele é obtido. Ou seja, first_name é um campo VARCHAR na tabela customer, então quando esse valor é obtido no iReport é criado um campo, com o nome first_name (o nome que vem por padrão) do tipo String, que é a representação para cadeias de caracteres em Java.

Quando queremos usar um campo no nosso relatório, nós podemos arrastar ele diretamente do Report Inspector para o relatório que o iReport vai se preocupar em criar um campo dinâmico (Text Field na paleta) e inserir o valor $F{nome_do_campo} dentro do campo dinâmico. Um detalhe que não vemos acontecer, justamente porque o iReport faz automáticamente, é a configuração do tipo do campo dinâmico. O tipo do campo dinâmico tem que ser SEMPRE igual ao tipo do campo que é utilizado.

Para entender o que eu falei, vamos fazer o seguinte teste. No relatório que estamos criando, arraste para a banda Detail na frente do campo para e-mail um campo dinâmico (Text Field na paleta). Por padrão, o valor do campo vai ser $F{field}. Se você tentar executar o relatório, o iReport vai reclamar, falando que o campo ―field‖ não existe. Isso é uma verdade, visto que nenhum campo com o nome field foi criado não é mesmo? Vamos substituir o valor field para customer_id. O campo vai ficar então com o valor $F{customer_id}. Tente executar o relatório para ver o que acontece. Funcionou? Não! Mas qual o motivo? O erro diz ―Cannot cast from Integer to String―. Isso quer dizer que o valor do campo customer_id é um Integer e o JasperReports está sendo instruido a fazer um cast explícito de Integer para String. Mas de onde vem essa String? Lembram que falei que o campo dinâmico (Text Field) tem que ter o mesmo

tipo de um campo? Ou seja, o campo customer_id é do tipo Integer (inferido na criação da query), enquanto o campo dinâmico que está inserido no relatório é do tipo String. O que temos que fazer? Mudar o tipo do campo dinâmico. Para isso, selecione o campo dinâmico que está na banda Detail e procure pela propriedade ―expression class‖ na guia de propriedades do editor. O valor que estará lá é java.lang.String. Vamos mudar para java.lang.Integer. Ao fazer isso, teste novamente o relatório. Agora funcinou não é? Então, tenha sempre em mente que o tipo de um campo dinâmico tem que SEMPRE SER DO MESMO TIPO que o campo ($F), a variável ($V), o parâmetro ($P), ou o resultado de uma expressão que for executada na propriedade Text Field Expression do campo dinâmico.

Legal, agora nós vamos fazer esse relatório ser executado a partir de um programa. Lembram que eu falei que para um relatório ser executado, nós precisaríamos passar o datasource que nós queremos que ele use? Pois bem, no nosso caso, o nosso datasource é uma conexão JDBC (java.sql.Connection), sendo assim, vamos precisar criar conexões para passar para a engine de execução do relatório. Vamos então criar uma fábrica de conexões para utilizarmos. Essa fábrica é uma classe, com o nome ConnectionFactory. Para criar a classe, primeiramente vá para a aba Projects do NetBeans (canto superior esquerdo) expanda o nó Source Packages (pacotes de código fonte) do nosso projeto, e no pacote ―tutorialrelatorios‖, crie um pacote chamado ―jdbc‖ (sem as aspas). Dentro então do pacote jdbc, crie uma classe chamada ConnectionFactory. Segue o código comentado da classe.

tutorialrelatorios.jdbc.ConnectionFactory.java

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

package tutorialrelatorios.jdbc;

import java.sql.Connection; import java.sql.DriverManager;

import java.sql.SQLException;

/**

*

Uma fábrica de conexões.

*

*

@author David Buzatto

*/

public class ConnectionFactory {

/*

* Este bloco estático será executado assim que esta classe for carregada,

*

sendo assim, será executado apenas uma vez.

*/

static {

try {

/*

*

Carrega a classe

com.mysql.jdbc.Driver, que é a

implementação

* do driver JDBC para o MySQL.

*/

Class.forName( "com.mysql.jdbc.Driver" );

// caso a classe não seja encontrada } catch ( ClassNotFoundException exc ) {

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

/*

* Como log usaremos o stacktrace das excessões, mas

recomendo

* que para um projeto real você utilize algum mecanismo

de log

* melhor, como o Log4J por exemplo.

*/

exc.printStackTrace();

}

}

/**

* O método getConnection retorna uma conexão com o banco de dados baseado

*

nos parâmetros fornecidos.

*

*

@param url O endereço da base de dados.

*

@param usuario O usuário que tem permissão na base de dados

especificada.

* @param senha A senha do usuário especificado

* @return Uma conexão com o banco de dados especificado na url.

* @throws SQLException Caso ocorra algum problema durante a

conexão. */ public static Connection getConnection( String url, String usuario, String senha ) throws SQLException {

// retorna a conexão a partir do método getConnection de

DriverManager

return DriverManager.getConnection( url, usuario, senha );

}

/**

*

Obtém uma conexão para a base de dados sakila.

*

*

@return Uma conexão para a base de dados sakila.

*

@throws SQLException Caso ocorra algum problema durante a

conexão. */

public static Connection getSakilaConnection() throws SQLException

{

return getConnection( "jdbc:mysql://localhost/sakila", "root",

}

}

"root" );

Usando o método getSakilaConnection() iremos então obter conexões para a base de dados sakila, sendo que essa conexão será utilizada pelo JasperReports para executar as queries que forem definidas nos relatórios.

Além da fábrica de conexões, vamos criar também uma classe que conterá métodos utilitários para abrir relatórios. Para isso, crie um pacote chamado ―utils‖ (sem as aspas) dentro do pacote ―tutorialrelatorios‖. Dentro do pacote criado, crie uma classe com o nome de ReportUtils. Segue o código comentado da classe.

tutorialrelatorios.util.ReportUtils.java

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

package tutorialrelatorios.util;

import java.awt.BorderLayout;

import java.io.InputStream;

import java.sql.Connection;

import java.util.Map;

import javax.swing.JFrame; import net.sf.jasperreports.engine.JRDataSource; import net.sf.jasperreports.engine.JRException;

import net.sf.jasperreports.engine.JasperFillManager;

import net.sf.jasperreports.engine.JasperPrint;

import net.sf.jasperreports.swing.JRViewer;

/**

*

Classe com métodos utilitários para executar e abrir relatórios.

*

*

@author David Buzatto

*/

public class ReportUtils {

/**

*

Abre um relatório usando uma conexão como datasource.

*

*

@param titulo Título usado na janela do relatório.

*

@param inputStream InputStream que contém o relatório.

*

@param parametros Parâmetros utilizados pelo relatório.

*

@param conexao Conexão utilizada para a execução da query.

* @throws JRException Caso ocorra algum problema na execução

do relatório

*/ public static void openReport( String titulo, InputStream inputStream, Map parametros,

Connection conexao ) throws JRException {

/*

*

Cria

um

JasperPrint,

que

é

a versão

preenchida do

relatório, * usando uma conexão.

*/

JasperPrint print = JasperFillManager.fillReport(

inputStream, parametros, conexao );

// abre o JasperPrint em um JFrame viewReportFrame( titulo, print );

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

}

/**

*

Abre um relatório usando um datasource genérico.

*

@param titulo Título usado na janela do relatório. @param inputStream InputStream que contém o relatório. @param parametros Parâmetros utilizados pelo relatório. @param dataSource Datasource a ser utilizado pelo relatório. * @throws JRException Caso ocorra algum problema na execução do relatório */ public static void openReport( String titulo, InputStream inputStream, Map parametros,

*

*

*

*

JRDataSource dataSource ) throws JRException {

/*

*

Cria

um

JasperPrint,

que

é

relatório,

*

usando um datasource genérico.

*/

a versão

preenchida do

JasperPrint print = JasperFillManager.fillReport(

inputStream, parametros, dataSource );

// abre o JasperPrint em um JFrame viewReportFrame( titulo, print );

}

/**

* Cria um JFrame para exibir o relatório representado pelo

JasperPrint.

*

*

@param titulo Título do JFrame.

*

@param print JasperPrint do relatório.

*/

private static void viewReportFrame( String titulo, JasperPrint

print ) {

/*

*

Cria um JRViewer para exibir o relatório.

*

Um JRViewer é uma JPanel.

*/

JRViewer viewer = new JRViewer( print );

// cria o JFrame JFrame frameRelatorio = new JFrame( titulo );

// adiciona o JRViewer no JFrame

frameRelatorio.add( viewer, BorderLayout.CENTER );

// configura o tamanho padrão do JFrame

frameRelatorio.setSize( 500, 500 );

// maximiza o JFrame para ocupar a tela toda. frameRelatorio.setExtendedState( JFrame.MAXIMIZED_BOTH );

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

// configura a operação padrão quando o JFrame for fechado. frameRelatorio.setDefaultCloseOperation( JFrame.DISPOSE_ON_CLOSE );

// exibe o JFrame

frameRelatorio.setVisible( true );

}

}

Não vamos criar uma interface gráfica para executar nosso relatório, pois vamos abri-lo diretamente da classe Main do projeto. Perceba que o código usado na classe Main é o mesmo que você vai utilizar, por exemplo, para abrir o relatório a partir do clique de um botão, mas antes disso, mais alguns detalhes. Quando fazemos o preview do relatório, o iReport invoca o compilador do JasperReports para compilar o arquivo .jrxml em um arquivo .jasper, para então executar o arquivo .jasper, abrindo assim o relatório. Você deve ter percebido que agora, além do arquivo Clientes.jrxml, existe também o arquivo Clientes.jasper na nossa pasta de definições de relatórios. Se você quiser compilar manualmente um relatório sem entrar no preview do mesmo, basta ir no Report Inspector, com o relatório desejado aberto, clicar com o botão direito no nó raiz do relatório, que por padrão tem o nome de ―report name‖ (nome do relatório) e escolher Compile Report (Compilar Relatório).

Vamos então executar nosso relatório a partir do método main da classe Main do nosso projeto. Segue o código comentado da classe.

1

2

3

4

5

6

7

8

9

10

11

12

13

package tutorialrelatorios;

import java.io.InputStream; import java.sql.SQLException;

import java.util.HashMap;

import java.util.Map;

import net.sf.jasperreports.engine.JRException; import tutorialrelatorios.jdbc.ConnectionFactory; import tutorialrelatorios.util.ReportUtils;

/**

*

*

*

*/ public class Main {

Ponto de entrada do projeto.

@author David Buzatto

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

/** * @param args the command line arguments */ public static void main(String[] args) {

new Main().abrirRelatorioClientes();

}

public void abrirRelatorioClientes() {

/*

* Obtendo o arquivo do relatório.

* Note que estamos utilizando um InputStream para obter o

arquivo que

*

problema

*

*

*

raiz da

está dentro do nosso projeto. Fazendo isso, não teremos

quando nosso projeto for empacotado em um .jar.

Note que o caminho do .jasper inicia com /, ou seja, a

* localização das classes compiladas do nosso projeto

* (o pacote default).

*

* Utilize a aba Files (canto superior esquerdo) e veja que

os arquivos

*

.jasper

e

/build/classes

.jrxml

são

copiados para

o

diretório

* e por consequencia para o .jar que for criado.

*

* Se não os estiver vendo, mande dar um Clean and Build no

projeto

* (botão direito no nó raiz do projeto, Clean and Build

(Limpar e Construir)

*

*/

InputStream inputStream = getClass().getResourceAsStream(

"/Clientes.jasper" );

// mapa de parâmetros do relatório (ainda vamos aprender a

usar)

Map parametros = new HashMap();

try {

// abre o relatório

ReportUtils.openReport( "Clientes", inputStream,

parametros,

ConnectionFactory.getSakilaConnection() );

}

catch ( SQLException exc ) {

exc.printStackTrace();

}

catch ( JRException exc ) {

exc.printStackTrace();

}

}

}

64

Tente executar o projeto teclando F6. Uma excessão será lançada (java.lang.ClassNotFoundException: com.mysql.jdbc.Driver). Isso se deve ao fato de que nós ainda não colocamos o driver do MySQL no nosso projeto! Clique então em Libraries com o botão direito e escolha Add Library. Como as bibliotecas do nosso projeto ficam inseridas no projeto e não nas configurações do NetBeans, temos que criar a biblioteca como fizemos com o JasperReports e suas dependências. Mas ao invés de fazer todo aquele processo na mão, nós podemos importar bibliotecas que estão configuradas no NetBeans sendo que o driver do MySQL é uma delas. Sendo assim, na janela que se abriu, clique no botão Import. Ao fazer isso, a janela Import Library irá aparecer. Procure pela biblioteca ―MySQL JDBC Driver‖, selecione-a e clique no botão Import Library. Com isso a biblioteca do driver do MySQL será importada para o projeto. Você vai ver ela na janela que apareceu novamente. Selecione-a e clique em Add Library. Após fazer isso, tecle F6 novamente para executar o projeto.

Agora sim, uma janela com o relatório será aberta. Experimente utilizar os controles da janela, tente salvar o relatório em vários formatos, etc. Após brincar um pouco com isso, feche a janela e vamos a mais algumas explicações para finalizarmos esta parte do tutorial.

Ao ler os comentários da classe Main, você deve ter percebido duas coisas. Primeiro, o arquivo .jrxml está sendo copiado para a estrutura compilada do nosso projeto (build) e por consequência, o arquivo .jrxml vai ser empacotado no .jar, sendo que só queremos distribuir o arquivo compilado (.jasper). Segundo, ainda não aprendemos a utilizar o mapa de parâmetros e ainda não foi explicado qual a sua utilidade.

Em relação ao primeiro problema, para excluir certos tipos de arquivos do processo de build, abra as propriedades do projeto e localize o nó Packaging, dentro do nó Build. Ao clicar nesta opção, você vai ver um campo chamado ―Exclude From JAR File―. Neste campo, você informa o padrão de nome dos arquivos que você NÃO QUER que sejam inseridos no build. Por padrão, o valor é ―**/*.java,**/*.form‖, ou seja, qualquer arquivo, de qualquer diretório do projeto que tenha extensão ―java‖ e qualquer arquivo, de qualquer diretório do projeto que tenha extensão ―form‖. Precisamos inserir então nessa lista os arquivos de extensão ―jrxml‖. Para fazer isso, basta adicionar um item na lista com o valor ―**/*.jrxml‖ (sem as aspas). O valor final do campo deve ser ―**/*.java,**/*.form, **/*.jrxml‖ (sem as aspas). Ao fazer isso, clique em OK e mande limpar e refazer o build no projeto (botão direito no nó raiz do projeto, opção Clean and Build Limpar e Construir). Vá novamente na aba Files (canto superior esquerdo) e expanda a pasta /build/classes. Você vai ver que agora somente o arquivo .jasper está sendo copiado para o build.

Tudo bem até aqui? Espero que sim. Estamos acabando. Agora vamos a parte final, os parâmetros.

Quando criamos listagens de dados em relatórios, normalmente nós queremos filtrar tais dados, nos baseando em alguma restrição. Imagine que no nosso relatório de clientes, nós queiramos filtrar os clientes existentes a partir do primeiro nome deles. Para isso, teremos que inserir uma restrição na query do relatório para comparar o primeiro nome com o valor que queremos filtrar. Modificar a query é fácil, mas nós precisamos que

esse valor que será utilizado na query seja dinâmico, ou seja, a cada vez que executarmos o relatório, queremos que o valor de restrição seja diferente. Para utilizar esses valores dinâmicos no iReport, nós usamos os chamados parâmetros. Vamos então fazer uma cópia do nosso primeiro relatório para inserirmos esse tipo de restrição.

Na aba Projects, procure pelo arquivo Clientes.jrxml na pasta de definições de relatórios. Clique com o botão direito nele e escolha Copy (Copiar). Clique com o botão direito no pacote default da pasta de definições de relatórios e escolha Paste (Colar). O arquivo será colado com o nome de Clientes_1.jrxml. Selecione o arquivo, tecle F2 (ou botão direito, rename renomear) e troque o nome para ClientesPorNome.jrxml. Ao fazer isso, abra o ClientesPorNome.jrxml no editor de relatórios.

Com o arquivo aberto, vá no Report Inspector e procure pela banda Page Header que estará sendo exibida em cinza claro. Está assim porque ela foi removida lembra? Para fazer ela aparecer novamente no relatório, clique com o botão direito nela e escolha Add Band (Adicionar Banda). Ainda não vamos mexer com essa banda, mas só para adiantar, ela vai ser utilizada para mostrar o filtro que estamos fazendo.

Ainda no Report Inspector, procure pelo nó Parameters (Parâmetros) e expanda-o. Você vai ver que existem diversos parâmetros pré-configurados no nosso relatório. Nós queremos criar mais um. Para isso, clique com o botão direito em Parameters e escolha Add Parameter. Um novo parâmetro, com o nome ―parameter1″ vai ser criado. Selecione-o e troque o nome dele para ―primeiroNome‖. Perceba que ao selecionar um parâmetro, o editor de propriedades do iReport mostra diversas propriedades, entre elas a classe do parâmetro (Parameter Class). Da mesma forma que os campos e variáveis do relatório, os parâmetros também precisam de um tipo. Este parâmetro que estamos criando vai ser utilizado no filtro da query, ou seja, ele vai conter o valor que queremos utilizar como filtro. Um nome é uma String não é? Então a classe desse parâmetro é a java.lang.String mesmo, mas imagine que queiramos comprar um número. Então a classe teria que ser de algum tipo numérico ok?

Note também que a propriedade ―Use as prompt‖ deve estar selecionada. Essa propriedade é utilizada para que quando formos dar o preview no relatório, seja aberto um diálogo para pedir o valor que queremos que o parâmetro assuma naquela execução. Execute o relatório para ver isso acontecer. Veja a Figura abaixo.

queremos que o parâmetro assuma naquela execução. Execute o relatório para ver isso acontecer. Veja a

Prompt de parâmetro

Mesmo que você informe qualquer valor para o parâmetro, o resultado do relatório vai ser o mesmo, afinal, não inserimos o parâmetro na query do relatório não é mesmo? Vamos fazer isso agora. Abra o editor de queries do relatório e edite a query para ficar assim:

1 SELECT * FROM customer

2 WHERE first_name LIKE $P{primeiroNome}

3 ORDER BY first_name;

Após editar, clique em OK. Note que foi inserido uma cláusula WHERE na query, comparando o campo first_name com o valor do parâmetro, usando o operador LIKE. Note que para utilizarmos o valor do parâmetro, utilizamos a notação ―$P{nomeDoParametro}‖. Imagine que na hora da execução, o parâmetro assuma o valor ―D%‖, ou seja, queremos qualquer cliente com o nome que inicie com a letra D. A query na hora da execução ficaria assim:

1 SELECT * FROM customer

2 WHERE first_name LIKE 'D%'

3 ORDER BY first_name;

Perceberam o que estamos fazendo? Note que as aspas simples serão inseridas automaticamente pelo JasperReports na hora da execução, pois o parâmetro primeiroNome é uma String. Teste o relatório e passe no valor do paramâmetro como ‗D%‘ (sem as aspas). O resultado deve estar parecido com o da Figura abaixo.

Resultado do relatório passando D% no valor do parâmetro Legal não é? Então caso você

Resultado do relatório passando D% no valor do parâmetro

Legal não é? Então caso você queira inserir mais restrições no relatório, basta criar mais parâmetros e ir modificando a query. Faça mais alguns testes ;). Vamos agora mostrar para o usuário qual foi a restrição que foi pedida no relatório. Lembram da banda Page Header que colocamos novamente no relatório? Insira nela um campo de texto estático (Static Text) e preencha-o com o valor ―Com nome:‖ (sem as aspas), alinhe o texto à direita e escolha para ficar em negrito (bold). Na frente deste campo, insia um campo dinâmico (Text Field) e edite seu valor para ―$P{primeiroNome}‖ (sem as aspas). Percebeu o que estamos fazendo? Vamos mostrar o valor do parâmetro no relatório também! Lembre-se que o tipo do campo dinâmico tem que ser o mesmo do valor que ele vai mostrar, no caso uma String, que é o tipo do parâmetro ―primeiroNome‖. Coloquei também algumas linhas (componente Line da paleta) no relatório para ficar mais bonitinho ;). Veja a Figura abaixo para ver como ficou.

Design do relatório finalizado Muito bem! Agora, para que este novo relatório funcione corretamente quando

Design do relatório finalizado

Muito bem! Agora, para que este novo relatório funcione corretamente quando formos utilizá-lo no nosso programa, nós precisamos passar o parâmetro que foi configurado não é mesmo? Lembram do mapa de parâmetros que foi criado? Do tipo Map<String, Object>? É nele que passamos o valor dos parâmetros. A chave do mapa é uma String, que vai corresponder ao nome do parâmetro (no nosso caso, primeiroNome). O valor do item do mapa é um Object, mas precisamos passar instâncias de objetos que casem com o tipo do parâmetro configurado no relatório. No nosso caso, primeiroNome é do tipo String lembram? Então o objeto que tem que ser passado no valor do item do mapa precisa ser uma String, por causa do tipo do parâmetro como já falei. Veja o código alterado do método abrirRelatorioClientes() da classe Main.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

public void abrirRelatorioClientes() {

// note que estamos chamando o novo relatório InputStream inputStream = getClass().getResourceAsStream( "/ClientesPorNome.jasper" );

// mapa de parâmetros do relatório

Map parametros = new HashMap();

/*

*

Insere o parâmetro primeiroNome no mapa, com o valor F%

*

ou seja, todos os clientes que tenham primeiro nome começando

*

com a letra F.

*/

parametros.put( "primeiroNome", "F%" );

// outros possíveis parâmetros aqui

try {

// abre o relatório ReportUtils.openReport( "Clientes", inputStream, parametros,

21

22

23

24

25

26

27

28

29

30

}

catch ( SQLException exc ) {

exc.printStackTrace();

}

}

}

catch ( JRException exc ) { exc.printStackTrace();

Perceba que caso existam mais parâmetros a serem enviados ao relatório, eles devem ser inseridos no mesmo mapa. Outro detalhe é que estamos apenas fazendo um exemplo e passando um valor fixo no parâmetro. Em um caso real, o valor a String ―F%‖ viria de um campo de texto ou qualquer outro componente da sua interface gráfica.

Com isso terminamos a segunda parte do nosso tutorial. Espero que tenham gostado :). Na próxima parte iremos aprender a trabalhar com os ―temidos‖ subrelatórios :D. Digo ―temidos‖ porque são um pouco chatos de usar e se você não souber realmente o que está fazendo e como eles funcionam, você pode ficar um dia inteiro tentando fazer funcionar e não conseguir :(

Neste link você pode fazer o download do código fonte do projeto até o momento.

Então é isso ai. Um grande abraço!

Parte 1 Parte 2 Parte 3 Parte 4 Parte 5

JasperReports: Trabalhando com Relatórios em Java Parte 3 (Subrelatórios)

14/10/2010

16 Votes

Parte 1 Parte 2 Parte 3 Parte 4 Parte 5

Olá! Hoje vamos aprender a trabalhar com subrelatórios no JasperReports, mas antes de começar quero explicar algumas coisas. Nos últimos posts, eu tenho tentado formatar os termos em inglês em itálico e colocar logo em seguida a tradução. Eu vou parar de fazer isso. Primeiro, pq os termos são simples, e qualquer pessoa que trabalhe com informática tem mais que obrigação de saber. Segundo, gasto muito tempo formatando cada parágrafo, revisando se está tudo ok, etc. Então, para agilizar o processo, estou deixando de lado essa prática. Tenho também tratado os leitores cada hora de um jeito. Uma hora escrevo na primeira pessoa do singular, na outra, escrevo na terceira do plural. Vou tentar manter a mesma narração, mas se eu cometer algum deslize, não se encomodem ok? Então, vamos começar!

Se você já tentou trabalhar com subrelatórios, provavelmente teve algumas frustrações até conseguir fazer funcionar. Se você nunca trabalhou, hoje vai aprender! Trabalhar com subrelatórios não é difícil, o problema é entender como as coisas funcionam, mas antes de falar disso, vamos nos situar no tema. O que é um subrelatório? Como o próprio nome diz é um relatório que fica dentro de um outro relatório, ou seja, é uma parte de um relatório maior, mais geral. Vamos entender por meio de um exemplo. Para isso, abra o diagrama da base de dados sakila clicando aqui e imagine a seguinte situação: você precisa criar um relatório, onde serão exibidos os dados de todos os clientes e de todos os filmes que cada um alugou. O layout do relatório teria que ficar mais ou menos assim:

Rascunho do layout do relatório de filmes por cliente Como criar um relatório com esse

Rascunho do layout do relatório de filmes por cliente

Como criar um relatório com esse layout? Usando subrelatórios! A parte mais externa do layout representa o arquivo de relatório mais geral, onde serão listados os clientes e onde será inserido o subrelatório. O subrelatório, destacado em azul, será um outro arquivo de relatório que será utilizado dentro do relatório mais geral. Confuso? Calma, calma, logo vocês vão enteder. Antes disso, um pouquinho mais de teoria.

O funcionamento de um subrelatório é igual ao de um relatório normal, sendo que existe apenas uma diferença e é justamente aqui que as pessoas se confundem. Os parâmetros de um subrelatório não são enviados diretamente do código Java como é feito em um relatório normal. No caso dos subrelatórios, os parâmetros são enviados pelo relatório que os contém, para então serem passados ao subrelatório. Então, caso você passe um parâmetro para o relatório que deve ser usado apenas no subrelatório, o seu relatório vai ter que ter o ―mesmo‖ parâmetro e você vai ter que criar essa ponte entre o relatório principal e o subrelatório. Veja a Figura abaixo.

Parâmetros sendo passados entre as camadas de relatórios Em vermelho é destacada a transmissão dos

Parâmetros sendo passados entre as camadas de relatórios

Em vermelho é destacada a transmissão dos parâmetros a partir da aplicação em Java para o relatório. Esses parâmetros são enviados usando o mapa da parâmetros lembram? Em laranja é destacada a transmissão dos parâmetros para o subrelatório a partir do relatório. Veja então que o relatório vai servir de ponte entre os parâmetros desejados, além de poder criar novos parâmetros e os enviar para o subrelatório. Outro detalhe é que podem haver diversos níveis de relatórios, ou seja, um subrelatório pode enviar parâmetros para um subsubrelatório, um subsubrelatório pode enviar parâmetros para um subsubsubrelatório, e assim por diante.

Finalmente! Vamos à prática! Abra o NetBeans e o projeto que estamos usando (TutorialRelatorios). Se você não acompanhou a parte anterior do tutorial, ou mesmo que tenha acompanhado e não tenha feito o exemplo, você pode baixar a versão do projeto (finalizada na Parte 2) clicando aqui. Na pasta de definições de relatórios que criamos, crie um novo Empty Report e dê o nome de LocacoesPorClientes. O arquivo LocacoesPorClientes.jrxml vai ser criado. Caso ele não abra automaticamente no editor, clique duas vezes para ser carregado no iReport.

Com o arquivo aberto, vamos primeramente criar um relatório simples, que lista os clientes a partir de uma pesquisa pelo nome. A query deste relatório vai ser um pouco mais complexa que a do relatório ―ClientesPorNome‖, criado na Parte 2 do tutorial, pois nela iremos obter outros dados do cliente que não estão na tabela customer. Não se esqueça de escolher o datasource correto, o ―Sakila – JDBC‖ ok? Crie também um parâmetro, do tipo String, com o nome de ―nomeCliente‖. Segue então a query que deve ser inserida no relatório:

1

2

3

4

5

SELECT

c.customer_id idCliente,

c.first_name nome,

c.last_name sobrenome,

c.email email,

a.address endereco,

6

a.phone telefone,

7

ci.city nomeCidade,

8

9

10

11

12

13

14

15

16

17

co.country nomePais

FROM

customer c,

address a,

city ci,

country co

WHERE

/* junções */

c.address_id = a.address_id AND

18

a.city_id = ci.city_id AND

19

20

21

22

ci.country_id = co.country_id AND

/* restrições */

c.first_name LIKE $P{nomeCliente}

24

25

26

ORDER BY c.first_name;

Ao inserir a query, o iReport vai carregar os campos retornados por ela. Ao clicar em OK, os campos carregados serão criados na definição do relatório. Os fields lembram? Expanda então o nó Fields do Report Inspector e arraste e organize esses campos na banda Detail do relatório. Veja como ficou o meu.

campos na banda Detail do relatório. Veja como ficou o meu. Layout do relatório de locações

Layout do relatório de locações por clientes

Note que coloquei campos estáticos na banda Detail, tirei as bandas Column Header, Column Footer e Summary. Criei um parâmetro chamado ―nomeUsuario‖ para mostrar no cabeçalho da página o nome do usuário do ―sistema‖ que gerou o relatório. Outra coisa que fiz foi colocar a data e hora que o relatório foi gerado na banda Page Header. Note que para o uso da data e do formato, foi usado um campo de texto dinâmico, com o tipo java.util.Date e a propriedade pattern alterada para ―dd/MM/yyyy‘, às‘ HH:mm‘hs'‖ (sem as aspas). Note também que o valor deste campo é gerado a partir de um código Java! Segue o fonte em XML do relatório. Basta copiar e colar no seu relatório (usando o botão XML).

LocacoesPorClientes.jrxml

1

<?xml version="1.0" encoding="UTF-8"?>

2

3

4

5

6

7

8

ts

name="report name" pageWidth="595" pageHeight="842" columnWidth="535"

leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20">

<property name="ireport.zoom" value="1.0"/>

<property name="ireport.x" value="0"/>

<property name="ireport.y" value="0"/>

<parameter name="nomeCliente" class="java.lang.String"/>

9

<parameter name="nomeUsuario" class="java.lang.String"/>

10

11

12

13

14

15

16

17

18

<queryString>

<![CDATA[SELECT

c.customer_id idCliente,

c.first_name nome,

c.last_name sobrenome,

c.email email,

a.address endereco,

a.phone telefone,

ci.city nomeCidade,

co.country nomePais

19

20

21

22

23

24

25

26

27

FROM

customer c,

address a,

city ci,

country co

WHERE

/* junções */

28

c.address_id = a.address_id AND

29

a.city_id = ci.city_id AND

30

ci.country_id = co.country_id AND

31

 

/* restrições */

32

 

c.first_name LIKE $P{nomeCliente}

33

34

 

ORDER BY c.first_name;]]>

35

 

</queryString>

36

<field name="idCliente" class="java.lang.Integer"/>

37

<field name="nome" class="java.lang.String"/>

38

<field name="sobrenome" class="java.lang.String"/>

39

<field name="email" class="java.lang.String"/>

40

<field name="endereco" class="java.lang.String"/>

41

<field name="telefone" class="java.lang.String"/>

42

<field name="nomeCidade" class="java.lang.String"/>

<field name="nomePais" class="java.lang.String"/>

43

 

<background>

44

 

<band splitType="Stretch"/>

45

 

</background>

46

<title>

47

<band height="75" splitType="Stretch">

48

<staticText>

49

<reportElement x="0" y="18" width="555" height="40"/>

50

<textElement

textAlignment="Center"

verticalAlignment="Middle">

51

<font size="25" isBold="true"/>

52

</textElement>

53

<text><![CDATA[Locações por Clientes]]></text>

55

<line>

56

<reportElement x="0" y="1" width="555" height="1"/>

57

</line>

<line>

58

 

<reportElement x="0" y="74" width="555" height="1"/>

59

 

</line>

60

 

</band>

61

</title>

62

<pageHeader>

63

<band height="21" splitType="Stretch">

64

<staticText>

65

<reportElement x="-1" y="0" width="51" height="20"/>

66

<textElement

textAlignment="Left"

verticalAlignment="Middle">

67

<font isBold="true"/>

68

</textElement>

69

<text><![CDATA[Usuário:]]></text>

70

</staticText>

71

<textField>

72

<reportElement x="53" y="0" width="150" height="20"/>

<textElement verticalAlignment="Middle"/>

73

 

<textFieldExpression

74

class="java.lang.String"><![CDATA[$P{nomeUsuario}]]></textFieldExpre

ssion>

75

 

</textField>

76

 

<staticText>

77

 

<reportElement x="360" y="0" width="68" height="20"/>

78

<textElement

textAlignment="Left"

79

verticalAlignment="Middle">

<font isBold="true"/>

80

 

</textElement>

81

<text><![CDATA[Gerado em:]]></text>

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

10

0

10

1

10

2

10

3

10

4

</staticText>

<textField

pattern="dd/MM/yyyy&apos;,

às&apos;

HH:mm&apos;hs&apos;">

<reportElement x="433" y="0" width="122" height="20"/>

<textElement verticalAlignment="Middle"/>

<textFieldExpression class="java.util.Date"><![CDATA[new Date()]]></textFieldExpression>

</textField>

</band>

</pageHeader>

<detail>

<band height="110" splitType="Stretch">

<staticText>

<reportElement x="0" y="3" width="50" height="20"/>

<textElement

verticalAlignment="Middle">

<font isBold="true"/>

</textElement>

textAlignment="Left"

<text><![CDATA[Nome:]]></text>

</staticText>

<textField>

<reportElement x="0" y="23" width="99" height="20"/>

<textElement verticalAlignment="Middle"/>

<textFieldExpression

class="java.lang.String"><![CDATA[$F{nome}]]></textFieldExpression>

</textField>

<staticText>

<reportElement x="103" y="3" width="70" height="20"/>

<textElement

verticalAlignment="Middle">

<font isBold="true"/>

textAlignment="Left"

5

10

6

10

7

10

8

10

9

11

0

11

1

11

2

11

3

11

4

11

5

11

6

11

7

11

8

11

9

12

0

12

1

<text><![CDATA[Sobrenome:]]></text>

</staticText>

<textField>

height="20"/>

<reportElement

x="103"

y="23"

width="136"

<textElement verticalAlignment="Middle"/>

<textFieldExpression

class="java.lang.String"><![CDATA[$F{sobrenome}]]></textFieldExpress

ion>

</textField>

<staticText>

<reportElement x="242" y="3" width="70" height="20"/>

<textElement

verticalAlignment="Middle">

<font isBold="true"/>

</textElement>

textAlignment="Left"

<text><![CDATA[E-mail:]]></text>

</staticText>

<textField>

height="20"/>

<reportElement

x="242"

y="23"

width="228"

<textElement verticalAlignment="Middle"/>

<textFieldExpression

class="java.lang.String"><![CDATA[$F{email}]]></textFieldExpression>

</textField>

<staticText>

<reportElement x="0" y="47" width="59" height="20"/>

<textElement

verticalAlignment="Middle">

<font isBold="true"/>

</textElement>

textAlignment="Left"

<text><![CDATA[Endereço:]]></text>

</staticText>

2

<textField>

12

<reportElement x="62" y="47" width="177" height="20"/>

3

<textElement verticalAlignment="Middle"/>

 

12

<textFieldExpression

 

4

class="java.lang.String"><![CDATA[$F{endereco}]]></textFieldExpressi

on>

12

5

</textField>

<staticText>

12

6

<reportElement x="473" y="3" width="82" height="20"/>

12

<textElement verticalAlignment="Middle">

 

7

<font isBold="true"/>

 

12

</textElement>

8

 

<text><![CDATA[Telefone:]]></text>

 

12

</staticText>

9

 

<textField>

13

0

<reportElement x="473" y="23" width="82" height="20"/>

13

<textElement verticalAlignment="Middle"/>

 

1

<textFieldExpression

 

class="java.lang.String"><![CDATA[$F{telefone}]]></textFieldExpressi

13

on>

2

 

</textField>

13

 

<staticText>

3

 

<reportElement x="242" y="47" width="42" height="20"/>

13

4

<textElement

textAlignment="Left"

verticalAlignment="Middle">

13

5

<font isBold="true"/>

 

</textElement>

13

6

<text><![CDATA[Cidade:]]></text>

 

13

</staticText>

7

<textField>

13

<reportElement

x="287"

y="47"

width="106"

8

height="20"/>

13

<textElement verticalAlignment="Middle"/>

 

9

<textFieldExpression

 
 

class="java.lang.String"><![CDATA[$F{nomeCidade}]]></textFieldExpres

14

sion>

0

</textField>

14

<staticText>

1

 

<reportElement x="397" y="47" width="31" height="20"/>

14

2

<textElement

textAlignment="Left"

 

verticalAlignment="Middle">

 

14

<font isBold="true"/>

 

3

 

</textElement>

14

4

<text><![CDATA[País:]]></text>

 

</staticText>

14

5

<textField>

14

<reportElement

x="433"

y="47"

width="122"

6

height="20"/>

 

14

<textElement verticalAlignment="Middle"/>

 

7

<textFieldExpression

 
 

class="java.lang.String"><![CDATA[$F{nomePais}]]></textFieldExpressi

14

on>

8

 

</textField>

14

<staticText>

9

 

<reportElement

x="167"

y="82"

width="226"

15

height="20"/>

 

0

 

<textElement

textAlignment="Center"

15

verticalAlignment="Middle" rotation="None">

1

<font size="12" isBold="true"/>

 

15

</textElement>

2

 

<text><![CDATA[O

Subrelatório

vai

vir

15

aqui

]]></text>

3

</staticText>

15

<line>

4

 

<reportElement x="0" y="1" width="555" height="1"/>

 

15

</line>

5

</band>

6

15

7

15

8

</detail>

<pageFooter>

<band height="22" splitType="Stretch">

<textField>

<reportElement x="455" y="2" width="100" height="20"/>

15

9

16

0

16

1

16

2

16

3

16

4

16

5

16

6

16

7

16

8

16

9

17

0

17

1

17

2

<textElement

verticalAlignment="Middle"/>

<textFieldExpression

textAlignment="Right"

class="java.lang.Integer"><![CDATA[$V{PAGE_NUMBER}]]></textFieldExpr

ession>

</textField>

<line>

<reportElement x="0" y="1" width="555" height="1"/>

</line>

</band>

</pageFooter>

</jasperReport>

3

17

4

17

5

17

6

17

7

17

8

17

9

18

0

18

1

18

2

18

3

18

4

18

5

18

6

18

7

18

8

18

9

0

19

1

19

2

19

3

19

4

19

5

19

6

19

7

19

8

19

9

20

0

20

1

20

2

Depois de colar, volte para o Designer e verifique o que foi feito em cada parte. Após atualizar o seu relatório, teste-o. O iReport vai pedir dois parâmetros, o nomeCliente que vai ser usado na query e o nomeUsuario que vai ser usado no pageHeader. Note que coloquei um campo de texto estático na banda detail, mostrando onde vai ficar o subrealtório. Vamos criá-lo então. Primeiro, remova o campo de texto estático que tem o valor ―O Subrelatório vai vir aqui…‖ e aumente a banda detail na altura cerca de 120 pixels (depois iremos deixar do tamanho correto). Na paleta de componentes, procure por Subreport. Arraste m subreport para a banda Detail. Assim que arrastar e soltar, o assistente de criação de subrelatórios irá abrir. No primeiro passo, escolha ―Create a new report‖ e clique em Next. Veja a Figura abaixo.

Primeiro passo do assistente de subrelatório No segundo passo, escolha o layout como Blank A4

Primeiro passo do assistente de subrelatório

No segundo passo, escolha o layout como Blank A4 e clique em Next. Veja a Figura abaixo.

Segundo passo do assistente de subrelatório No terceiro passo, ele vai pedir para inserir uma

Segundo passo do assistente de subrelatório

No terceiro passo, ele vai pedir para inserir uma query. Iremos colocar uma query provisória, só para poder continuar o assistente. Depois iremos mudá-la. Coloque ―SELECT * FROM country‖ (sem as aspas) e clique em Next. Veja a Figura abaixo.

Terceiro passo do assistente de subrelatório No quarto passo, ele vai perguntar os campos que

Terceiro passo do assistente de subrelatório

No quarto passo, ele vai perguntar os campos que queremos usar. Não adicione nenhum, pois não vamos usá-los, pois essa não é a query que queremos lembram? Veja a Figura abaixo.

Quarto passo do assistente de subrelatório No quinto passo, o assistente pergunta os grupos que

Quarto passo do assistente de subrelatório

No quinto passo, o assistente pergunta os grupos que serão usados. Nós não usaremos grupos, então, da mesma forma que fizemos no passo anterior, clique em Next sem fazer nada. Veja a Figura abaixo.

Quinto passo do assistente de subrelatório No próximo passo, configuramos o nome do arquivo de

Quinto passo do assistente de subrelatório

No próximo passo, configuramos o nome do arquivo de relatório que vai ser gerado (Report Name), onde ele vai ser armazenado e como ele vai ser obtido no relatório principal. Sendo assim, em Report Name insira ―LocacoesPorClientes_Locacoes‖ (sem as aspas). Não mexa em Location, pq já deve estar apontanto para o diretório do relatório principal. Abaixo, escolha ―Store the directory name in a parameter‖. Isso vai ser útil depois, para informarmos onde está o subrelatório. Feito isso, clique em Next. Veja a Figura abaixo.

Sexto passo do assistente de subrelatório No sétimo e último passo é perguntado como os

Sexto passo do assistente de subrelatório

No sétimo e último passo é perguntado como os dados do subrelatório serão obtidos. Marque a opção ―Use the same connection used to fill the master report‖, ou seja, vamos usar o mesmo objeto Connection passado para executar a query do relatório principal. Clique em Finish. Veja a Figura abaixo.

Sétimo passo do assistente de subrelatório Ao clicar em Finish, o novo arquivo de relatório

Sétimo passo do assistente de subrelatório

Ao clicar em Finish, o novo arquivo de relatório será criado e aberto. Mas ainda não vamos mexer nele. Volte ao relatório principal. Você vai perceber que foi inserida uma caixa cinza no relatório. Essa caixa indica onde o subrelatório vai ser inserido. Note então que para cada cliente, teremos um subrelatório renderizado, afinal, estamos na banda Detail não é mesmo? Expanda a caixa na largura, para ocupar quase a totalidade do relatório e altere a largura da banda detail acomodar a caixa do subrealtório. Veja a Figura abaixo.

Layout do relatório principal Ainda não teste o relatório! Como estamos obtendo todos os países

Layout do relatório principal

Ainda não teste o relatório! Como estamos obtendo todos os países para cada registro de cliente obtido, o iReport pode travar. Salve o relatório principal e vamos agora para o arquivo do subrelatório. Caso queria, segue o XML do relatório principal.

LocacoesPorClientes.jrxml

1 <?xml version="1.0" encoding="UTF-8"?>

2 <jasperReport

name="report name" pageWidth="595" pageHeight="842" columnWidth="535"

4 s

5 leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20">

6 <property name="ireport.zoom" value="1.0"/>

7 <property name="ireport.x" value="0"/>

8 <property name="ireport.y" value="0"/>

9 <parameter name="nomeCliente" class="java.lang.String"/>

1

<parameter name="nomeUsuario" class="java.lang.String"/>

0

<parameter

name="SUBREPORT_DIR"

class="java.lang.String"

1

isForPrompting="false">

1

<defaultValueExpression><![CDATA["C:\\Users\\David\\Documents

\\Blog\\tutoriais\\TutorialRelatorios\\relatorios\\"]]></defaultValue

1

Expression>

2

 

</parameter>

1

3

<queryString>

<![CDATA[SELECT

 

1

4

c.customer_id idCliente,

 

1

c.first_name nome,

5

c.last_name sobrenome,

 

1

c.email email,

6

 

a.address endereco,

 

1

a.phone telefone,

7

 

ci.city nomeCidade,

 

1

8

co.country nomePais

 

1

9

FROM

2

customer c,

0

 

address a,

2

city ci,

1

 

country co

2

2

2

WHERE

3

/* junções */

2

c.address_id = a.address_id AND

 

4

 

a.city_id = ci.city_id AND

 

2

ci.country_id = co.country_id AND

5

2

6

/* restrições */

2

c.first_name LIKE $P{nomeCliente}

7

2

ORDER BY c.first_name;]]>

8

 

</queryString>

2

9

<field name="idCliente" class="java.lang.Integer"/>

3

<field name="nome" class="java.lang.String"/>

0

<field name="sobrenome" class="java.lang.String"/>

3

<field name="email" class="java.lang.String"/>

1

<field name="endereco" class="java.lang.String"/>

3

<field name="telefone" class="java.lang.String"/>

2

 

<field name="nomeCidade" class="java.lang.String"/>

3

3

<field name="nomePais" class="java.lang.String"/>

<background>

3

4

<band splitType="Stretch"/>

3

</background>

5

<title>

3

<band height="75" splitType="Stretch">

6

 

<staticText>

3

<reportElement x="0" y="18" width="555" height="40"/>

7

 

<textElement

textAlignment="Center"

3

verticalAlignment="Middle">

8

 

<font size="25" isBold="true"/>

3

</textElement>

9

 

<text><![CDATA[Locações por Clientes]]></text>

4

0

</staticText>

4

<line>

1

<reportElement x="0" y="1" width="555" height="1"/>

4

</line>

2

 

<line>

4

<reportElement x="0" y="74" width="555" height="1"/>

4

</line>

4

</band>

4

</title>

5

 

<pageHeader>

4

6

<band height="21" splitType="Stretch">

 

<staticText>

4

7

<reportElement x="-1" y="0" width="51" height="20"/>

4

<textElement

textAlignment="Left"

8

verticalAlignment="Middle">

<font isBold="true"/>

 

4

9

</textElement>

5

<text><![CDATA[Usuário:]]></text>

 

0

</staticText>

5

<textField>

1

 

<reportElement x="53" y="0" width="150" height="20"/>

5

<textElement verticalAlignment="Middle"/>

 

2

 

<textFieldExpression

 

5

class="java.lang.String"><![CDATA[$P{nomeUsuario}]]></textFieldExpres

3

sion>

5

</textField>

4

<staticText>

5

<reportElement x="360" y="0" width="68" height="20"/>

5

 

<textElement

textAlignment="Left"

5

verticalAlignment="Middle">

6

<font isBold="true"/>

 

5

</textElement>

7

 

<text><![CDATA[Gerado em:]]></text>

 

5

 

</staticText>

8

 

<textField

pattern="dd/MM/yyyy&apos;,

às&apos;

5

HH:mm&apos;hs&apos;">

9

 

<reportElement x="433" y="0" width="122" height="20"/>

6

0<