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: 115