SpringBoot整合Ureport2 SpringBoot整合Ureport2报表及常见使用方法

时间:2021-01-27 夕四丶人气:1

1、Maven 添加依赖

<!--ureport-->
   <dependency>
     <groupId>com.syyai.spring.boot</groupId>
     <artifactId>ureport-spring-boot-starter</artifactId>
     <version>2.2.9</version>
   </dependency>

2、编写ureport2 的配置类

配置类实现 BuildinDatasource
1）注册Bean
2）重命名ureport2的数据源名称

import com.bstek.ureport.console.UReportServlet;
import com.bstek.ureport.definition.datasource.BuildinDatasource;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.ImportResource;

import javax.annotation.Resource;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.SQLException;
@ImportResource("classpath:ureport-console-context.xml")//不加项目能够启动但是会导致加载数据源报错或加载不了
@Configuration
@EnableAutoConfiguration
public class UreportConfig implements BuildinDatasource {
  @Resource
  DataSource dataSource;
  private Logger log = LoggerFactory.getLogger(getClass());

  @Bean //定义ureport的启动servlet
  public ServletRegistrationBean buildUreportServlet(){
    return new ServletRegistrationBean(new UReportServlet(),"/ureport/*");// /ureport/* 不可更改
  }

  @Override
  public String name() {
    return "ureport2 数据源";
  }

  @Override
  public Connection getConnection() {
    try {
      return dataSource.getConnection();
    } catch (SQLException e) {
      log.error("Ureport 数据源 获取连接失败！");
      e.printStackTrace();
    }
    return null;
  }

}

3、ureport2 访问路径

http://127.0.0.1:8080/项目名称/ureport/designer

在这里插入图片描述

4、选择数据源方式:内置数据源

ureport2 的配置类实现 BuildinDatasource ，即配好了内置的数据源，直接使用即可

在这里插入图片描述

5、选择数据源方式：SpringBean数据源配置

数据源名称：自定义命名
Bean ID: Bean 对象–yjReportService ，与java类名称一致首字母需要转成小写

在这里插入图片描述

6、添加Sping Bean 数据源的数据集

数据集名称：自定义
方法名：你配置的Bean对象中的方法名称，即service中的方法，该方法必须包含3个参数，否则无法找到
返回对象：报表中的返回数据接收对象，全路径名，可不写，自己手动添加返回字段（未尝试）

在这里插入图片描述

报表编辑完成后参数传递方式：http://127.0.0.1:8088/项目名称/ureport/preview?_u=file:报表名称¶meters=参数值

业务逻辑代码：参数值进行接收即可

在这里插入图片描述

7、内置数据源方式配置数据集

配置数据集有2种方式：
1、使用SQL语句查询数据
2、使用${表达式}：也是SQL的形式，用字符串拼接起来

7.1、使用SQL的方式

正常编写SQL即可，需要传递参数用‘ ：' 加字段名表示
可添加默认的参数，设置的参数名字和SQL中的参数名字保持一致
如果没传参，则使用默认的参数进行查询
若有多个参数，同样的方式进行添加
例：select * from 表 where id = :id

在这里插入图片描述

报表制作完成后，报表参数传递方式：http://127.0.0.1:8080/项目名称/ureport/preview?_u=file:报表名称&iid=参数值

7.2、使用${表达式}方式

使用表达式的方式通常都是动态SQL的方式查询数据
外部参数传进报表后再进行查询
ureport2获取参数的方式：param(“参数字段”)
例子：${ SQL 语句 }

先看看最终效果：报表使用iframe 页面展示，外部参数传入报表查询数据

在这里插入图片描述

7.2.1、制作报表：

使用${ sql 语句} 注意事项：
若SQL中包含单引号包裹的字符串，那么需要加上“\”来为单引号转义，否则会出现语法错误
判断外部是否传递参数，2种方式：
1、使用三目表达式：判断是否为空，不为空则拼接SQL语句条件
例：(param(“参数名称”)!=null && param(“参数名称”)!="" ? “and 字段 = '”+param(“参数名称”)+"'" : “”)
2、使用函数（较为简洁），可使用添加参数方式，或者直接获取参数方式
1）添加参数方式（借鉴上面的sql 传参的方式，：+字段）： (emptyparam(“name”)==false ? “and name=:name” : “”)
2）直接获取参数方式：
(emptyparam(“name”)==false ? “and name=”\' “+param(“参数名称”)+”\'" " : " ")

注意字符串拼接后，sql语句前后的空格问题，单引号加 \ 的问题
${
 	"select from 表1 a "+
  "left join 表2 b on b.id=a.id "+
  "where 1=1 "
  + (param("参数名称")!=null && param("参数名称")!="" ? 
    		"and 字段 = \'"+param("参数名称")+"\'" : " ")
  +")t "  
}

在这里插入图片描述