ureport2整合springboot详细教程，从代码到数据源的添加完成

一、官网文档，可以根据文档说明来完成代码部分

http://wiki.bsdn.org/pages/viewpage.action?pageId=76448360

项目效果：

二、springboot搭建就不介绍了！进入正题，一步一步操作，springboot项目建好后，先打开pom.xml即可

1、打开pom.xml，但是这个一般在搭建好springboot项目就会有的，也不排除一些人是手动操作的就可能没有，我这里也写上

<!-- 第一步 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.1.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

2、添加web依赖

<!-- 第二步 web -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

3、添加ureport2依赖

<!-- 第三步 ureport -->
<dependency>
    <groupId>com.bstek.ureport</groupId>
    <artifactId>ureport2-console</artifactId>
    <version>2.2.9</version>
</dependency>

4、打开启动类，在启动类中添加以下方法

// 第四部，ureport2使用到servlet
@Bean
public ServletRegistrationBean buildUReportServlet(){
    return new ServletRegistrationBean(new UReportServlet(),"/ureport/*");
}

5、监听加载UReport2提供的spring配置文件ureport-console-context.xml，由于要扩展 所以引入context.xml（这里第四步也一起复制进去了，以防一些人看不懂）

@SpringBootApplication
// 第五步，监听加载UReport2提供的spring配置文件ureport-console-context.xml，由于要扩展 所以引入context.xml
@ImportResource("classpath:context.xml")
public class UreportUpbusApplication {

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

    // 第四部，ureport2使用到servlet
    @Bean
    public ServletRegistrationBean buildUReportServlet(){
        return new ServletRegistrationBean(new UReportServlet(),"/ureport/*");
    }
}

6、在resources下创建context.xml（classpath属性对应的配置文件在resources目录下）

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd
    ">
    
<-- 这里空白添加下面的第七步 -->

</beans>

7、添加以下内容，这里在第五步的时候本应该是引入classpath:ureport-console-context.xml，变成classpath:context.xml后，在本文件中导入以让启动类找到此配置文件

<!-- 创建context.xml是第六步，引入ureport2报表xml配置文件 -->
<import resource="classpath:ureport-console-context.xml" />
<!-- 第七步，修改目录文件位置。这里多说几句，官方文档默认是在/WEB-INF/config.properties下面，
WEB-INF每次运行的时候都会动态生成一个临时目录，我们是找不到的，所以我们将位置修改成绝对路径，自己可以找到。
由于config.properties是在resouces配置下，所以使用classpath: -->

<bean id="propertyConfigurer" parent="ureport.props">
    <property name="location">
        <value>classpath:config.properties</value>
    </property>
</bean>

8、根据第七步classpath:config.properties，在resources下添加config.properties配置文件，并添加以下内容。这个自己去指定哪个盘符下的哪个目录。前提是文件夹手动建好

ureport.fileStoreDir=D:/ureportfiles

9、打开pom添加连接池和驱动

<!-- 第九步，添加数据库连接池 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.9</version>
</dependency>

<!-- 加载Driver驱动程序 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.20</version>
    <scope>runtime</scope>
</dependency>

10、创建application.yml文件，添加以下内容。（和第九步两个依赖是对应的）

server:
  port: 8080    # HTTP(Tomcat) Port，端口自定义

spring:
  datasource:
    username: root
    password: 123456
    url: jdbc:mysql://localhost:3306/upbus?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=Asia/Shanghai #数据库连接池（druid）
    driver-class-name: com.mysql.cj.jdbc.Driver # 加载Driver驱动

11、启动项目，查看效果，输入localhost:8080/ureport/designer（根据上面第五步中的/ureport/*来的）

12、这就成功了。下面写了一些解释，有些人会对application.yml中的配置有点疑惑

13、添加数据源，后续查看此链接即可。这里要讲一下，配置中的数据库

https://www.cnblogs.com/Seven-cjy/p/9542740.html

注意点：我目前才用的是第一种方式

14、按照第13步操作完成后，点击测试连接，看是否能连接数据库成功，则会显示连接测试成功！然后点击保存

15、添加字段操作

 

16、上述添加完成后，保存一下，不然当刷新页面时候又会恢复原样

17、预览效果，如果预览不通过，在使用.xml文件在页面也不会有效果，因为预览时候可能已经报错

18、保存，建议每做一步保存一步，保存后预览效果

19、打开保存的xml文件，声明：每次保存后的xml文件都是不一样的，文件已经发生了改变

20、合并单元格

21、字段是否有框，默认无框，需要手动添加

22、单元格背景色和字体色，选中单元格自行设置吧。

23、字段设置，根据业务需求来

24、过滤条件

最终效果：

25、父格，表示以哪个为父格

效果：

26、最后将此xml文件保存后，并找到相应文件，复制到代码中进行逻辑处理。再次声明，这两天一直踩坑，如果预览报错，代码中解析xml文件也一样报错，无法通过，所以测试好后在将xml文件复制到项目中

前端：

function loadDatagrid() {
   $.ajax({
      type: "POST",
      url: "${ctx}/report/upbusreport",
      data: $("#searchform").serialize(),
      dataType: "json",
      beforeSend: function (XMLHttpRequest) {
         $("#tabledata").html("正在努力加载,汇总数据较多需要占用较长时间,请稍后......");
      },
      success: function (data) {
         document.getElementById("fz").innerHTML=data.style
         $("#tabledata").html(data.content);
      }
   });
}

后端接口：

/**
 * 车船报表
 * @param sceid
 * @param request
 * @param starttime
 * @param endtime
 * @return
 * @throws ParseException
 */
@RequestMapping("upbusreport")
@ResponseBody
public Object upbusreport(@CookieValue("s8c6e1_sceid") Integer sceid,HttpServletRequest request,String starttime,String endtime,String channelId)  throws ParseException{
   SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
   Map<String, Object> map = new HashMap<String, Object>();
   Date st = null;
   Date et = null;
   if (StringUtils.isNotEmpty(starttime)) {
      st = sdf.parse(starttime);
      map.put("starttime", st);
   }
   if (StringUtils.isNotEmpty(endtime)) {
      et = sdf.parse(endtime);
      map.put("endtime", et);
   }
   HtmlReport htmlReport= exportManager.exportHtml("file:upaybus.ureport.xml",request.getContextPath(),map);
   return htmlReport;
}

大致就这样吧，应该够详细了整个流程！从开始到部署到项目，复制代码只是为了让大家看的大致能懂。这个文件生成后，保存后复制到项目中，保证可以读到此文件即可

27、在测试环境中，若打开文件并预览文件，出现错误，查看是否是驱动或者URL连接问题

修改完驱动后，点击保存，并预览。声明：前提是测试数据库有对应的表，不然会报sql找不到错误。如果能出来数据，再进行报表文件的保存，保存到测试环境中

28、测试环境ok没问题了，提交到svn的代码，同样需要修改

启动ureport生成xml文件的项目，也浏览器中修改本地配置文件，并保存。此时本地也连接了测试数据库

29、刚刚是测试环境保存，同样的操作，本地点击预览是否能查到数据，出现的话，再次保存

30、同时将本地保存xml文件（每次更改，xml配置文件也会更改），复制到项目中，并提交到svn

31、提交这个文件

32、若svn仓库没配置的话，修改仓库，将仓库地址复制进去即可