JasperReport教程之报表字段

JasperReport教程之报表字段

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

字段声明做如下：

name属性

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

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

字段描述

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

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

排序字段

数据的排序是必要的，数据源实现不支持它（如CSV数据源），JasperReports 的支持在内存领域为基础的数据源排序。排序可以使用的报表模板的一个或多个元素来完成。

如果指定ATLEAST1排序字段，在报告填充过程中的数据源传递给JRSortableDataSource实例。这反过来从获取数据源中的所有记录，根据指定的字段进行排序的内存中，并替换原来的数据源。

排序字段名称应该是相同的报表字段名称。用于排序的字段应该具有实现parable类型。进行自然顺序排序的所有字段除外

ng.String类型（对于字符串类型，对应报告的填充区域自动分页使用）。当有多个排序字段指定，排序将使用的字段进行中它们出现在报告模板的顺序排序键。下面的例子demonstartes显示排序功能。

Sorted Report例子

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

width="535"height="15"

backcolor="#70A9A9"/>

lineColor="#CCCCCC"/>