UReport2报表引擎：Spring Boot 集成 UReport2 报表引擎（一）

一、概述

　　UReport2是一款基于架构在Spring之上纯Java的高性能报表引擎，通过迭代单元格可以实现任意复杂的中国式报表。UReport2是第一款基于Apache-2.0开源协议的中式报表引擎。并且UReport2提供了全新的基于网页的报表设计器，可以在Chrome、Firefox、Edge等各种主流浏览器运行（IE浏览器除外）。

二、相关教程

　　在W3Cschool上提供了相对完善的整合教程资料（UReport2教程），可惜不是springboot整合的，对此有了此篇针对Spring Boot 集成 UReport2 报表引擎的文章。

三、集成过程

第一步：创建一个标准的Maven项目，并在pom.xml文件中添加UReport2的依赖信息。

<dependency>
    <groupId>com.bstek.ureport</groupId>
    <artifactId>ureport2-console</artifactId>
    <version>[version]</version>
</dependency>

关于版本可以到https://mvnrepository.com/上查询“ureport2-console”关键字。

第二步：Servlet配置

/**
 * ureport2报表Servlet配置
 */
@Bean
public ServletRegistrationBean<Servlet> ureport2Servlet(){
    return new ServletRegistrationBean<>(new UReportServlet(), "/ureport/*");
}

在这个servlet配置当中，值为“/ureport/*”的url-pattern是一定不能变的，否则系统将无法运行。

第三步：加载UReport2的spring配置文件

@ImportResource("classpath:ureport-console-context.xml") // 加载ureport对应的xml配置文件
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

第四步：启动项目，访问UReport2的报表设计器界面，测试是否配置成功。http://127.0.0.1:8080/ureport/designer

至此，Spring Boot 集成 UReport2 报表引擎已经完成！

最后，附上springboot启动类Application.java完整代码：

@ImportResource("classpath:ureport-console-context.xml") // 加载ureport对应的xml配置文件
@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @Bean
    public ServletRegistrationBean<Servlet> ureport2Servlet(){
        return new ServletRegistrationBean<>(new UReportServlet(), "/ureport/*");
    }
}