JasperReport和springMVC整合开发小结

1.      报表开发流程

3.1 jar包引入，pom.xml文件添加依赖；

    <dependency>
      <groupId>net.sf.jasperreports</groupId>
      <artifactId>jasperreports</artifactId>
      <version>3.7.2</version>
    </dependency>

    <dependency>
      <groupId>org.codehaus.groovy</groupId>
      <artifactId>groovy-all</artifactId>
      <version>2.2.2</version>
    </dependency>

3.2               继承JasperReportsMultiFormatView类，并重写fillReport()方法，在该方法中增加setUrl()实现，这样就可以在controller中指定要使用的报表模板文件了。这样做的好处是，只需要一个jasperReport配置文件，可以在controller中动态的设定报表模板url。

public class ApplicationIReportView extends JasperReportsMultiFormatView {

    private JasperReport jasperReport;

    public ApplicationIReportView() {
        super();
    }

    protected JasperPrint fillReport(Map<String, Object> model) throws Exception {
        if (model.containsKey("url")) {
            setUrl(String.valueOf(model.get("url")));
            this.jasperReport = loadReport();
        }
        JasperPrint jasperPrint = super.fillReport(model);
        return jasperPrint;

    }

    protected JasperReport getReport() {
        return this.jasperReport;
    }
}

3.3 在/WEB-INF/jasper/目录下创建报表视图配置文件jasper-defs.xml，并指定解析器类为刚才自定义的视图解析器类ApplicationIReportView.java，

<bean id="iReportView" class="com.pes_soft.example.ApplicationIReportView">
    <property name="reportDataKey" value="jrMainDataSource"/>
</bean>

3.4 Jasper报表的渲染需要用到XmlViewResolver视图解析器，项目中如果使用了多个视图解析器，则需要设置order的值来区分解析器的使用顺序，order值越小则越靠前。增加XmlViewResolver视图解析器的同时，并指定其要解析的配置文件路径，即刚刚创建的jasper-defs.xml文件。

那么，需要在/WEB-INF/spring/appServlet/servlet-context.xml中增加下述配置：

    <!-- 注册XmlViewResolver，用于iReport & JasperReports报表生成 -->
    <bean id="jasperReportResolver" class="org.springframework.web.servlet.view.XmlViewResolver">
        <property name="order">
            <value>0</value>
        </property>
        <property name="location">
            <value>WEB-INF/jasper/jasper-defs.xml</value>
        </property>
    </bean>

 

3.5 使用iReport设计报表模板，并编成.jasper二进制文件，并拷贝至\WEB-INF\jasper目录下。具体模板设计过程参见ireport工具使用说明部分。

3.6 编写controller方法。

首先通过访问数据库查询所需要的数据，并通过JRBeanCollectionDataSource(this.dataList)

将查询出来的list或者map格式的数据进行封装成JRDataSource类型，JRDataSource类型的数据就是Jasper模板文件所需要的数据源。

// 报表数据源--这里查询不到数据，size=0
        //if(list.size() != 0){
            JRDataSource jrDataSourceMain = this.jrDataSource(list);
            model.addAttribute("jrMainDataSource", jrDataSourceMain);
            for (Map<String,Object> map:list
                    ) {
                HashMap<String,Object> barMap = new HashMap<String,Object>();
                barMap.put("projectName",map.get("projectName"));
                barMap.put("totalManHours",map.get("totalManHours"));
                barList.add(barMap);
            }
            JRDataSource jrDataSourceBar = this.jrDataSource(barList);
            model.addAttribute("barPara", jrDataSourceBar);
        //}

        // 动态指定报表模板url
        model.addAttribute("url", "/WEB-INF/jasper/monthReport.jasper");
        model.addAttribute("format", "pdf"); // 报表格式
        return "iReportView"; // 对应jasper-defs.xml中的bean id

这是我自己封装好的jrDataSource方法，便于在不同的报表controller里面调用。

    private JRDataSource jrDataSource(List<Map<String,Object>> list){
        JRDataSource jrDataSource = null;
        try {
            IReportDataSourceProvider dataSource = new IReportDataSourceProvider(HashMap.class, list);
            jrDataSource = dataSource.create(null);
        } catch (JRException e) {
            e.printStackTrace();
        }
        return jrDataSource;
    }

这是IReportDataSourceProvider类的源码，这个是借鉴前人的成果。用于将查询的结果集进行封装。

public class IReportDataSourceProvider extends JRAbstractBeanDataSourceProvider {	
	private List<?> dataList;

	public IReportDataSourceProvider(Class<?> beanClass) {
		super(beanClass);
	}
	
	public IReportDataSourceProvider(Class<?> beanClass, List<?> dataSourceList) {
		super(beanClass);
		this.dataList = dataSourceList;
	}

	public JRDataSource create(JasperReport report) throws JRException {
		return new JRBeanCollectionDataSource(this.dataList);
	}

	public void dispose(JRDataSource dataSource) throws JRException {
		this.dataList = null;
	}
}

另外，用ireport进行报表模板的设计在本文略去。有时间再另外写一篇。因为那个比较繁琐，包括多数据源交叉等，网上虽然没有完整的ireport教程，比较分散，仔细搜集还是可以完成多数据源在统一报表显示的需求的。