tutorial ireport

Tutorial: IReport usando Custom JRDatasource

Neste tutorial será explicado passo a passo como gerar relatórios com o IReport / Jasper Reports usando uma Custom JRDatasource.

Custom JRDatasource?

Datasource, ou em português, fonte de dados, é uma espécie de repositório de onde o Jasper irá recuperar os dados que serão impressos no relatório. Um banco de dados pode ser usado para essa função, usando a classe responsável pela geração do relatório acessar diretamente o banco. Porém essa não é a solução mais prática nem a mais elegante. Para escrever no relatório usaremos uma interface chamada JRDataSource.

A Interface JRDataSource

A interface JRDataSource é uma abstração para qualquer fonte de dados para um relatório jasper. Possui apenas dois métodos que veremos a seguir:

public interface JRDataSource{ public Object getFieldValue(JRField jrFiels);

public boolean next();

}

Descreveremos melhor os dois métodos:

public Object getFieldValue(JRField jrField);

Nesse método o JRDataSource retorna um Objeto que é o valor correspondente ao campo (JRField) passado como parâmetro. Geralmente é verificado o nome desse campo para saber que objeto retornar.

public boolean next();

Nesse método o JRDataSource além de retornar se existe um próximo objeto na coleção da fonte de dados, caso exista ele posiciona o cursor nesse próximo elemento, para se recuperar as informações dessa fonte de dados.

Nosso exemplo

Mostraremos agora uma aplicação exemplo que fará uso dos recursos que foram apresentados acima.

1. Implementando as classes

Digamos que uma empresa qualquer tenha seu cadastro de clientes, do qual em cada cliente se armazena o nome, cpf e um código interno referente a esse cliente. Suponhamos também que se deseja um relatório com todos os clientes e as informações relativas aos mesmos dessa forma:



Inicialmente definiremos a classe Cliente:

public class Cliente {

private String codigoControle;