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.

Autor

Views: 115