jasperreports中文学习教程之报表字段

报表字段是代表数据源和报表模板之间的数据映射元素。字段可以在报告中的表达式进行组合，以获得所需的输出。报表模板可以包含零个或更多的元素。当声明报表字段，数据源应提供相应的数据到所有在报告模板中定义的字段。字段声明

字段声明做如下：www.yiibai.comyiibai.comname属性

元素的name属性是强制性的。它通过名称引用的报表表达的字段。www.yiibai.comclass属性

class属性指定的字段值的类名。它的默认值是java.lang.String。这是可以改变的，以在运行时可用任何类。不论一个报表字段的类型，引擎采用铸造于该$F{}标记用于报表表达式，从而使手工投射不必要。字段描述

元素是可选元素。实现自定义的数据源，例如，当这是非常有用的。我们可以存储一个密钥或一些信息，使用它我们可以在运行时自定义数据源中检索字段的值。通过使用元素而不是字段名，可以检索从数据源中的字段值时容易克服字段命名约定的限制。

下面是一段代码从我们现有的jrxml文件（第二章报告的设计）。在这里我们可以看到name,class和fieldDescription元素的使用。

排序字段数据的排序是必要的，数据源实现不支持它（如CSV数据源），JasperReports的支持在内存领域为基础的数据源排序。排序可以使用的报表模板的一个或多个元素来完成。如果指定ATLEAST1排序字段，在报告填充过程中的数据源传递给JRSortableDataSource实例。这反过来从获取数据源中的所有记录，根据指定的字段进行排序的内存中，并替换原来的数据源。排序字段名称应该是相同的报表字段名称。用于排序的字段应该具有实现java.util.Comparable类型。进行自然顺序排序的所有字段除外java.lang.String类型（对于字符串类型，对应报告的填充区域自动分页使用）。当有多个排序字段指定，排序将使用的字段进行中它们出现在报告模板的顺序排序键。下面的例子demonstartes显示排序功能。SortedReport例子sortField>元素添加到我们现有的报告模板（第报表设计）。让我们排序字段country降序排列。修订后的报告模板（jasper_report_template.jrxml）如下。将其保存到C:\ools\\jasperreports-5.0.1\estdirectory:www.yiibai.com在java代码报告填充保持不变。该文件C:\ools\\jasperreports-5.0.1\est\\src\\com\\yiibai\\JasperReportFill.java的内容如下：packagecom.yiibai;importjava.util.ArrayList;importjava.util.HashMap;importjava.util.Map;importnet.sf.jasperreports.engine.JRException;importnet.sf.jasperreports.engine.JasperFillManager;importnet.sf.jasperreports.engine.data.JRBeanCollectionDataSource;publicclassJasperReportFill{@SuppressWarnings(\"unchecked\")publicstaticvoidmain(String[]args){StringsourceFileName=\"C://tools/jasperreports-5.0.1/test/jasper_report_template.jasper\";DataBeanListDataBeanList=newDataBeanList();ArrayListdataList=DataBeanList.getDataBeanList();JRBeanCollectionDataSourcebeanColDataSource=newJRBeanCollectionDataSource(dataList);Mapparameters=newHashMap();/***PassingReportTitleandAuthorasparameters*/parameters.put(\"ReportTitle\",\"ListofContacts\");parameters.put(\"Author\",\"PreparedByManisha\");try{JasperFillManager.fillReportToFile(sourceFileName,parameters,beanColDataSource);}catch(JRExceptione){e.printStackTrace();}}}POJO文件C:\ools\\jasperreports-5.0.1\est\\src\\com\\yiibai\\DataBean.java的内容如下：packagecom.yiibai;publicclassDataBean{privateStringname;privateStringcountry;publicStringgetName(){returnname;}publicvoidsetName(Stringname){this.name=name;}publicStringgetCountry(){returncountry;}publicvoidsetCountry(Stringcountry){this.country=country;}}文件C:\ools\\jasperreports-5.0.1\est\\src\\com\\yiibai\\DataBeanList.java的内容如下：yiibai.compackagecom.yiibai;importjava.util.ArrayList;publicclassDataBeanList{publicArrayListgetDataBeanList(){ArrayListdataBeanList=newArrayList();dataBeanList.add(produce(\"Manisha\",\"India\"));dataBeanList.add(produce(\"DennisRitchie\",\"USA\"));dataBeanList.add(produce(\"V.Anand\",\"India\"));dataBeanList.add(produce(\"Shrinath\",\"California\"));returndataBeanList;}/***ThismethodreturnsaDataBeanobject,*withnameandcountrysetinit.*/privateDataBeanproduce(Stringname,Stringcountry){DataBeandataBean=newDataBean();dataBean.setName(name);dataBean.setCountry(country);returndataBean;}}报表生成我们将编译和执行使用我们常规Ant构建过程上面的文件。build.xml文件（目录下保存的内容C:\ools\\jasperreports-5.0.1\est)如下：www.yiibai.com导入文件-baseBuild.xml从环境设置章节中了解，并应放置在同一目录中的build.xml。接下来，打开命令行窗口并转到build.xml文件放置的目录。最后执行命令ant-Dmain-class=com.yiibai.JasperReportFill（viewFullReport是默认的目标），如下所示：C:\ools\\jasperreports-5.0.1\est>ant-Dmain-class=com.yiibai.JasperReportFillBuildfile:C:\ools\\jasperreports-5.0.1\est\\build.xmlclean-sample:[delete]DeletingdirectoryC:\ools\\jasperreports-5.0.1\est\\classes[delete]Deleting:C:\ools\\jasperreports-5.0.1\est\\jasper_report_template.jasper[delete]Deleting:C:\ools\\jasperreports-5.0.1\est\\jasper_report_template.jrprintcompile:[mkdir]Createddir:C:\ools\\jasperreports-5.0.1\est\\classes[javac]C:\ools\\jasperreports-5.0.1\est\\baseBuild.xml:28:warning:'includeantruntime'wasnotset,defaultingtobuild.sysclasspath=last;settofalseforrepeatablebuilds[javac]Compiling7sourcefilestoC:\ools\\jasperreports-5.0.1\est\\classescompilereportdesing:[jrc]Compiling1reportdesignfiles.[jrc]log4j:WARNNoappenderscouldbefoundforlogger(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).[jrc]log4j:WARNPleaseinitializethelog4jsystemproperly.[jrc]log4j:WARNSeehttp://logging.apache.org/log4j/1.2/faq.htmll#noconfigformoreinfo.[jrc]File:C:\ools\\jasperreports-5.0.1\est\\jasper_report_template.jrxml...OK.run:[echo]Runninclass:com.yiibai.JasperReportFill[java]log4j:WARNNoappenderscouldbefoundforlogger(net.sf.jasperreports.extensions.ExtensionsEnvironment).[java]log4j:WARNPleaseinitializethelog4jsystemproperly.viewFillReport:[java]log4j:WARNNoappenderscouldbefoundforlogger(net.sf.jasperreports.extensions.ExtensionsEnvironment).[java]log4j:WARNPleaseinitializethelog4jsystemproperly.BUILDSUCCESSFULTotaltime:18secondsyiibai.com正如上文编译的结果，一个JasperViewer窗口打开如下面的屏幕：在这里，我们可以看到，country排列的字母顺序降序排列。

同为比较常用的报表工具，FineReport在报表实现过程中所需的代码量远少于jasperreport，大部分的报表代码细节被隐藏，呈现出的是是可视化的设计过程，在FineReport中，定义好数据源之后，设计器会自动读取数据库中的字段，不需要二次定义，以excel导入行式报表为例进行说明，如下：

1.示例1-位置匹配(7.0.4)

如下图，可以看到Excel中的列标题与FineReport模板的列标题完全不一致，但是位置却保持一致：

注：行式报表根据位置匹配的前提是标题完全匹配不上，如果有一个标配能匹配得上，那么就会使用根据标题匹配。

另：若要导入的是Excel2007需要将poi2007_fat.jar拷贝至%FR_HOME%\\WebReport\\WEB-INF\\lib下。1.1模板制作

上图中我们可以看到，Excel中第一行数据在B3~K3中，在填报模板中，导入数据的单元格也要在B3~K3，单元格从上到下扩展：

注：706版本及之后版本可以不设置控件直接导入数据，但是空白单元格却不能导入数据，故我们设置完第一个单元格的扩展属性之后，可以选中所有需要导入数据的单元格，设置一下居中或者边框线等等样式，使所有单元格处于编辑过的状态，不再空白。

注：若导入的报表中不是空白的填报表，而是有取数的功能，则需要将报表的最左父格设置为列表显示。1.2报表填报属性设置

在报表填报属性中，只需要将第一行单元格与数据表的数据列进行绑定即可。该例中，Excel中的原始数据供应商和类别都是具体的名字，若用户希望Excel导入的是名字，但实际入库的是ID怎么办呢？

此时可以在报表填报属性中使用map函数转换，以下具体介绍。

定义map函数需要的数据集

增加数据集ds1，SQL语句为：SELECT*FROM[供应商]，查询出供应商ID与供应商名字的对应关系；

再增加数据集ds2，SQL语句为：SELECT*FROM[产品类别]，查询出产品类别ID与类别名字的对应关系。

报表填报属性中使用map函数

Excel导入的是名字，使用map函数转换，如下图：

1.3填报工具栏设置

默认填报工具栏是没有导入Excel按钮的，点击模板>模板web属性>填报页面设置，为该模板单独设置，勾选使用工具栏，为该报表单独设置工具栏，清空工具栏，然后在按钮面板中双击提交按钮和导入excel按钮，将这两个按钮添加到顶部工具栏中，如下图：

已完成模板可参

考%FR_HOME%\\WebReport\\WEB-INF\\reportlets\\doc\\SpecialSubject|\\ExcelImport\\ExcelImport_1.cpt。在线查看模板效果请点击ExcelImport_1.cpt注：在线查看模板需要用到示例中的excel，点击excelimport.xls下载。

2.示例2-标题匹配(7.0.5)

7.0.5版本行式填报报表在线导入excel是根据列标题自动匹配，标题不相同，则显示空白，即必须保持标题一致，无关于位置，列的位置可以互换。2.1模板修改

打开模

板%FR_HOME%\\WebReport\\WEB-INF\\reportlets\\doc\\SpecialSubject|\\ExcelImport\\ExcelImport_1.cpt，修改如下图，删除左方和下方的空白行，将产品名称和类别列名称修改为产品和类别ID，与excel不一样，同时更换类别和供应商列的位置：

2.2报表填报属性修改

修改报表填报属性中列和数据库中列的对应，这里只需要修改类别ID对应的值，修改为map(C2,\"ds2\2,1)。2.3效果查看

点击填报预览，在web端单击工具栏上的导入Excel按钮，选择excelimport.xls，可看到如下图效果：

已完成模板请参

照%FR_HOME%\\WebReport\\WEB-INF\\reportlets\\doc\\SpecialSubject|\\ExcelImport\\ExcelImport_2.cpt。在线查看示例效果请点击ExcelImport_2.cpt3.示例3-结果匹配(7.1)

对于模板标题和单元格是通过数据列扩展得到的模板，就无法使用上述两种方式进行Excel导入，那么此时就可以通过根据结果匹配来实现Excel的导入。结果匹配导入Excel是指，在web端预览之后，FineReport根据web端数据扩展之后预览的结果来匹配Excel中的数据，仍然是先根据web端预览结果的标题匹配，如果标题全都匹配不上则根据位置匹配。

注：上面两个示例中的根据标题匹配和位置匹配是指根据cpt模板中的标题和单元格位置，而这里根据结果匹配中所有的标题和位置是指cpt模板在web端预览之后的标题和位置。3.1模板制作

新建一个模板，添加内置数据集，该数据集中只有一列数据，存储的是产品表中的字段名称，如下图：

内置数据集准备好之后，将字段名称数据列拖曳到A2单元格中，设置为横向扩展，并将A3单元格设置为纵向扩展，如下图：

3.2工具栏设置

默认填报工具栏是没有导入Excel按钮的，点击模板>模板web属性>填报页面设置，为该模板单独设置，勾选使用工具栏，为该报表单独设置工具栏，清空工具栏，然后在按钮面板中双击提交按钮和导入excel按钮，将这两个按钮添加到顶部工具栏中，与根据位置匹配示例中的设置相同。3.3Excel导入

点击填报预览按钮，在web端预览报表，可以看到标题字段是扩展出来的，点击工具栏上的导入Excel按钮，选择excelimport.xls，可以看到如下图所示效果：