JasperReports報表字段

報表字段是代表數據源和報表模板之間的數據映射元素。字段可以在報告中的表達式進行組合，以獲得所需的輸出。報表模板可以包含零個或更多的元素。當聲明報表字段，數據源應提供相應的數據到所有在報告模板中定義的字段。

字段聲明

字段聲明做如下：

name屬性

元素的name屬性是強制性的。它通過名稱引用的報表表達的字段。

class屬性

class屬性指定的字段值的類名。它的默認值是java.lang.String。這是可以改變的，以在運行時可用任何類。不論一個報表字段的類型，引擎採用鑄造於該$ F{}標記用於報表表達式，從而使手工投射不必要。

字段描述

元素是可選元素。實現自定義的數據源，例如，當這是非常有用的。我們可以存儲一個密鑰或一些信息，使用它我們可以在運行時自定義數據源中檢索字段的值。通過使用元素而不是字段名，可以檢索從數據源中的字段值時容易克服字段命名約定的限制。

下面是一段代碼從我們現有的jrxml文件（第二章報告的設計）。在這裏我們可以看到name, class 和 fieldDescription 元素的使用。

排序字段

數據的排序是必要的，數據源實現不支持它（如CSV數據源），JasperReports的支持在內存領域爲基礎的數據源排序。排序可以使用的報表模板的一個或多個元素來完成。

如果指定ATLEAST1排序字段，在報告填充過程中的數據源傳遞給JRSortableDataSource實例。這反過來從獲取數據源中的所有記錄，根據指定的字段進行排序的內存中，並替換原來的數據源。

排序字段名稱應該是相同的報表字段名稱。用於排序的字段應該具有實現java.util.Comparable類型。進行自然順序排序的所有字段除外java.lang.String類型（對於字符串類型，對應報告的填充區域自動分頁使用）。當有多個排序字段指定，排序將使用的字段進行中它們出現在報告模板的順序排序鍵。下面的例子demonstartes顯示排序功能。

Sorted Report 例子

sortField>元素添加到我們現有的報告模板（第報表設計）。讓我們排序字段country 降序排列。修訂後的報告模板（jasper_report_template.jrxml）如下。將其保存到C: oolsjasperreports-5.0.1 est directory:

在java代碼報告填充保持不變。該文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiJasperReportFill.java 的內容如下：

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(); /**
* Passing ReportTitle and Author as parameters
*/ parameters.put("ReportTitle", "List of Contacts"); parameters.put("Author", "Prepared By Manisha"); try { JasperFillManager.fillReportToFile( sourceFileName, parameters, beanColDataSource); } catch (JRException e) { e.printStackTrace(); } } }

POJO文件C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBean.java的內容如下：

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; } }

文件 C: oolsjasperreports-5.0.1 estsrccomyiibaiDataBeanList.java 的內容如下：

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; } }

報表生成

我們將編譯和執行使用我們常規Ant構建過程上面的文件。 build.xml文件（目錄下保存的內容 C: oolsjasperreports-5.0.1 est) 如下：

導入文件 - baseBuild.xml從環境設置章節中瞭解，並應放置在同一目錄中的build.xml。

接下來，打開命令行窗口並轉到build.xml文件放置的目錄。最後執行命令 ant -Dmain-class=com.yiibai.JasperReportFill （viewFullReport是默認的目標），如下所示：

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

clean-sample:
[delete] Deleting directory C: oolsjasperreports-5.0.1 estclasses
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_report_template.jasper
[delete] Deleting: C: oolsjasperreports-5.0.1 estjasper_report_template.jrprint

compile:
[mkdir] Created dir: C: oolsjasperreports-5.0.1 estclasses
[javac] C: oolsjasperreports-5.0.1 estaseBuild.xml:28: warning:
'includeantruntime' was not set, defaulting to build.sysclasspath=last;
set to false for repeatable builds
[javac] Compiling 7 source files to C: oolsjasperreports-5.0.1 estclasses

compilereportdesing:
[jrc] Compiling 1 report design files.
[jrc] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).
[jrc] log4j:WARN Please initialize the log4j system properly.
[jrc] log4j:WARN See http://logging.apache.org/log4j/1.2/faq.htmll#noconfig
for more info.
[jrc] File : C: oolsjasperreports-5.0.1 estjasper_report_template.jrxml ... OK.

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.

viewFillReport:
[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: 18 seconds

正如上文編譯的結果，一個JasperViewer窗口打開如下面的屏幕：

Jasper

在這裏，我們可以看到，country排列的字母順序降序排列。

JasperReports教程