jasperreports中文学习入门教程:[2]报表字段

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

2、 字段声明字段声明做如下：< fieldname="FieldName"class="java.lang.String"/> name属性<field>元素的name属性是强制性的。它通过名称引用的报表表达的字段。 class属性 class属性指定的字段值的类名。它的默认值是java.lang.String。这是可以改变的，以在运行时可用任何类。不论一个报表字段的类型，引擎采用铸造于该$F{}标记用于报表表达式，从而使手工投射不必要。

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

4、 下面是一段代码从我们现有的jrxml文件（第二章报告的设计）。在这里我们可以看到name,class和fieldDescription元素的使用。 <fieldname="country"class="java.lang.String"> <fieldDescription><![CDATA[country]]></fieldDescription>

5、 </field> <fieldname="name"class="java.lang.String"><fieldDescription><![CDATA[name]]></fieldDescription> </field>

6、 排序字段 数据的排序是必要的，数据源实现不支持它（如CSV数据源），JasperReports的支持在内存领域为基础的数据源排序。排序可以使用的报表模板的一个或多个<sortField>元素来完成。如果指定ATLEAST1排序字段，在报告填充过程中的数据源传递给JRSortableDataSource实例。这反过来从获取数据源中的所有记录，根据指定的字段进行排序的内存中，并替换原来的数据源。

7、 排序字段名称应该是相同的报表字段名称。用于排序的字段应该具有实现java.util.Comparable类型。进行自然顺序排序的所有字段除外java.lang.String类型（对于字符串类型，对应报告的填充区域自动分页使用）。当有多个排序字段指定，排序将使用的字段进行中它们出现在报告模板的顺序排序键。下面的例子demonstartes显示排序功能。

8、 SortedReport例子sortField>元素添加到我们现有的报告模板（第报表设计）。让我们排序字段country降序排列。修订后的报告模板（jasper_report_template.jrxml）如下。将其保存到C:\tools\jasperreports-5.0.1\testdirectory:

9、<queryString><![CDATA[]]></queryString><fieldname="country"class="java.lang.String"><fieldDescription><![CDATA[country]]></fieldDescription></field>

10、 <fieldname="name"class="java.lang.String"><fieldDescription><![CDATA[name]]></fieldDescription></field><sortFieldname="country"order="Descending"/><sortFieldname="name"/><title>

11、 <bandheight="70"><line><reportElementx=&qu泠贾高框ot;0"y="0"width="515"height="1"/></line><textFieldisBlankWhenNull="true"bookmarkLevel="1"><reportElementx="0"y="10"width="515"height="30"/><textElementtextAlignment="Center"><fontsize="22"/></textElement><textFieldExpressionclass="java.lang.String"><![CDATA[$P{ReportTitle}]]></textFieldExpression>

12、 <anchorNameExpression>&盟敢势袂lt;![CDATA["Title"柯计瓤绘]]></anchorNameExpression></textField><textFieldisBlankWhenNull="true"><reportElementx="0"y="40"width="515"height="20"/><textElementtextAlignment="Center"><fontsize="10"/></textElement><textFieldExpressionclass="java.lang.String"><![CDATA[$P{Author}]]></textFieldExpression></textField>

13、 </band> </title> <columnHeader><bandheight="23"><staticText><reportElementmode="Opaque"x="0"y="3"width="535" height="15"backcolor="#70A9A9"/><box><bottomPenlineWidth="1.0"

14、 lineColor="#CCCCCC"/></box><textElement/><text><![CDATA[]]></text></staticText><staticText><reportElementx="414"y="3"width="121"

15、 height="15"/><textElementtextAlignment="Center"verticalAlignment="Middle"><fontsize="9"/></textElement><textFieldExpressionclass="java.lang.String"><![CDATA[$F{country}]]></textFieldExpression></textField><textField>

16、 <reportElementx="0"y="0"width="136"height="15"/><textElementtextAlignment="Center"verticalAlignment="Middle"/><textFieldExpressionclass="java.lang.String"><![CDATA[$F{name}]]></textFieldExpression></textField></band></detail></jasperReport>

17、 在java代码报告填充保持不变。该文件C:\tools\ja衡痕贤伎sperreports- 5.0.1\test\src\co罪焐芡拂m\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();ArrayList<DataBean>dataList=DataBeanList.getDataBeanList();JRBeanCollectionDataSourcebeanColDataSource=newJRBeanCollectionDataSource(dataList);

18、Mapparameters=newHashMap();/***PassingReportTitleandAuthorasparameters*/parameters.put("ReportTitle","ListofContacts");parameters.put("Author","PreparedByManisha");try{JasperFillManager.fillReportToFile(sourceFileName,parameters,beanColDataSource);}catch(JRExceptione){e.printStackTrace();}}}

19、POJO文件C:\tools\jasperreports-5.0.1\test\src\com\yiibai\DataBean.java的内容如下：packagecom.yiibai;publicclassDataBean{privateStringname;privateStringcountry;publicStringgetName(){returnname;}

20、 publicvoidsetName(Stringname){th坡纠课柩is.name=name;}publicStrin爿讥旌护ggetCountry(){returncountry;}publicvoidsetCountry(Stringcountry){this.country=country;}}文件C:\tools\jasperreports-5.0.1\test\src\com\yiibai\DataBeanList.java的内容如下：packagecom.yiibai;importjava.util.ArrayList;publicclassDataBeanList{publicArrayList<DataBean>getDataBeanList(){ArrayList<DataBean>dataBeanList=newArrayList<DataBean>();

21、 dataBeanList.add(produce("挢旗扦渌;Manisha","India&鳎溻趄酃quot;));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;

22、 }}报表生成我们将编译和执行使用我们常规Ant构建过程上面的文件。build.xml文件（目录下保存的内容C:\tools\jasperreports-5.0.1\test)如下：导入文件-baseBuild.xml从环境设置章节中了解，并应放置在同一目录中的build.xml。<?xmlversion="1.0"encoding="UTF-8"?><projectname="JasperReportTest"default="viewFillReport"basedir="."><importfile="baseBuild.xml"/><targetname="viewFillReport"depends="compile,compilereportdesing,run"description="Launchesthereportviewertopreviewthereportstoredinthe.JRprintfile."><javaclassname="net.sf.jasperreports.view.JasperViewer"fork="true"><argvalue="-F${file.name}.JRprint"/><classpathrefid="classpath"/></java></target><targetname="compilereportdesing"description="CompilestheJXMLfileandproducesthe.jasperfile."><taskdefname="jrc"

23、 classname="net.sf.jasperreports.ant.JRAntCompileTask"><classpathrefid="classpath"/></taskdef><jrcdestdir="."><src><filesetdir="."><includename="*.jrxml"/></fileset></src><classpathrefid="classpath"/></jrc></target></project>正如上文编译的结果，一个JasperViewer窗口打开如下面的屏幕：