JasperReport填充報表

任何報告工具的主要目的是爲了生產出高品質的文檔。舉報填充過程有助於報告工具通過操縱數據集來實現這一目標。需要報表填充過程的主要輸入是:

  • 報表模板:這是實際的JasperReport文件

  • 報告參數:這些所傳遞的報表填充時間給引擎基本上都是命名的值。我們將在報表參數章節討論。

  • 數據源:我們可以從一系列像一個SQL查詢,XML文件,CSV文件,一個HQL(Hibernate查詢語言)查詢,Java Beans的集合等數據源的填補Jasper這個文件將詳細討論在報表數據源的篇章。

這個過程產生的輸出。jrprint是一個文檔隨時查看,打印或導出爲其他格式。外觀類net.sf.jasperreports.engine.JasperFillManager通常用於填充一個報表模板與數據。這個類有各種fillReportXXX()方法,填補報表模板(模板可以位於磁盤上,從輸入流採集,或直接提供的內存)。

主要有兩類在此外觀類fillReportXXX()方法:

  1. 第一種類型,接收java.sql.Connection對象作爲第三個參數。大多數情況下報表都充滿了從關係數據庫中的數據。這是通過:

    • 通過JDBC連接到數據庫。

    • 包括報表模板中的SQL查詢。

    • JasperReports引擎使用傳入的連接並執行SQL查詢。

    • 因此,一個報表數據源產生填充的報告。

  2. 第二類,收到net.sf.jasperreports.engine.JRDataSource對象,當提供其他形式的數據來填補。

填充報告模板

讓我們來寫一個報表模板。在JRXML文件(C: oolsjasperreports-5.0.1 estjasper_report_template.jrxml) 的內容如下:

<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" name="jasper_report_template" language="groovy" pageWidth="595" pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20" topMargin="20" bottomMargin="20"> <![CDATA[]]> <field name="country" class="java.lang.String"> <![CDATA[country]]> <field name="name" class="java.lang.String"> <![CDATA[name]]> <band height="23"> <reportElement mode="Opaque" x="0" y="3" width="535" height="15" backcolor="#70A9A9" /> <bottomPen lineWidth="1.0" lineColor="#CCCCCC" /> <![CDATA[]]> <reportElement x="414" y="3" width="121" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font isBold="true" /> <![CDATA[Country]]> <reportElement x="0" y="3" width="136" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font isBold="true" /> <![CDATA[Name]]> <band height="16"> <reportElement mode="Opaque" x="0" y="0" width="535" height="14" backcolor="#E5ECF9" /> <bottomPen lineWidth="0.25" lineColor="#CCCCCC" /> <![CDATA[]]> <reportElement x="414" y="0" width="121" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle"> <font size="9" /> <textFieldExpression class="java.lang.String"> <![CDATA[$F{country}]]> <reportElement x="0" y="0" width="136" height="15" /> <textElement textAlignment="Center" verticalAlignment="Middle" /> <textFieldExpression class="java.lang.String"> <![CDATA[$F{name}]]>

接下來,讓我們通過Java數據對象(Java bean)集合,到Jasper報表引擎,填補了這一編譯報告。

寫一個POJO DataBean.java表示數據對象(Java bean)。這個類定義了兩個字符串對象名稱和國家。把它保存到目錄 C: oolsjasperreports-5.0.1 estsrccomyiibai.

package com.yiibai; public class DataBean { private String name; private String country; public String getName() { return name; } public void setName(String name) { this.name = name; } public String getCountry() { return country; } public void setCountry(String country) { this.country = country; } }

編寫一個類DataBeanList.java具有業務邏輯生成java bean對象的集合。這是進一步傳遞到報表引擎,生成報表。在這裏,我們添加在列表 DataBean進行對象。把它保存到目錄C: oolsjasperreports-5.0.1 estsrccomyiibai.

package com.yiibai; import java.util.ArrayList; public class DataBeanList { public ArrayList<DataBean> getDataBeanList() { ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>(); dataBeanList.add(produce("Manisha", "India")); dataBeanList.add(produce("Dennis Ritchie", "USA")); dataBeanList.add(produce("V.Anand", "India")); dataBeanList.add(produce("Shrinath", "California")); return dataBeanList; } /**
* This method returns a DataBean object,
* with name and country set in it.
*/ private DataBean produce(String name, String country) { DataBean dataBean = new DataBean(); dataBean.setName(name); dataBean.setCountry(country); return dataBean; } }

編寫一個類DataBeanList.java具有業務邏輯生成java bean對象的集合。這是進一步傳遞到Jasper報表引擎,生成報告。在這裏,我們添加在列表4 DataBean進行對象。把它保存到目錄 C: oolsjasperreports-5.0.1 estsrccomyiibai.

package com.yiibai; import java.util.ArrayList; import java.util.HashMap; import java.util.Map; import net.sf.jasperreports.engine.JRException; import net.sf.jasperreports.engine.JasperFillManager; import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource; public class JasperReportFill { @SuppressWarnings("unchecked") public static void main(String[] args) { String sourceFileName = "c://tools/jasperreports-5.0.1/test/jasper_report_template.jasper"; DataBeanList DataBeanList = new DataBeanList(); ArrayList<DataBean> dataList = DataBeanList.getDataBeanList(); JRBeanCollectionDataSource beanColDataSource = new JRBeanCollectionDataSource(dataList); Map parameters = new HashMap(); try { JasperFillManager.fillReportToFile( sourceFileName, parameters, beanColDataSource); } catch (JRException e) { e.printStackTrace(); } } }

生成報表

現在,我們將編譯並使用我們的定期Ant構建過程執行這些文件。 build.xml文件如下圖所示:

導入文件 - baseBuild.xml環境設置,並應放置在同一目錄中的build.xml。

<project name="JasperReportTest" default="executereport" basedir="."> <import file="baseBuild.xml"/> <target name="executereport" depends="compile,compilereportdesing,run"> <echo message="Im here"/> <target name="compilereportdesing" description="Compiles the JXML file and
produces the .jasper file."> <taskdef name="jrc" classname="net.sf.jasperreports.ant.JRAntCompileTask"> <classpath refid="classpath" /> <jrc destdir="."> <fileset dir="."> <include name="*.jrxml" /> <classpath refid="classpath" />

接下來,讓我們打開命令行窗口並轉到build.xml文件放置的目錄。最後,執行命令ant -Dmain-class=com.yiibai.JasperReportFill (executereport是默認的目標),如下所示:

C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai.JasperReportFill
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml

compile:
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:27:
warning: 'includeantruntime' was not set, defaulting to
build.sysclasspath=last; set to false for repeatable builds
[javac] Compiling 1 source file to
C: oolsjasperreports-5.0.1 estclasses

run:
[echo] Runnin class : com.yiibai.JasperReportFill
[java] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.extensions.ExtensionsEnvironment).
[java] log4j:WARN Please initialize the log4j system properly.

BUILD SUCCESSFUL
Total time: 8 seconds 

如上述執行結果的文件jasper_report_template.jrprint是在同一目錄中爲 .jasper文件(在這種情況下,它是產生在 C: oolsjasperreports-5.0.1 est).