Spring Boot e BIRT (Business Intelligence and Reporting Tools) são ferramentas poderosas que podem ser integradas para produzir relatórios de alta qualidade em aplicações corporativas. Este artigo oferece um guia passo a passo para integrar o BIRT no Spring Boot e criar relatórios profissionais.
1. Preparando o Ambiente
1.1. Dependências Maven
Para iniciar, adicione as dependências BIRT necessárias ao seu arquivo pom.xml:
<dependency <groupId>org.eclipse.birt.runtime</groupId> <artifactId>org.eclipse.birt.runtime</artifactId> <version>4.8.0</version> </dependency>
Certifique-se de que a versão especificada é compatível com sua versão do Spring Boot.
1.2. Configuração BIRT
Crie um BirtConfiguration para inicializar o BirtEngine:
@Configuration
public class BirtConfiguration {
@Bean
public BirtEngineFactory engineFactory() {
return new BirtEngineFactory();
}
}
2. Criando Relatórios com BIRT
2.1. Design do Relatório
Utilize o BIRT Report Designer (uma ferramenta visual Eclipse-based) para criar o design de seus relatórios. Salve o design com a extensão `.rptdesign`.
2.2. Integração com Spring Boot
Uma vez que o design do relatório estiver pronto, mova-o para o diretório src/main/resources/reports em seu projeto Spring Boot.
Crie um serviço para gerar o relatório
@Service
public class ReportService {
@Autowired
private BirtEngineFactory engineFactory;
public void generateReport(String reportName, Map<String, Object> parameters, HttpServletResponse response) {
IReportRunnable design = engineFactory.parseReport(reportName);
IRunAndRenderTask task = engineFactory.createRunAndRenderTask(design);
task.setParameterValues(parameters);
HTMLRenderOption options = new HTMLRenderOption();
options.setOutputFormat(HTMLRenderOption.OUTPUT_FORMAT_HTML);
options.setOutputStream(response.getOutputStream());
task.setRenderOption(options);
task.run();
task.close();
}
}
3. Expondo Relatórios através de um Endpoint
Agora, você pode criar um controlador para expor seu relatório:
@RestController
@RequestMapping("/reports")
public class ReportController {
@Autowired
private ReportService reportService;
@GetMapping("/generate")
public void generateReport(@RequestParam Map<String, Object> parameters, HttpServletResponse response) {
reportService.generateReport("nomeDoSeuRelatorio.rptdesign", parameters, response);
}
}
4. Executando e Visualizando Relatórios
Execute sua aplicação Spring Boot e acesse o endpoint `/reports/generate` com os parâmetros necessários. O BIRT irá gerar e exibir o relatório de acordo com o design que você criou.
Conclusão
A integração de BIRT com Spring Boot é uma excelente solução para criar e exibir relatórios profissionais em aplicações corporativas. Seguindo este guia, você pode facilmente configurar e gerar relatórios dinâmicos de alta qualidade.
Views: 72
